+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package com.mybatisflex.loveqq.framework.boot.autoconfig;
+
+import com.kfyty.loveqq.framework.boot.data.orm.mybatis.autoconfig.SqlSessionFactoryBean;
+import com.kfyty.loveqq.framework.core.autoconfig.annotation.Autowired;
+import com.kfyty.loveqq.framework.core.event.ContextRefreshedEvent;
+import com.kfyty.loveqq.framework.core.support.Pair;
+import com.mybatisflex.core.FlexConsts;
+import com.mybatisflex.core.datasource.FlexDataSource;
+import com.mybatisflex.core.mybatis.FlexConfiguration;
+import com.mybatisflex.core.mybatis.FlexSqlSessionFactoryBuilder;
+import com.mybatisflex.loveqq.framework.boot.autoconfig.transaction.FlexTransactionFactory;
+import org.apache.ibatis.builder.xml.XMLConfigBuilder;
+import org.apache.ibatis.mapping.Environment;
+import org.apache.ibatis.session.Configuration;
+import org.apache.ibatis.session.SqlSessionFactory;
+
+/**
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package com.mybatisflex.loveqq.framework.boot.autoconfig;
+
+import com.kfyty.loveqq.framework.core.autoconfig.InitializingBean;
+import com.kfyty.loveqq.framework.core.autoconfig.annotation.Autowired;
+import com.kfyty.loveqq.framework.core.autoconfig.annotation.Component;
+import com.kfyty.loveqq.framework.core.autoconfig.condition.annotation.ConditionalOnProperty;
+import com.mybatisflex.core.audit.AuditManager;
+import com.mybatisflex.core.audit.MessageFactory;
+import com.mybatisflex.core.audit.MessageReporter;
+import com.mybatisflex.core.audit.http.HttpMessageReporter;
+
+/**
+ * MyBatis-Flex-Admin 自动配置。
+ *
+ * @author 王帅
+ * @author kfyty725
+ * @since 2023-07-01
+ */
+@Component
+@ConditionalOnProperty(prefix = "mybatis-flex.adminConfig", value = "enable", havingValue = "true")
+public class MybatisFlexAdminAutoConfiguration implements InitializingBean {
+ @Autowired(required = false)
+ private MessageFactory messageFactory;
+
+ @Autowired(required = false)
+ private MybatisFlexProperties properties;
+
+ @Autowired(required = false)
+ private HttpMessageReporter.JSONFormatter jsonFormatter;
+
+ @Override
+ public void afterPropertiesSet() {
+ AuditManager.setAuditEnable(true);
+ if (messageFactory != null) {
+ AuditManager.setMessageFactory(messageFactory);
+ }
+ MybatisFlexProperties.AdminConfig adminConfig = properties.getAdminConfig();
+ MessageReporter messageReporter = new HttpMessageReporter(
+ adminConfig.getEndpoint(),
+ adminConfig.getSecretKey(),
+ jsonFormatter
+ );
+ AuditManager.setMessageReporter(messageReporter);
+ }
+}
diff --git a/mybatis-flex-loveqq-starter/src/main/java/com/mybatisflex/loveqq/framework/boot/autoconfig/MybatisFlexAutoConfiguration.java b/mybatis-flex-loveqq-starter/src/main/java/com/mybatisflex/loveqq/framework/boot/autoconfig/MybatisFlexAutoConfiguration.java
new file mode 100644
index 00000000..f678d7e6
--- /dev/null
+++ b/mybatis-flex-loveqq-starter/src/main/java/com/mybatisflex/loveqq/framework/boot/autoconfig/MybatisFlexAutoConfiguration.java
@@ -0,0 +1,263 @@
+/*
+ * Copyright (c) 2022-2024, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package com.mybatisflex.loveqq.framework.boot.autoconfig;
+
+import com.kfyty.loveqq.framework.boot.data.orm.mybatis.autoconfig.MybatisProperties;
+import com.kfyty.loveqq.framework.core.autoconfig.annotation.Component;
+import com.kfyty.loveqq.framework.core.autoconfig.annotation.ConfigurationProperties;
+import com.kfyty.loveqq.framework.core.autoconfig.annotation.NestedConfigurationProperty;
+import com.kfyty.loveqq.framework.core.lang.util.Mapping;
+import com.mybatisflex.core.FlexConsts;
+import com.mybatisflex.core.FlexGlobalConfig;
+import lombok.Data;
+import org.apache.ibatis.io.VFS;
+import org.apache.ibatis.logging.Log;
+import org.apache.ibatis.mapping.ResultSetType;
+import org.apache.ibatis.scripting.LanguageDriver;
+import org.apache.ibatis.session.AutoMappingBehavior;
+import org.apache.ibatis.session.AutoMappingUnknownColumnBehavior;
+import org.apache.ibatis.session.Configuration;
+import org.apache.ibatis.session.ExecutorType;
+import org.apache.ibatis.session.LocalCacheScope;
+import org.apache.ibatis.type.JdbcType;
+import org.apache.ibatis.type.TypeHandler;
+
+import java.util.Map;
+import java.util.Properties;
+import java.util.Set;
+
+/**
+ * Mybatis-Flex 的配置属性。
+ * 参考自 mybatis-flex-spring-boot-starter
+ *
+ * @author kfyty725
+ */
+@Data
+@Component
+@ConfigurationProperties("mybatis-flex")
+public class MybatisFlexProperties {
+ /**
+ * 默认数据源 key
+ */
+ private String defaultDatasourceKey;
+
+ /**
+ *
多数据源的配置。
+ *
+ *
+ * mybatis-flex.datasource.ds1.url=***
+ * mybatis-flex.datasource.ds2.url=***
+ */
+ private Map> datasource;
+
+ /**
+ * 全局配置。
+ */
+ private GlobalConfig globalConfig;
+
+ /**
+ * MyBatis-Flex-Admin 配置。
+ */
+ private AdminConfig adminConfig;
+
+ /**
+ * Location of MyBatis xml config file.
+ */
+ private String configLocation;
+
+ /**
+ * Locations of MyBatis mapper files.
+ */
+ private String[] mapperLocations = new String[]{"mapper/**/*.xml"};
+
+ /**
+ * Packages to search type aliases. (Package delimiters are ",; \t\n")
+ */
+ private String typeAliasesPackage;
+
+ /**
+ * The super class for filtering type alias. If this not specifies, the MyBatis deal as type alias all classes that
+ * searched from typeAliasesPackage.
+ */
+ private Class typeAliasesSuperType;
+
+ /**
+ * Packages to search for type handlers. (Package delimiters are ",; \t\n")
+ */
+ private String typeHandlersPackage;
+
+ /**
+ * Indicates whether perform presence check of the MyBatis xml config file.
+ */
+ private boolean checkConfigLocation = false;
+
+ /**
+ * Execution mode for {@link com.kfyty.loveqq.framework.boot.data.orm.mybatis.autoconfig.support.ConcurrentSqlSession}.
+ */
+ private ExecutorType executorType;
+
+ /**
+ * The default scripting language driver class. (Available when use together with mybatis-spring 2.0.2+)
+ */
+ private Class defaultScriptingLanguageDriver;
+
+ /**
+ * Externalized properties for MyBatis configuration.
+ */
+ private Properties configurationProperties;
+
+ /**
+ * A Configuration object for customize default settings. If {@link #configLocation} is specified, this property is
+ * not used.
+ */
+ private CoreConfiguration configuration;
+
+ /**
+ * 合并到 {@link MybatisProperties} 配置
+ *
+ * @param properties 配置
+ */
+ void applyTo(MybatisProperties properties) {
+ Mapping.from(getConfigLocation()).whenNotNull(properties::setConfigLocation);
+ Mapping.from(getExecutorType()).whenNotNull(properties::setExecutorType);
+ Mapping.from(getTypeAliasesPackage()).whenNotNull(properties::setTypeAliasesPackage);
+ Mapping.from(getTypeHandlersPackage()).whenNotNull(properties::setTypeHandlersPackage);
+ Mapping.from(getMapperLocations()).whenNotNull(properties::setMapperLocations);
+ Mapping.from(getDefaultScriptingLanguageDriver()).whenNotNull(properties::setDefaultScriptingLanguageDriver);
+ Mapping.from(getConfigurationProperties()).whenNotNull(properties::setConfigurationProperties);
+ Mapping.from(getConfiguration()).notNullMap(CoreConfiguration::getVfsImpl).whenNotNull(properties::setVfs);
+ }
+
+ /**
+ * The configuration properties for mybatis core module.
+ *
+ * @since 3.0.0
+ */
+ @Data
+ @NestedConfigurationProperty
+ public static class CoreConfiguration {
+ /**
+ * Allows using RowBounds on nested statements. If allow, set the false. Default is false.
+ */
+ private Boolean safeRowBoundsEnabled;
+
+ /**
+ * Allows using ResultHandler on nested statements. If allow, set the false. Default is true.
+ */
+ private Boolean safeResultHandlerEnabled;
+
+ /**
+ * Enables automatic mapping from classic database column names A_COLUMN to camel case classic Java property names
+ * aColumn. Default is true.
+ */
+ private Boolean mapUnderscoreToCamelCase = true;
+
+ /**
+ * When enabled, any method call will load all the lazy properties of the object. Otherwise, each property is loaded
+ * on demand (see also lazyLoadTriggerMethods). Default is false.
+ */
+ private Boolean aggressiveLazyLoading;
+
+ /**
+ * Allows or disallows multiple ResultSets to be returned from a single statement (compatible driver required).
+ * Default is true.
+ */
+ private Boolean multipleResultSetsEnabled;
+
+ /**
+ * Allows JDBC support for generated keys. A compatible driver is required. This setting forces generated keys to be
+ * used if set to true, as some drivers deny compatibility but still work (e.g. Derby). Default is false.
+ */
+ private Boolean useGeneratedKeys;
+
+ /**
+ * Uses the column label instead of the column name. Different drivers behave differently in this respect. Refer to
+ * the driver documentation, or test out both modes to determine how your driver behaves. Default is true.
+ */
+ private Boolean useColumnLabel;
+
+ /**
+ * Globally enables or disables any caches configured in any mapper under this configuration. Default is true.
+ */
+ private Boolean cacheEnabled;
+
+ /**
+ * Specifies if setters or map's put method will be called when a retrieved value is null. It is useful when you
+ * rely on Map.keySet() or null value initialization. Note primitives such as (int,boolean,etc.) will not be set to
+ * null. Default is false.
+ */
+ private Boolean callSettersOnNulls;
+
+ /**
+ * Allow referencing statement parameters by their actual names declared in the method signature. To use this
+ * feature, your project must be compiled in Java 8 with -parameters option. Default is true.
+ */
+ private Boolean useActualParamName;
+
+ /**
+ * MyBatis, by default, returns null when all the columns of a returned row are NULL. When this setting is enabled,
+ * MyBatis returns an empty instance instead. Note that it is also applied to nested results (i.e. collectioin and
+ * association). Default is false.
+ */
+ private Boolean returnInstanceForEmptyRow;
+
+ /**
+ * Removes extra whitespace characters from the SQL. Note that this also affects literal strings in SQL. Default is
+ * false.
+ */
+ private Boolean shrinkWhitespacesInSql;
+
+ /**
+ * Specifies the default value of 'nullable' attribute on 'foreach' tag. Default is false.
+ */
+ private Boolean nullableOnForEach;
+
+ /**
+ * When applying constructor auto-mapping, argument name is used to search the column to map instead of relying on
+ * the column order. Default is false.
+ */
+ private Boolean argNameBasedConstructorAutoMapping;
+
+ /**
+ * Globally enables or disables lazy loading. When enabled, all relations will be lazily loaded. This value can be
+ * superseded for a specific relation by using the fetchType attribute on it. Default is False.
+ */
+ private Boolean lazyLoadingEnabled;
+
+ /**
+ * Sets the number of seconds the driver will wait for a response from the database.
+ */
+ private Integer defaultStatementTimeout;
+
+ /**
+ * Sets the driver a hint as to control fetching size for return results. This parameter value can be override by a
+ * query setting.
+ */
+ private Integer defaultFetchSize;
+
+ /**
+ * MyBatis uses local cache to prevent circular references and speed up repeated nested queries. By default
+ * (SESSION) all queries executed during a session are cached. If localCacheScope=STATEMENT local session will be
+ * used just for statement execution, no data will be shared between two different calls to the same SqlSession.
+ * Default is SESSION.
+ */
+ private LocalCacheScope localCacheScope;
+
+ /**
+ * Specifies the JDBC type for null values when no specific JDBC type was provided for the parameter. Some drivers
+ * require specifying the column JDBC type but others work with generic values like NULL, VARCHAR or OTHER. Default
+ * is OTHER.
+ */
+ private JdbcType jdbcTypeForNull;
+
+ /**
+ * Specifies a scroll strategy when omit it per statement settings.
+ */
+ private ResultSetType defaultResultSetType;
+
+ /**
+ * Configures the default executor. SIMPLE executor does nothing special. REUSE executor reuses prepared statements.
+ * BATCH executor reuses statements and batches updates. Default is SIMPLE.
+ */
+ private ExecutorType defaultExecutorType;
+
+ /**
+ * Specifies if and how MyBatis should automatically map columns to fields/properties. NONE disables auto-mapping.
+ * PARTIAL will only auto-map results with no nested result mappings defined inside. FULL will auto-map result
+ * mappings of any complexity (containing nested or otherwise). Default is PARTIAL.
+ */
+ private AutoMappingBehavior autoMappingBehavior;
+
+ /**
+ * Specify the behavior when detects an unknown column (or unknown property type) of automatic mapping target.
+ * Default is NONE.
+ */
+ private AutoMappingUnknownColumnBehavior autoMappingUnknownColumnBehavior;
+
+ /**
+ * Specifies the prefix string that MyBatis will add to the logger names.
+ */
+ private String logPrefix;
+
+ /**
+ * Specifies which Object's methods trigger a lazy load. Default is [equals,clone,hashCode,toString].
+ */
+ private Set lazyLoadTriggerMethods;
+
+ /**
+ * Specifies which logging implementation MyBatis should use. If this setting is not present logging implementation
+ * will be autodiscovered.
+ */
+ private Class logImpl;
+
+ /**
+ * Specifies VFS implementations.
+ */
+ private Class vfsImpl;
+
+ /**
+ * Specifies an sql provider class that holds provider method. This class apply to the type(or value) attribute on
+ * sql provider annotation(e.g. @SelectProvider), when these attribute was omitted.
+ */
+ private Class defaultSqlProviderType;
+
+ /**
+ * Specifies the TypeHandler used by default for Enum.
+ */
+ Class defaultEnumTypeHandler;
+
+ /**
+ * Specifies the class that provides an instance of Configuration. The returned Configuration instance is used to
+ * load lazy properties of deserialized objects. This class must have a method with a signature static Configuration
+ * getConfiguration().
+ */
+ private Class configurationFactory;
+
+ /**
+ * Specify any configuration variables.
+ */
+ private Properties variables;
+
+ void applyTo(Configuration target) {
+ Mapping.from(getSafeRowBoundsEnabled()).whenNotNull(target::setSafeRowBoundsEnabled);
+ Mapping.from(getSafeResultHandlerEnabled()).whenNotNull(target::setSafeResultHandlerEnabled);
+ Mapping.from(getMapUnderscoreToCamelCase()).whenNotNull(target::setMapUnderscoreToCamelCase);
+ Mapping.from(getAggressiveLazyLoading()).whenNotNull(target::setAggressiveLazyLoading);
+ Mapping.from(getMultipleResultSetsEnabled()).whenNotNull(target::setMultipleResultSetsEnabled);
+ Mapping.from(getUseGeneratedKeys()).whenNotNull(target::setUseGeneratedKeys);
+ Mapping.from(getUseColumnLabel()).whenNotNull(target::setUseColumnLabel);
+ Mapping.from(getCacheEnabled()).whenNotNull(target::setCacheEnabled);
+ Mapping.from(getCallSettersOnNulls()).whenNotNull(target::setCallSettersOnNulls);
+ Mapping.from(getUseActualParamName()).whenNotNull(target::setUseActualParamName);
+ Mapping.from(getReturnInstanceForEmptyRow()).whenNotNull(target::setReturnInstanceForEmptyRow);
+ Mapping.from(getShrinkWhitespacesInSql()).whenNotNull(target::setShrinkWhitespacesInSql);
+ Mapping.from(getNullableOnForEach()).whenNotNull(target::setNullableOnForEach);
+ Mapping.from(getArgNameBasedConstructorAutoMapping()).whenNotNull(target::setArgNameBasedConstructorAutoMapping);
+ Mapping.from(getLazyLoadingEnabled()).whenNotNull(target::setLazyLoadingEnabled);
+ Mapping.from(getLogPrefix()).whenNotNull(target::setLogPrefix);
+ Mapping.from(getLazyLoadTriggerMethods()).whenNotNull(target::setLazyLoadTriggerMethods);
+ Mapping.from(getDefaultStatementTimeout()).whenNotNull(target::setDefaultStatementTimeout);
+ Mapping.from(getDefaultFetchSize()).whenNotNull(target::setDefaultFetchSize);
+ Mapping.from(getLocalCacheScope()).whenNotNull(target::setLocalCacheScope);
+ Mapping.from(getJdbcTypeForNull()).whenNotNull(target::setJdbcTypeForNull);
+ Mapping.from(getDefaultResultSetType()).whenNotNull(target::setDefaultResultSetType);
+ Mapping.from(getDefaultExecutorType()).whenNotNull(target::setDefaultExecutorType);
+ Mapping.from(getAutoMappingBehavior()).whenNotNull(target::setAutoMappingBehavior);
+ Mapping.from(getAutoMappingUnknownColumnBehavior()).whenNotNull(target::setAutoMappingUnknownColumnBehavior);
+ Mapping.from(getVariables()).whenNotNull(target::setVariables);
+ Mapping.from(getLogImpl()).whenNotNull(target::setLogImpl);
+ Mapping.from(getVfsImpl()).whenNotNull(target::setVfsImpl);
+ Mapping.from(getDefaultSqlProviderType()).whenNotNull(target::setDefaultSqlProviderType);
+ Mapping.from(getConfigurationFactory()).whenNotNull(target::setConfigurationFactory);
+ Mapping.from(getDefaultEnumTypeHandler()).whenNotNull(target::setDefaultEnumTypeHandler);
+ }
+ }
+
+ /**
+ * {@link FlexGlobalConfig} 配置。
+ *
+ * @author 王帅
+ * @author kfyty725
+ * @since 2023-06-21
+ */
+ @Data
+ @NestedConfigurationProperty
+ public static class GlobalConfig {
+ /**
+ * 启动是否打印 banner 和 版本号。
+ */
+ private boolean printBanner = true;
+
+ /**
+ * 全局的 ID 生成策略配置，当 @Id 未配置 或者 配置 KeyType 为 None 时
+ * 使用当前全局配置。
+ */
+ @NestedConfigurationProperty
+ private FlexGlobalConfig.KeyConfig keyConfig;
+
+ /**
+ * 逻辑删除数据存在标记值。
+ */
+ private Object normalValueOfLogicDelete = FlexConsts.LOGIC_DELETE_NORMAL;
+
+ /**
+ * 逻辑删除数据删除标记值。
+ */
+ private Object deletedValueOfLogicDelete = FlexConsts.LOGIC_DELETE_DELETED;
+
+
+ /**
+ * 默认的分页查询时的每页数据量。
+ */
+ private int defaultPageSize = 10;
+
+
+ /**
+ * 默认的 Relation 注解查询深度。
+ */
+ private int defaultRelationQueryDepth = 2;
+
+ /**
+ * 默认的逻辑删除字段。
+ */
+ private String logicDeleteColumn;
+
+ /**
+ * 默认的多租户字段。
+ */
+ private String tenantColumn;
+
+ /**
+ * 默认的乐观锁字段。
+ */
+ private String versionColumn;
+
+ /**
+ * 全局忽略 @Table 中配置的 schema
+ */
+ private boolean ignoreSchema = false;
+
+ void applyTo(FlexGlobalConfig target) {
+ Mapping.from(isPrintBanner()).whenNotNull(target::setPrintBanner);
+ Mapping.from(getKeyConfig()).whenNotNull(target::setKeyConfig);
+ Mapping.from(getNormalValueOfLogicDelete()).whenNotNull(target::setNormalValueOfLogicDelete);
+ Mapping.from(getDeletedValueOfLogicDelete()).whenNotNull(target::setDeletedValueOfLogicDelete);
+ Mapping.from(getDefaultPageSize()).whenNotNull(target::setDefaultPageSize);
+ Mapping.from(getDefaultRelationQueryDepth()).whenNotNull(target::setDefaultRelationQueryDepth);
+ Mapping.from(getLogicDeleteColumn()).whenNotNull(target::setLogicDeleteColumn);
+ Mapping.from(getVersionColumn()).whenNotNull(target::setVersionColumn);
+ Mapping.from(getTenantColumn()).whenNotNull(target::setTenantColumn);
+ Mapping.from(isIgnoreSchema()).whenNotNull(target::setIgnoreSchema);
+ }
+ }
+
+ /**
+ * MyBatis Flex Admin 配置。
+ *
+ * @author 王帅
+ * @author kfyty725
+ * @since 2023-07-02
+ */
+ @Data
+ @NestedConfigurationProperty
+ public static class AdminConfig {
+ /**
+ * 启用服务。
+ */
+ private boolean enable;
+
+ /**
+ * 连接端点。
+ */
+ private String endpoint;
+
+ /**
+ * 秘密密钥。
+ */
+ private String secretKey;
+ }
+}
diff --git a/mybatis-flex-loveqq-starter/src/main/java/com/mybatisflex/loveqq/framework/boot/autoconfig/annotation/ConditionalOnMybatisFlexDatasource.java b/mybatis-flex-loveqq-starter/src/main/java/com/mybatisflex/loveqq/framework/boot/autoconfig/annotation/ConditionalOnMybatisFlexDatasource.java
new file mode 100644
index 00000000..e3c85a7e
--- /dev/null
+++ b/mybatis-flex-loveqq-starter/src/main/java/com/mybatisflex/loveqq/framework/boot/autoconfig/annotation/ConditionalOnMybatisFlexDatasource.java
@@ -0,0 +1,52 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package com.mybatisflex.loveqq.framework.boot.autoconfig.annotation;
+
+import com.kfyty.loveqq.framework.core.autoconfig.condition.Condition;
+import com.kfyty.loveqq.framework.core.autoconfig.condition.ConditionContext;
+import com.kfyty.loveqq.framework.core.autoconfig.condition.annotation.Conditional;
+import com.kfyty.loveqq.framework.core.autoconfig.env.PropertyContext;
+import com.kfyty.loveqq.framework.core.support.AnnotationMetadata;
+
+import java.lang.annotation.Documented;
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+import java.util.Map;
+
+/**
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package com.mybatisflex.loveqq.framework.boot.autoconfig.customize;
+
+import com.mybatisflex.core.mybatis.FlexConfiguration;
+
+/**
+ * 为 {@link FlexConfiguration} 做自定义的配置支持。
+ *
+ * @author michael
+ */
+@FunctionalInterface
+public interface ConfigurationCustomizer {
+ /**
+ * 自定义配置 {@link FlexConfiguration}。
+ *
+ * @param configuration MyBatis Flex Configuration
+ */
+ void customize(FlexConfiguration configuration);
+}
diff --git a/mybatis-flex-loveqq-starter/src/main/java/com/mybatisflex/loveqq/framework/boot/autoconfig/customize/MyBatisFlexCustomizer.java b/mybatis-flex-loveqq-starter/src/main/java/com/mybatisflex/loveqq/framework/boot/autoconfig/customize/MyBatisFlexCustomizer.java
new file mode 100644
index 00000000..0f7c313f
--- /dev/null
+++ b/mybatis-flex-loveqq-starter/src/main/java/com/mybatisflex/loveqq/framework/boot/autoconfig/customize/MyBatisFlexCustomizer.java
@@ -0,0 +1,46 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package com.mybatisflex.loveqq.framework.boot.autoconfig.customize;
+
+import com.mybatisflex.core.FlexGlobalConfig;
+
+/**
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package com.mybatisflex.loveqq.framework.boot.autoconfig.datasource;
+
+import com.kfyty.loveqq.framework.core.support.Pair;
+import com.mybatisflex.annotation.UseDataSource;
+import com.mybatisflex.core.datasource.DataSourceKey;
+import com.mybatisflex.core.util.StringUtil;
+import org.aopalliance.intercept.MethodInterceptor;
+import org.aopalliance.intercept.MethodInvocation;
+
+import java.lang.reflect.Method;
+import java.util.Map;
+import java.util.concurrent.ConcurrentHashMap;
+
+/**
+ * 多数据源切换拦截器。
+ *
+ * @author 王帅
+ * @author barql
+ * @author michael
+ * @since 2023-06-25
+ */
+public class DataSourceInterceptor implements MethodInterceptor {
+ /**
+ * 缓存方法对应的数据源。
+ */
+ private final Map dsCache = new ConcurrentHashMap<>();
+
+ @Override
+ public Object invoke(MethodInvocation invocation) throws Throwable {
+ String dsKey = getDataSourceKey(invocation.getThis(), invocation.getMethod(), invocation.getArguments());
+ if (StringUtil.noText(dsKey)) {
+ return invocation.proceed();
+ }
+ try {
+ DataSourceKey.use(dsKey);
+ return invocation.proceed();
+ } finally {
+ DataSourceKey.clear();
+ }
+ }
+
+ private String getDataSourceKey(Object target, Method method, Object[] arguments) {
+ Object cacheKey = new Pair<>(method, target.getClass());
+ String dsKey = this.dsCache.get(cacheKey);
+ if (dsKey == null) {
+ dsKey = determineDataSourceKey(method, target.getClass());
+ // 对数据源取值进行动态取值处理
+ if (StringUtil.hasText(dsKey)) {
+ dsKey = DataSourceKey.processDataSourceKey(dsKey, target, method, arguments);
+ }
+ this.dsCache.put(cacheKey, dsKey);
+ }
+ return dsKey;
+ }
+
+ private String determineDataSourceKey(Method method, Class targetClass) {
+ // 方法上定义有 UseDataSource 注解
+ UseDataSource annotation = method.getAnnotation(UseDataSource.class);
+ if (annotation != null) {
+ return annotation.value();
+ }
+ // 类上定义有 UseDataSource 注解
+ annotation = targetClass.getAnnotation(UseDataSource.class);
+ if (annotation != null) {
+ return annotation.value();
+ }
+ // 接口上定义有 UseDataSource 注解
+ Class[] interfaces = targetClass.getInterfaces();
+ for (Class anInterface : interfaces) {
+ annotation = anInterface.getAnnotation(UseDataSource.class);
+ if (annotation != null) {
+ return annotation.value();
+ }
+ }
+ // 哪里都没有 UseDataSource 注解
+ return "";
+ }
+}
diff --git a/mybatis-flex-loveqq-starter/src/main/java/com/mybatisflex/loveqq/framework/boot/autoconfig/package-info.java b/mybatis-flex-loveqq-starter/src/main/java/com/mybatisflex/loveqq/framework/boot/autoconfig/package-info.java
new file mode 100644
index 00000000..ea911cd7
--- /dev/null
+++ b/mybatis-flex-loveqq-starter/src/main/java/com/mybatisflex/loveqq/framework/boot/autoconfig/package-info.java
@@ -0,0 +1,19 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * MyBatis-Flex loveqq-framework 支持。
+ */
+package com.mybatisflex.loveqq.framework.boot.autoconfig;
diff --git a/mybatis-flex-loveqq-starter/src/main/java/com/mybatisflex/loveqq/framework/boot/autoconfig/service/ServiceImpl.java b/mybatis-flex-loveqq-starter/src/main/java/com/mybatisflex/loveqq/framework/boot/autoconfig/service/ServiceImpl.java
new file mode 100644
index 00000000..1fc1990d
--- /dev/null
+++ b/mybatis-flex-loveqq-starter/src/main/java/com/mybatisflex/loveqq/framework/boot/autoconfig/service/ServiceImpl.java
@@ -0,0 +1,40 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package com.mybatisflex.loveqq.framework.boot.autoconfig.service;
+
+import com.kfyty.loveqq.framework.core.autoconfig.annotation.Autowired;
+import com.mybatisflex.core.BaseMapper;
+import com.mybatisflex.core.service.IService;
+
+/**
+ * 由 Mybatis-Flex 提供的顶级增强 Service 接口的默认实现类。
+ *
+ * @param 实体类（Entity）类型
+ * @param 映射类（Mapper）类型
+ * @author 王帅
+ * @since 2023-05-01
+ */
+@SuppressWarnings("SpringJavaInjectionPointsAutowiringInspection")
+public class ServiceImpl, T> implements IService {
+
+ @Autowired
+ protected M mapper;
+
+ @Override
+ public M getMapper() {
+ return mapper;
+ }
+}
diff --git a/mybatis-flex-loveqq-starter/src/main/java/com/mybatisflex/loveqq/framework/boot/autoconfig/transaction/FlexTransaction.java b/mybatis-flex-loveqq-starter/src/main/java/com/mybatisflex/loveqq/framework/boot/autoconfig/transaction/FlexTransaction.java
new file mode 100644
index 00000000..4cccea83
--- /dev/null
+++ b/mybatis-flex-loveqq-starter/src/main/java/com/mybatisflex/loveqq/framework/boot/autoconfig/transaction/FlexTransaction.java
@@ -0,0 +1,87 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package com.mybatisflex.loveqq.framework.boot.autoconfig.transaction;
+
+import com.mybatisflex.core.transaction.TransactionContext;
+import com.mybatisflex.core.util.StringUtil;
+import org.apache.ibatis.transaction.Transaction;
+
+import javax.sql.DataSource;
+import java.sql.Connection;
+import java.sql.SQLException;
+
+/**
+ * spring 事务支持，解决 issues: https://gitee.com/mybatis-flex/mybatis-flex/issues/I7HJ4J
+ *
+ * @author life
+ * @author michael
+ */
+public class FlexTransaction implements Transaction {
+
+ private final DataSource dataSource;
+ private Boolean isConnectionTransactional;
+ private Boolean autoCommit;
+ private Connection connection;
+
+ public FlexTransaction(DataSource dataSource) {
+ this.dataSource = dataSource;
+ }
+
+ @Override
+ public Connection getConnection() throws SQLException {
+ if (isConnectionTransactional == null) {
+ connection = dataSource.getConnection();
+ isConnectionTransactional = StringUtil.hasText(TransactionContext.getXID());
+ autoCommit = connection.getAutoCommit();
+ return connection;
+ }
+ // 在事务中，通过 FlexDataSource 去获取
+ // FlexDataSource 内部会进行 connection 缓存以及多数据源下的 key 判断
+ else if (isConnectionTransactional) {
+ return dataSource.getConnection();
+ }
+ // 非事务，返回当前链接
+ else {
+ return connection;
+ }
+ }
+
+ @Override
+ public void commit() throws SQLException {
+ if (this.connection != null && !this.isConnectionTransactional && !this.autoCommit) {
+ this.connection.commit();
+ }
+ }
+
+ @Override
+ public void rollback() throws SQLException {
+ if (this.connection != null && !this.isConnectionTransactional && !this.autoCommit) {
+ this.connection.rollback();
+ }
+ }
+
+ @Override
+ public void close() throws SQLException {
+ if (this.connection != null && !this.isConnectionTransactional) {
+ connection.close();
+ }
+ }
+
+ @Override
+ public Integer getTimeout() throws SQLException {
+ return TimeoutHolder.getTimeToLiveInSeconds();
+ }
+}
diff --git a/mybatis-flex-loveqq-starter/src/main/java/com/mybatisflex/loveqq/framework/boot/autoconfig/transaction/FlexTransactionFactory.java b/mybatis-flex-loveqq-starter/src/main/java/com/mybatisflex/loveqq/framework/boot/autoconfig/transaction/FlexTransactionFactory.java
new file mode 100644
index 00000000..065e91cf
--- /dev/null
+++ b/mybatis-flex-loveqq-starter/src/main/java/com/mybatisflex/loveqq/framework/boot/autoconfig/transaction/FlexTransactionFactory.java
@@ -0,0 +1,45 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package com.mybatisflex.loveqq.framework.boot.autoconfig.transaction;
+
+import org.apache.ibatis.session.TransactionIsolationLevel;
+import org.apache.ibatis.transaction.Transaction;
+import org.apache.ibatis.transaction.TransactionFactory;
+
+import javax.sql.DataSource;
+import java.sql.Connection;
+
+/**
+ * @author life
+ * @author michael
+ */
+public class FlexTransactionFactory implements TransactionFactory {
+ /**
+ * {@inheritDoc}
+ */
+ @Override
+ public Transaction newTransaction(DataSource dataSource, TransactionIsolationLevel level, boolean autoCommit) {
+ return new FlexTransaction(dataSource);
+ }
+
+ /**
+ * {@inheritDoc}
+ */
+ @Override
+ public Transaction newTransaction(Connection conn) {
+ throw new UnsupportedOperationException("New Flex transactions require a DataSource");
+ }
+}
diff --git a/mybatis-flex-loveqq-starter/src/main/java/com/mybatisflex/loveqq/framework/boot/autoconfig/transaction/FlexTransactionManager.java b/mybatis-flex-loveqq-starter/src/main/java/com/mybatisflex/loveqq/framework/boot/autoconfig/transaction/FlexTransactionManager.java
new file mode 100644
index 00000000..8bf8d0da
--- /dev/null
+++ b/mybatis-flex-loveqq-starter/src/main/java/com/mybatisflex/loveqq/framework/boot/autoconfig/transaction/FlexTransactionManager.java
@@ -0,0 +1,119 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package com.mybatisflex.loveqq.framework.boot.autoconfig.transaction;
+
+import org.springframework.transaction.TransactionDefinition;
+import org.springframework.transaction.TransactionTimedOutException;
+
+import java.util.Date;
+
+/**
+ * 事务定义管理器 用于更完整的实现Spring事务
+ * 仅支持传统事务不支持R2DBC事务
+ *
+ * @author Aliothmoon
+ * @author Michael
+ * @since 2024/10/25
+ */
+public final class TimeoutHolder {
+ private static final ThreadLocal TRANSACTION_DEADLINE = new ThreadLocal<>();
+
+ public static void hold(TransactionDefinition definition) {
+ if (definition == null) {
+ return;
+ }
+ int timeout = definition.getTimeout();
+ if (timeout != TransactionDefinition.TIMEOUT_DEFAULT) {
+ Long deadline = System.currentTimeMillis() + timeout * 1000L;
+ TRANSACTION_DEADLINE.set(deadline);
+ }
+ }
+
+
+ /**
+ * 清除事务上下文
+ */
+ public static void clear() {
+ TRANSACTION_DEADLINE.remove();
+ }
+
+ /**
+ * 获取当前事务可用TTL
+ *
+ * @return int
+ */
+ public static Integer getTimeToLiveInSeconds() {
+ Long deadline = TRANSACTION_DEADLINE.get();
+ if (deadline == null) {
+ return null;
+ }
+ double diff = ((double) getTimeToLiveInMillis(deadline)) / 1000;
+ int secs = (int) Math.ceil(diff);
+ checkTransactionTimeout(secs <= 0, deadline);
+ return secs;
+ }
+
+
+ private static void checkTransactionTimeout(boolean deadlineReached, Long deadline) throws TransactionTimedOutException {
+ if (deadlineReached) {
+ throw new TransactionTimedOutException("Transaction timed out: deadline was " + new Date(deadline));
+ }
+ }
+
+
+ private static long getTimeToLiveInMillis(Long deadline) throws TransactionTimedOutException {
+ if (deadline == null) {
+ throw new IllegalStateException("No timeout specified for this resource holder");
+ }
+ long timeToLive = deadline - System.currentTimeMillis();
+ checkTransactionTimeout(timeToLive <= 0, deadline);
+ return timeToLive;
+ }
+}
diff --git a/mybatis-flex-loveqq-starter/src/main/resources/META-INF/k.factories b/mybatis-flex-loveqq-starter/src/main/resources/META-INF/k.factories
new file mode 100644
index 00000000..653abe35
--- /dev/null
+++ b/mybatis-flex-loveqq-starter/src/main/resources/META-INF/k.factories
@@ -0,0 +1,4 @@
+com.kfyty.loveqq.framework.core.autoconfig.annotation.EnableAutoConfiguration=\
+ com.mybatisflex.loveqq.framework.boot.autoconfig.MybatisFlexProperties,\
+ com.mybatisflex.loveqq.framework.boot.autoconfig.MybatisFlexAutoConfiguration,\
+ com.mybatisflex.loveqq.framework.boot.autoconfig.MybatisFlexAdminAutoConfiguration
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/pom.xml b/mybatis-flex-test/mybatis-flex-loveqq-test/pom.xml
new file mode 100644
index 00000000..5334a5a3
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/pom.xml
@@ -0,0 +1,63 @@
+
+
+ 4.0.0
+
+ mybatis-flex-test
+ com.mybatis-flex
+ 1.10.9
+
+
+ mybatis-flex-loveqq-test
+ jar
+
+
+ 8
+ 8
+
+
+
+
+ com.kfyty
+ loveqq-boot
+ ${loveqq.version}
+
+
+
+ com.mybatis-flex
+ mybatis-flex-loveqq-starter
+ ${mybatis-flex.version}
+
+
+
+ com.kfyty
+ loveqq-boot-starter-logback
+ ${loveqq.version}
+
+
+
+ org.yaml
+ snakeyaml
+ 2.2
+
+
+
+ com.alibaba.fastjson2
+ fastjson2
+ 2.0.32
+
+
+
+ com.mysql
+ mysql-connector-j
+
+
+
+ org.junit.jupiter
+ junit-jupiter
+ 5.5.2
+ test
+
+
+
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/DataSourceInitListener.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/DataSourceInitListener.java
new file mode 100644
index 00000000..ce1575b9
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/DataSourceInitListener.java
@@ -0,0 +1,34 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.mybatisflex.loveqq.test;
+
+import com.kfyty.loveqq.framework.core.autoconfig.annotation.Component;
+import com.kfyty.loveqq.framework.core.event.ApplicationListener;
+import com.kfyty.loveqq.framework.core.event.ContextRefreshedEvent;
+import com.mybatisflex.core.FlexGlobalConfig;
+import com.mybatisflex.core.datasource.FlexDataSource;
+
+@Component
+public class DataSourceInitListener implements ApplicationListener {
+
+ @Override
+ public void onApplicationEvent(ContextRefreshedEvent event) {
+ FlexDataSource dataSource = FlexGlobalConfig.getDefaultConfig().getDataSource();
+ System.out.println("onApplicationEvent>>>> datasource:" + dataSource);
+ }
+
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/MyConfigurationCustomizer.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/MyConfigurationCustomizer.java
new file mode 100644
index 00000000..b54c1157
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/MyConfigurationCustomizer.java
@@ -0,0 +1,59 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.mybatisflex.loveqq.test;
+
+import com.kfyty.loveqq.framework.core.autoconfig.annotation.Configuration;
+import com.mybatisflex.core.FlexGlobalConfig;
+import com.mybatisflex.core.datasource.DataSourceDecipher;
+import com.mybatisflex.core.datasource.DataSourceManager;
+import com.mybatisflex.core.mybatis.FlexConfiguration;
+import com.mybatisflex.loveqq.framework.boot.autoconfig.customize.ConfigurationCustomizer;
+import com.mybatisflex.loveqq.framework.boot.autoconfig.customize.MyBatisFlexCustomizer;
+import com.mybatisflex.loveqq.test.unmapped.MyUnMappedColumnHandler;
+import org.apache.ibatis.logging.stdout.StdOutImpl;
+
+@Configuration
+public class MyConfigurationCustomizer implements ConfigurationCustomizer, MyBatisFlexCustomizer {
+
+ @Override
+ public void customize(FlexConfiguration configuration) {
+ System.out.println(">>>>>>> MyConfigurationCustomizer.customize() invoked");
+ configuration.setLogImpl(StdOutImpl.class);
+ }
+
+// @Bean
+// public DataSourceDecipher decipher() {
+// DataSourceDecipher decipher = new DataSourceDecipher() {
+// @Override
+// public String decrypt(DataSourceProperty property, String value) {
+// System.out.println(">>>>>> decipher.decrypt");
+// return value;
+// }
+// };
+// return decipher;
+// }
+
+ @Override
+ public void customize(FlexGlobalConfig globalConfig) {
+ DataSourceDecipher decipher = (property, value) -> {
+ System.out.println(">>>>>> decipher.decrypt");
+ return value;
+ };
+ DataSourceManager.setDecipher(decipher);
+ globalConfig.setUnMappedColumnHandler(new MyUnMappedColumnHandler());
+ }
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/SampleApplication.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/SampleApplication.java
new file mode 100644
index 00000000..c8294a92
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/SampleApplication.java
@@ -0,0 +1,64 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package com.mybatisflex.loveqq.test;
+
+import com.fasterxml.jackson.databind.ObjectMapper;
+import com.kfyty.loveqq.framework.boot.K;
+import com.kfyty.loveqq.framework.boot.data.orm.mybatis.autoconfig.annotation.MapperScan;
+import com.kfyty.loveqq.framework.core.autoconfig.CommandLineRunner;
+import com.kfyty.loveqq.framework.core.autoconfig.annotation.Autowired;
+import com.kfyty.loveqq.framework.core.autoconfig.annotation.Bean;
+import com.kfyty.loveqq.framework.core.autoconfig.annotation.BootApplication;
+import com.kfyty.loveqq.framework.core.autoconfig.condition.annotation.ConditionalOnMissingBean;
+import com.kfyty.loveqq.framework.core.event.ApplicationListener;
+import com.kfyty.loveqq.framework.core.event.ContextRefreshedEvent;
+import com.kfyty.loveqq.framework.core.utils.JsonUtil;
+import com.mybatisflex.core.audit.AuditManager;
+import com.mybatisflex.core.audit.ConsoleMessageCollector;
+import com.mybatisflex.core.audit.MessageCollector;
+import com.mybatisflex.loveqq.test.mapper.AccountMapper;
+
+@BootApplication
+@MapperScan("com.mybatisflex.loveqq.test.mapper.**.*")
+public class SampleApplication implements CommandLineRunner, ApplicationListener {
+ @Autowired
+ private AccountMapper accountMapper;
+
+ @Override
+ public void run(String... args) throws Exception {
+ System.out.println(this.accountMapper.selectOneById(1));
+ }
+
+ public static void main(String[] args) {
+ K.start(SampleApplication.class, args);
+ }
+
+ @Override
+ public void onApplicationEvent(ContextRefreshedEvent event) {
+ System.out.println("onApplicationEvent");
+ // 开启审计功能
+ AuditManager.setAuditEnable(true);
+ // 设置 SQL 审计收集器
+ MessageCollector collector = new ConsoleMessageCollector((sql, tookTimeMillis) -> System.out.println(sql));
+ AuditManager.setMessageCollector(collector);
+ }
+
+ @ConditionalOnMissingBean
+ @Bean(resolveNested = false, independent = true)
+ public ObjectMapper objectMapper() {
+ return JsonUtil.configure();
+ }
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/alias/BaseEntity.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/alias/BaseEntity.java
new file mode 100644
index 00000000..a94de327
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/alias/BaseEntity.java
@@ -0,0 +1,77 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.mybatisflex.loveqq.test.alias;
+
+import java.io.Serializable;
+import java.util.Date;
+
+/**
+ * 父类。
+ *
+ * @author 王帅
+ * @since 2023-11-16
+ */
+public abstract class BaseEntity implements Serializable {
+
+ private Date createTime;
+ private String createBy;
+ private Date updateTime;
+ private String updateBy;
+
+ public Date getCreateTime() {
+ return createTime;
+ }
+
+ public void setCreateTime(Date createTime) {
+ this.createTime = createTime;
+ }
+
+ public String getCreateBy() {
+ return createBy;
+ }
+
+ public void setCreateBy(String createBy) {
+ this.createBy = createBy;
+ }
+
+ public Date getUpdateTime() {
+ return updateTime;
+ }
+
+ public void setUpdateTime(Date updateTime) {
+ this.updateTime = updateTime;
+ }
+
+ public String getUpdateBy() {
+ return updateBy;
+ }
+
+ public void setUpdateBy(String updateBy) {
+ this.updateBy = updateBy;
+ }
+
+ @Override
+ public String toString() {
+ return "BaseEntity{" +
+ "createTime=" + createTime +
+ ", createBy='" + createBy + '\'' +
+ ", updateTime=" + updateTime +
+ ", updateBy='" + updateBy + '\'' +
+ '}';
+ }
+
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/alias/DeptVO.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/alias/DeptVO.java
new file mode 100644
index 00000000..edc4bd74
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/alias/DeptVO.java
@@ -0,0 +1,57 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.mybatisflex.loveqq.test.alias;
+
+import com.mybatisflex.annotation.TableRef;
+
+/**
+ * 部门。
+ *
+ * @author 王帅
+ * @since 2023-11-16
+ */
+@TableRef(SysDept.class)
+public class DeptVO extends BaseEntity {
+
+ private Integer id;
+ private String deptName;
+
+ public Integer getId() {
+ return id;
+ }
+
+ public void setId(Integer id) {
+ this.id = id;
+ }
+
+ public String getDeptName() {
+ return deptName;
+ }
+
+ public void setDeptName(String deptName) {
+ this.deptName = deptName;
+ }
+
+ @Override
+ public String toString() {
+ return "SysDept{" +
+ "id=" + id +
+ ", deptName='" + deptName + '\'' +
+ '}' + super.toString();
+ }
+
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/alias/RoleVO.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/alias/RoleVO.java
new file mode 100644
index 00000000..3db6f4fa
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/alias/RoleVO.java
@@ -0,0 +1,67 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.mybatisflex.loveqq.test.alias;
+
+import com.mybatisflex.annotation.TableRef;
+
+/**
+ * 角色。
+ *
+ * @author 王帅
+ * @since 2023-11-16
+ */
+@TableRef(SysRole.class)
+public class RoleVO extends BaseEntity {
+
+ private Integer id;
+ private String roleKey;
+ private String roleName;
+
+ public Integer getId() {
+ return id;
+ }
+
+ public void setId(Integer id) {
+ this.id = id;
+ }
+
+ public String getRoleKey() {
+ return roleKey;
+ }
+
+ public void setRoleKey(String roleKey) {
+ this.roleKey = roleKey;
+ }
+
+ public String getRoleName() {
+ return roleName;
+ }
+
+ public void setRoleName(String roleName) {
+ this.roleName = roleName;
+ }
+
+ @Override
+ public String toString() {
+ return "SysRole{" +
+ "id=" + id +
+ ", roleKey='" + roleKey + '\'' +
+ ", roleName='" + roleName + '\'' +
+ '}' + super.toString();
+ }
+
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/alias/SysDept.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/alias/SysDept.java
new file mode 100644
index 00000000..88f0052e
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/alias/SysDept.java
@@ -0,0 +1,59 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.mybatisflex.loveqq.test.alias;
+
+import com.mybatisflex.annotation.Id;
+import com.mybatisflex.annotation.KeyType;
+import com.mybatisflex.annotation.Table;
+
+/**
+ * 部门。
+ *
+ * @author 王帅
+ * @since 2023-11-16
+ */
+@Table("sys_dept")
+public class SysDept extends BaseEntity {
+
+ @Id(keyType = KeyType.Auto)
+ private Integer id;
+ private String deptName;
+
+ public Integer getId() {
+ return id;
+ }
+
+ public void setId(Integer id) {
+ this.id = id;
+ }
+
+ public String getDeptName() {
+ return deptName;
+ }
+
+ public void setDeptName(String deptName) {
+ this.deptName = deptName;
+ }
+
+ @Override
+ public String toString() {
+ return "SysDept{" +
+ "id=" + id +
+ ", deptName='" + deptName + '\'' +
+ '}' + super.toString();
+ }
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/alias/SysRole.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/alias/SysRole.java
new file mode 100644
index 00000000..186cde81
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/alias/SysRole.java
@@ -0,0 +1,70 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.mybatisflex.loveqq.test.alias;
+
+import com.mybatisflex.annotation.Id;
+import com.mybatisflex.annotation.KeyType;
+import com.mybatisflex.annotation.Table;
+
+/**
+ * 角色。
+ *
+ * @author 王帅
+ * @since 2023-11-16
+ */
+@Table("sys_role")
+public class SysRole extends BaseEntity {
+
+ @Id(keyType = KeyType.Auto)
+ private Integer id;
+ private String roleKey;
+ private String roleName;
+
+ public Integer getId() {
+ return id;
+ }
+
+ public void setId(Integer id) {
+ this.id = id;
+ }
+
+ public String getRoleKey() {
+ return roleKey;
+ }
+
+ public void setRoleKey(String roleKey) {
+ this.roleKey = roleKey;
+ }
+
+ public String getRoleName() {
+ return roleName;
+ }
+
+ public void setRoleName(String roleName) {
+ this.roleName = roleName;
+ }
+
+ @Override
+ public String toString() {
+ return "SysRole{" +
+ "id=" + id +
+ ", roleKey='" + roleKey + '\'' +
+ ", roleName='" + roleName + '\'' +
+ '}' + super.toString();
+ }
+
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/alias/SysUser.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/alias/SysUser.java
new file mode 100644
index 00000000..84df58ee
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/alias/SysUser.java
@@ -0,0 +1,106 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.mybatisflex.loveqq.test.alias;
+
+import com.mybatisflex.annotation.ColumnAlias;
+import com.mybatisflex.annotation.Id;
+import com.mybatisflex.annotation.KeyType;
+import com.mybatisflex.annotation.Table;
+
+import java.util.Date;
+import java.util.List;
+
+/**
+ * 用户。
+ *
+ * @author 王帅
+ * @since 2023-11-16
+ */
+@Table("sys_user")
+public class SysUser extends BaseEntity {
+
+ @Id(keyType = KeyType.Auto)
+ private Integer id;
+ private String userName;
+ @ColumnAlias("user_age")
+ private Integer age;
+ private Date birthday;
+
+ private List roleList;
+ private List deptList;
+
+ public List getRoleList() {
+ return roleList;
+ }
+
+ public void setRoleList(List roleList) {
+ this.roleList = roleList;
+ }
+
+ public List getDeptList() {
+ return deptList;
+ }
+
+ public void setDeptList(List deptList) {
+ this.deptList = deptList;
+ }
+
+ public Integer getId() {
+ return id;
+ }
+
+ public void setId(Integer id) {
+ this.id = id;
+ }
+
+ public String getUserName() {
+ return userName;
+ }
+
+ public void setUserName(String userName) {
+ this.userName = userName;
+ }
+
+ public Integer getAge() {
+ return age;
+ }
+
+ public void setAge(Integer age) {
+ this.age = age;
+ }
+
+ public Date getBirthday() {
+ return birthday;
+ }
+
+ public void setBirthday(Date birthday) {
+ this.birthday = birthday;
+ }
+
+ @Override
+ public String toString() {
+ return "SysUser{" +
+ "id=" + id +
+ ", userName='" + userName + '\'' +
+ ", age=" + age +
+ ", birthday=" + birthday +
+ ", roleList=" + roleList +
+ ", deptList=" + deptList +
+ '}' + super.toString();
+ }
+
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/alias/UserVO.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/alias/UserVO.java
new file mode 100644
index 00000000..07e01471
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/alias/UserVO.java
@@ -0,0 +1,103 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.mybatisflex.loveqq.test.alias;
+
+import com.mybatisflex.annotation.ColumnAlias;
+import com.mybatisflex.annotation.TableRef;
+
+import java.util.Date;
+import java.util.List;
+
+/**
+ * 用户。
+ *
+ * @author 王帅
+ * @since 2023-11-16
+ */
+@TableRef(SysUser.class)
+public class UserVO extends BaseEntity {
+
+ private Integer id;
+ private String userName;
+ @ColumnAlias("user_age")
+ private Integer age;
+ private Date birthday;
+
+ private List roleList;
+ private List deptList;
+
+ public List getRoleList() {
+ return roleList;
+ }
+
+ public void setRoleList(List roleList) {
+ this.roleList = roleList;
+ }
+
+ public List getDeptList() {
+ return deptList;
+ }
+
+ public void setDeptList(List deptList) {
+ this.deptList = deptList;
+ }
+
+ public Integer getId() {
+ return id;
+ }
+
+ public void setId(Integer id) {
+ this.id = id;
+ }
+
+ public String getUserName() {
+ return userName;
+ }
+
+ public void setUserName(String userName) {
+ this.userName = userName;
+ }
+
+ public Integer getAge() {
+ return age;
+ }
+
+ public void setAge(Integer age) {
+ this.age = age;
+ }
+
+ public Date getBirthday() {
+ return birthday;
+ }
+
+ public void setBirthday(Date birthday) {
+ this.birthday = birthday;
+ }
+
+ @Override
+ public String toString() {
+ return "SysUser{" +
+ "id=" + id +
+ ", userName='" + userName + '\'' +
+ ", age=" + age +
+ ", birthday=" + birthday +
+ ", roleList=" + roleList +
+ ", deptList=" + deptList +
+ '}' + super.toString();
+ }
+
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/entity/Inner.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/entity/Inner.java
new file mode 100644
index 00000000..9fbb5b46
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/entity/Inner.java
@@ -0,0 +1,55 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.mybatisflex.loveqq.test.entity;
+
+import com.mybatisflex.annotation.Table;
+
+/**
+ * @author 王帅
+ * @since 2023-07-01
+ */
+@Table("tb_inner")
+public class Inner {
+
+ private Integer id;
+ private String type;
+
+ public Integer getId() {
+ return id;
+ }
+
+ public void setId(Integer id) {
+ this.id = id;
+ }
+
+ public String getType() {
+ return type;
+ }
+
+ public void setType(String type) {
+ this.type = type;
+ }
+
+ @Override
+ public String toString() {
+ return "Inner{" +
+ "id=" + id +
+ ", type='" + type + '\'' +
+ '}';
+ }
+
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/entity/Outer.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/entity/Outer.java
new file mode 100644
index 00000000..2cf4ab3c
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/entity/Outer.java
@@ -0,0 +1,64 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.mybatisflex.loveqq.test.entity;
+
+import com.mybatisflex.annotation.ColumnAlias;
+import com.mybatisflex.annotation.Table;
+import com.mybatisflex.loveqq.test.model.IdEntity;
+
+/**
+ * @author 王帅
+ * @since 2023-06-16
+ */
+@Table("tb_outer")
+public class Outer extends IdEntity {
+
+ private String name;
+ private Inner inner;
+
+ @Override
+ @ColumnAlias("outer_id")
+ public Integer getId() {
+ return super.getId();
+ }
+
+ public String getName() {
+ return name;
+ }
+
+ public void setName(String name) {
+ this.name = name;
+ }
+
+ public Inner getInner() {
+ return inner;
+ }
+
+ public void setInner(Inner inner) {
+ this.inner = inner;
+ }
+
+ @Override
+ public String toString() {
+ return "Outer{" +
+ "id='" + id + '\'' +
+ ", name='" + name + '\'' +
+ ", inner=" + inner +
+ '}';
+ }
+
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/entity/TestEntity.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/entity/TestEntity.java
new file mode 100644
index 00000000..ab2824f3
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/entity/TestEntity.java
@@ -0,0 +1,28 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.mybatisflex.loveqq.test.entity;
+
+import com.mybatisflex.annotation.Table;
+
+/**
+ * @author 王帅
+ * @since 2023-06-16
+ */
+@Table("test")
+public class TestEntity {
+
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/listener/missingListenerFix/AccountAgeInsertListener.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/listener/missingListenerFix/AccountAgeInsertListener.java
new file mode 100644
index 00000000..6ac30042
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/listener/missingListenerFix/AccountAgeInsertListener.java
@@ -0,0 +1,13 @@
+package com.mybatisflex.loveqq.test.listener.missingListenerFix;
+
+import com.mybatisflex.annotation.InsertListener;
+import com.mybatisflex.loveqq.test.model.AccountMissingListenerTestModel;
+
+public class AccountAgeInsertListener implements InsertListener {
+
+ @Override
+ public void onInsert(Object entity) {
+ AccountMissingListenerTestModel model = (AccountMissingListenerTestModel) entity;
+ model.setAge(18);
+ }
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/listener/missingListenerFix/AccountAgeInsertListenerFlag.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/listener/missingListenerFix/AccountAgeInsertListenerFlag.java
new file mode 100644
index 00000000..a03f05eb
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/listener/missingListenerFix/AccountAgeInsertListenerFlag.java
@@ -0,0 +1,5 @@
+package com.mybatisflex.loveqq.test.listener.missingListenerFix;
+
+public interface AccountAgeInsertListenerFlag {
+
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/listener/missingListenerFix/AccountTableAnnoInsertListener.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/listener/missingListenerFix/AccountTableAnnoInsertListener.java
new file mode 100644
index 00000000..fbbc136f
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/listener/missingListenerFix/AccountTableAnnoInsertListener.java
@@ -0,0 +1,13 @@
+package com.mybatisflex.loveqq.test.listener.missingListenerFix;
+
+import com.mybatisflex.annotation.InsertListener;
+import com.mybatisflex.loveqq.test.model.AccountMissingListenerTestModel;
+
+public class AccountTableAnnoInsertListener implements InsertListener {
+
+ @Override
+ public void onInsert(Object entity) {
+ AccountMissingListenerTestModel model = (AccountMissingListenerTestModel) entity;
+ model.setUserName("测试缺失的监听器-userName");
+ }
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/listener/missingListenerFix/BaseLogicDelete.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/listener/missingListenerFix/BaseLogicDelete.java
new file mode 100644
index 00000000..7c581bad
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/listener/missingListenerFix/BaseLogicDelete.java
@@ -0,0 +1,18 @@
+package com.mybatisflex.loveqq.test.listener.missingListenerFix;
+
+import com.mybatisflex.annotation.Column;
+
+public class BaseLogicDelete implements LogicDeleteInsertListenerFlag {
+
+ @Column(isLogicDelete = true)
+ private Boolean isDelete;
+
+ public Boolean getDelete() {
+ return isDelete;
+ }
+
+ public void setDelete(Boolean delete) {
+ isDelete = delete;
+ }
+
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/listener/missingListenerFix/LogicDeleteInsertListener.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/listener/missingListenerFix/LogicDeleteInsertListener.java
new file mode 100644
index 00000000..edb00098
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/listener/missingListenerFix/LogicDeleteInsertListener.java
@@ -0,0 +1,12 @@
+package com.mybatisflex.loveqq.test.listener.missingListenerFix;
+
+import com.mybatisflex.annotation.InsertListener;
+
+public class LogicDeleteInsertListener implements InsertListener {
+
+ @Override
+ public void onInsert(Object entity) {
+ BaseLogicDelete logicDeleteEntity = (BaseLogicDelete) entity;
+ logicDeleteEntity.setDelete(false);
+ }
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/listener/missingListenerFix/LogicDeleteInsertListenerFlag.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/listener/missingListenerFix/LogicDeleteInsertListenerFlag.java
new file mode 100644
index 00000000..acd52c60
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/listener/missingListenerFix/LogicDeleteInsertListenerFlag.java
@@ -0,0 +1,5 @@
+package com.mybatisflex.loveqq.test.listener.missingListenerFix;
+
+public interface LogicDeleteInsertListenerFlag {
+
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/mapper/AccountMapper.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/mapper/AccountMapper.java
new file mode 100644
index 00000000..6981033b
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/mapper/AccountMapper.java
@@ -0,0 +1,28 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.mybatisflex.loveqq.test.mapper;
+
+import com.mybatisflex.core.BaseMapper;
+import com.mybatisflex.loveqq.test.model.Account;
+
+/**
+ * @author 王帅
+ * @since 2023-06-23
+ */
+public interface AccountMapper extends BaseMapper {
+
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/mapper/AccountMissingListenerTestModelMapper.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/mapper/AccountMissingListenerTestModelMapper.java
new file mode 100644
index 00000000..1499f773
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/mapper/AccountMissingListenerTestModelMapper.java
@@ -0,0 +1,10 @@
+package com.mybatisflex.loveqq.test.mapper;
+
+import com.mybatisflex.core.BaseMapper;
+import com.mybatisflex.loveqq.test.model.AccountMissingListenerTestModel;
+
+/**
+ * @author noear 2024/12/24 created
+ */
+public interface AccountMissingListenerTestModelMapper extends BaseMapper {
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/mapper/ArticleMapper.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/mapper/ArticleMapper.java
new file mode 100644
index 00000000..795fd494
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/mapper/ArticleMapper.java
@@ -0,0 +1,10 @@
+package com.mybatisflex.loveqq.test.mapper;
+
+import com.mybatisflex.core.BaseMapper;
+import com.mybatisflex.loveqq.test.model.Article;
+
+/**
+ * @author noear 2024/12/24 created
+ */
+public interface ArticleMapper extends BaseMapper {
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/mapper/FieldMappingInnerMapper.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/mapper/FieldMappingInnerMapper.java
new file mode 100644
index 00000000..f437f87e
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/mapper/FieldMappingInnerMapper.java
@@ -0,0 +1,10 @@
+package com.mybatisflex.loveqq.test.mapper;
+
+import com.mybatisflex.core.BaseMapper;
+import com.mybatisflex.loveqq.test.model.FieldMappingInner;
+
+/**
+ * @author noear 2024/12/24 created
+ */
+public interface FieldMappingInnerMapper extends BaseMapper {
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/mapper/FieldMappingMapper.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/mapper/FieldMappingMapper.java
new file mode 100644
index 00000000..ac12666f
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/mapper/FieldMappingMapper.java
@@ -0,0 +1,10 @@
+package com.mybatisflex.loveqq.test.mapper;
+
+import com.mybatisflex.core.BaseMapper;
+import com.mybatisflex.loveqq.test.model.FieldMapping;
+
+/**
+ * @author noear 2024/12/24 created
+ */
+public interface FieldMappingMapper extends BaseMapper {
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/mapper/GoodMapper.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/mapper/GoodMapper.java
new file mode 100644
index 00000000..22403503
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/mapper/GoodMapper.java
@@ -0,0 +1,10 @@
+package com.mybatisflex.loveqq.test.mapper;
+
+import com.mybatisflex.core.BaseMapper;
+import com.mybatisflex.loveqq.test.model.Good;
+
+/**
+ * @author noear 2024/12/24 created
+ */
+public interface GoodMapper extends BaseMapper {
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/mapper/InnerMapper.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/mapper/InnerMapper.java
new file mode 100644
index 00000000..3f477854
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/mapper/InnerMapper.java
@@ -0,0 +1,10 @@
+package com.mybatisflex.loveqq.test.mapper;
+
+import com.mybatisflex.core.BaseMapper;
+import com.mybatisflex.loveqq.test.entity.Inner;
+
+/**
+ * @author noear 2024/12/24 created
+ */
+public interface InnerMapper extends BaseMapper {
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/mapper/MyAccountMapper.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/mapper/MyAccountMapper.java
new file mode 100644
index 00000000..bef52c32
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/mapper/MyAccountMapper.java
@@ -0,0 +1,40 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.mybatisflex.loveqq.test.mapper;
+
+import com.mybatisflex.loveqq.test.model.Account;
+import com.mybatisflex.loveqq.test.model.AccountDto;
+import com.mybatisflex.loveqq.test.model.AccountView;
+import org.apache.ibatis.annotations.Param;
+import org.apache.ibatis.annotations.Select;
+
+import java.util.Map;
+
+public interface MyAccountMapper extends AccountMapper {
+
+
+ AccountDto selectByName(@Param("name") String name);
+
+ AccountView selectViewObject();
+
+ @Select("select * from tb_account where id = #{id} and id =#{id}")
+ Account selectById(@Param("id") Object id);
+
+ @Select("select * from tb_account where id = #{id}")
+ Map selectMapById(@Param("id") Object id);
+
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/mapper/OuterMapper.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/mapper/OuterMapper.java
new file mode 100644
index 00000000..ebc23c32
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/mapper/OuterMapper.java
@@ -0,0 +1,10 @@
+package com.mybatisflex.loveqq.test.mapper;
+
+import com.mybatisflex.core.BaseMapper;
+import com.mybatisflex.loveqq.test.entity.Outer;
+
+/**
+ * @author noear 2024/12/24 created
+ */
+public interface OuterMapper extends BaseMapper {
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/mapper/PatientMapper.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/mapper/PatientMapper.java
new file mode 100644
index 00000000..dc2fd7e9
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/mapper/PatientMapper.java
@@ -0,0 +1,10 @@
+package com.mybatisflex.loveqq.test.mapper;
+
+import com.mybatisflex.core.BaseMapper;
+import com.mybatisflex.loveqq.test.model.Patient;
+
+/**
+ * @author noear 2024/12/24 created
+ */
+public interface PatientMapper extends BaseMapper {
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/mapper/SysUserMapper.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/mapper/SysUserMapper.java
new file mode 100644
index 00000000..13acf7b4
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/mapper/SysUserMapper.java
@@ -0,0 +1,10 @@
+package com.mybatisflex.loveqq.test.mapper;
+
+import com.mybatisflex.core.BaseMapper;
+import com.mybatisflex.loveqq.test.alias.SysUser;
+
+/**
+ * @author noear 2024/12/24 created
+ */
+public interface SysUserMapper extends BaseMapper {
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/mapper/TbClassMapper.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/mapper/TbClassMapper.java
new file mode 100644
index 00000000..809de86e
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/mapper/TbClassMapper.java
@@ -0,0 +1,7 @@
+package com.mybatisflex.loveqq.test.mapper;
+
+import com.mybatisflex.core.BaseMapper;
+import com.mybatisflex.loveqq.test.model.TbClass;
+
+public interface TbClassMapper extends BaseMapper {
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/mapper/UnmappedUserMapper.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/mapper/UnmappedUserMapper.java
new file mode 100644
index 00000000..8634189c
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/mapper/UnmappedUserMapper.java
@@ -0,0 +1,10 @@
+package com.mybatisflex.loveqq.test.mapper;
+
+import com.mybatisflex.core.BaseMapper;
+import com.mybatisflex.loveqq.test.model.UnmappedUser;
+
+/**
+ * @author noear 2024/12/24 created
+ */
+public interface UnmappedUserMapper extends BaseMapper {
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/mapper/UserMapper.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/mapper/UserMapper.java
new file mode 100644
index 00000000..95a71afd
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/mapper/UserMapper.java
@@ -0,0 +1,10 @@
+package com.mybatisflex.loveqq.test.mapper;
+
+import com.mybatisflex.core.BaseMapper;
+import com.mybatisflex.loveqq.test.model.User;
+
+/**
+ * @author noear 2024/12/24 created
+ */
+public interface UserMapper extends BaseMapper {
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/Account.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/Account.java
new file mode 100644
index 00000000..ccd2a571
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/Account.java
@@ -0,0 +1,122 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.mybatisflex.loveqq.test.model;
+
+import com.mybatisflex.annotation.SetListener;
+
+public class AccountOnSetListener implements SetListener {
+
+ @Override
+ public Object onSet(Object entity, String property, Object value) {
+ System.out.println(">>>>>>> property: " + property + " value:" + value);
+ return value;
+ }
+
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/AccountVO.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/AccountVO.java
new file mode 100644
index 00000000..87c2e7f7
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/AccountVO.java
@@ -0,0 +1,70 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package com.mybatisflex.loveqq.test.model;
+
+import java.util.Date;
+
+public class AccountVO extends IdEntity {
+
+ private Integer age;
+ private Date birthday;
+
+ private Gender gender;
+ private RoleVO2 role;
+
+ public RoleVO2 getRole() {
+ return role;
+ }
+
+ public void setRole(RoleVO2 role) {
+ this.role = role;
+ }
+
+ public Gender getGender() {
+ return gender;
+ }
+
+ public void setGender(Gender gender) {
+ this.gender = gender;
+ }
+
+ public Integer getAge() {
+ return age;
+ }
+
+ public void setAge(Integer age) {
+ this.age = age;
+ }
+
+ public Date getBirthday() {
+ return birthday;
+ }
+
+ public void setBirthday(Date birthday) {
+ this.birthday = birthday;
+ }
+
+ @Override
+ public String toString() {
+ return "Account{" +
+ "id=" + id +
+ ", age=" + age +
+ ", birthday=" + birthday +
+ ", roleName=" + role +
+ '}';
+ }
+
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/AccountVO2.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/AccountVO2.java
new file mode 100644
index 00000000..9b4e3f1f
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/AccountVO2.java
@@ -0,0 +1,76 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.mybatisflex.loveqq.test.model;
+
+import com.mybatisflex.annotation.ColumnAlias;
+
+/**
+ * @author 王帅
+ * @since 2023-06-30
+ */
+public class AccountVO2 extends IdEntity {
+
+ private Integer age;
+
+ @ColumnAlias("account_name")
+ private String userName;
+
+
+ private User user;
+
+
+ @Override
+ @ColumnAlias("account_id")
+ public Long getId() {
+ return super.getId();
+ }
+
+ public Integer getAge() {
+ return age;
+ }
+
+ public void setAge(Integer age) {
+ this.age = age;
+ }
+
+ public String getUserName() {
+ return userName;
+ }
+
+ public void setUserName(String userName) {
+ this.userName = userName;
+ }
+
+ public User getUser() {
+ return user;
+ }
+
+ public void setUser(User user) {
+ this.user = user;
+ }
+
+ @Override
+ public String toString() {
+ return "AccountVO2{" +
+ "id=" + id +
+ ", age=" + age +
+ ", userName='" + userName + '\'' +
+ ", user='" + user + '\'' +
+ '}';
+ }
+
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/AccountView.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/AccountView.java
new file mode 100644
index 00000000..f9dfdb33
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/AccountView.java
@@ -0,0 +1,54 @@
+package com.mybatisflex.loveqq.test.model;
+
+import java.util.Date;
+import java.util.List;
+
+/**
+ * 复杂查询接收类
+ * 演示问题。
+ *
+ * @author 王帅
+ * @since 2024-10-03
+ */
+@SuppressWarnings({"LombokGetterMayBeUsed", "LombokSetterMayBeUsed"})
+public class AccountView {
+
+ private Long id;
+ private String userName;
+ private Date birthday;
+
+ private List accountList;
+
+ public Long getId() {
+ return id;
+ }
+
+ public void setId(Long id) {
+ this.id = id;
+ }
+
+ public String getUserName() {
+ return userName;
+ }
+
+ public void setUserName(String userName) {
+ this.userName = userName;
+ }
+
+ public Date getBirthday() {
+ return birthday;
+ }
+
+ public void setBirthday(Date birthday) {
+ this.birthday = birthday;
+ }
+
+ public List getAccountList() {
+ return accountList;
+ }
+
+ public void setAccountList(List accountList) {
+ this.accountList = accountList;
+ }
+
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/Article.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/Article.java
new file mode 100644
index 00000000..45387da8
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/Article.java
@@ -0,0 +1,71 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.mybatisflex.loveqq.test.model;
+
+import com.mybatisflex.annotation.Column;
+import com.mybatisflex.annotation.Table;
+
+@Table(value = "tb_article")
+public class Article extends IdEntity {
+
+ private static final long serialVersionUID = 1L;
+
+
+ private Long accountId;
+
+ private String title;
+
+ private String content;
+
+ @Column(isLogicDelete = true)
+ private Boolean isDelete;
+
+ public Long getAccountId() {
+ return accountId;
+ }
+
+ public void setAccountId(Long accountId) {
+ this.accountId = accountId;
+ }
+
+ public String getTitle() {
+ return title;
+ }
+
+ public void setTitle(String title) {
+ this.title = title;
+ }
+
+ public String getContent() {
+ return content;
+ }
+
+ public void setContent(String content) {
+ this.content = content;
+ }
+
+ @Override
+ public String toString() {
+ return "Article{" +
+ "id=" + id +
+ ", accountId=" + accountId +
+ ", title='" + title + '\'' +
+ ", content='" + content + '\'' +
+ '}';
+ }
+
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/BaseEntity.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/BaseEntity.java
new file mode 100644
index 00000000..d7ef41a1
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/BaseEntity.java
@@ -0,0 +1,57 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.mybatisflex.loveqq.test.model;
+
+import com.mybatisflex.annotation.Column;
+
+import java.util.List;
+
+/**
+ * @author 王帅
+ * @since 2.0
+ */
+public class BaseEntity extends IdEntity {
+
+ /**
+ * 用户名。
+ */
+ protected T userName;
+
+ /**
+ * 用户角色。
+ */
+ @Column(ignore = true)
+ protected List roles;
+
+ public List getRoles() {
+ return roles;
+ }
+
+ public void setRoles(List roles) {
+ this.roles = roles;
+ }
+
+
+ public T getUserName() {
+ return userName;
+ }
+
+ public void setUserName(T userName) {
+ this.userName = userName;
+ }
+
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/Disease.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/Disease.java
new file mode 100644
index 00000000..8882f4b4
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/Disease.java
@@ -0,0 +1,45 @@
+package com.mybatisflex.loveqq.test.model;
+
+import com.mybatisflex.annotation.Id;
+import com.mybatisflex.annotation.KeyType;
+import com.mybatisflex.annotation.Table;
+
+import java.io.Serializable;
+
+/**
+ * 疾病
+ *
+ * @author Ice 2023/09/26
+ * @version 1.0
+ */
+@Table(value = "tb_disease")
+public class Disease implements Serializable {
+ private static final long serialVersionUID = -3195530228167432902L;
+
+ /**
+ * ID
+ */
+ @Id(keyType = KeyType.Generator, value = "uuid")
+ private String diseaseId;
+
+ /**
+ * 疾病名称
+ */
+ private String name;
+
+ public String getDiseaseId() {
+ return diseaseId;
+ }
+
+ public void setDiseaseId(String diseaseId) {
+ this.diseaseId = diseaseId;
+ }
+
+ public String getName() {
+ return name;
+ }
+
+ public void setName(String name) {
+ this.name = name;
+ }
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/FieldMapping.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/FieldMapping.java
new file mode 100644
index 00000000..9a81414f
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/FieldMapping.java
@@ -0,0 +1,66 @@
+package com.mybatisflex.loveqq.test.model;
+
+
+import com.mybatisflex.annotation.Column;
+import com.mybatisflex.annotation.Id;
+import com.mybatisflex.annotation.KeyType;
+import com.mybatisflex.annotation.Table;
+import com.mybatisflex.core.activerecord.Model;
+import com.mybatisflex.core.keygen.KeyGenerators;
+
+import java.util.Date;
+import java.util.Objects;
+
+
+@Table("field_mapping")
+public class FieldMapping extends Model {
+ @Id(keyType = KeyType.Generator,value = KeyGenerators.snowFlakeId)
+ private String id;
+ @Column(ignore = true)
+ private Date innerDate;
+
+ public String getId() {
+ return id;
+ }
+
+ public static FieldMapping create() {
+ return new FieldMapping();
+ }
+
+ public FieldMapping setId(String id) {
+ this.id = id;
+ return this;
+ }
+
+ public Date getInnerDate() {
+ return innerDate;
+ }
+
+ public FieldMapping setInnerDate(Date innerDate) {
+ this.innerDate = innerDate;
+ return this;
+ }
+
+ @Override
+ public boolean equals(Object o) {
+ if (this == o) return true;
+ if (o == null || getClass() != o.getClass()) return false;
+ FieldMapping that = (FieldMapping) o;
+ return Objects.equals(id, that.id) && Objects.equals(innerDate, that.innerDate);
+ }
+
+ @Override
+ public int hashCode() {
+ return Objects.hash(id, innerDate);
+ }
+
+ @Override
+ public String toString() {
+ return "FieldMapping{" +
+ "id='" + id + '\'' +
+ ", innerDate=" + innerDate +
+ '}';
+ }
+
+}
+
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/FieldMappingInner.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/FieldMappingInner.java
new file mode 100644
index 00000000..395bec52
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/FieldMappingInner.java
@@ -0,0 +1,71 @@
+package com.mybatisflex.loveqq.test.model;
+
+import com.mybatisflex.annotation.Id;
+import com.mybatisflex.annotation.KeyType;
+import com.mybatisflex.annotation.Table;
+import com.mybatisflex.core.activerecord.Model;
+import com.mybatisflex.core.keygen.KeyGenerators;
+
+import java.util.Date;
+import java.util.Objects;
+
+@Table("field_mapping_inner")
+public class FieldMappingInner extends Model {
+ @Id(keyType = KeyType.Generator,value = KeyGenerators.snowFlakeId)
+ private String id;
+ private String outId;
+ private Date createDate;
+
+ public static FieldMappingInner create() {
+ return new FieldMappingInner();
+ }
+
+ public String getId() {
+ return id;
+ }
+
+ public FieldMappingInner setId(String id) {
+ this.id = id;
+ return this;
+ }
+
+ public String getOutId() {
+ return outId;
+ }
+
+ public FieldMappingInner setOutId(String outId) {
+ this.outId = outId;
+ return this;
+ }
+
+ public Date getCreateDate() {
+ return createDate;
+ }
+
+ public FieldMappingInner setCreateDate(Date createDate) {
+ this.createDate = createDate;
+ return this;
+ }
+
+ @Override
+ public boolean equals(Object o) {
+ if (this == o) return true;
+ if (o == null || getClass() != o.getClass()) return false;
+ FieldMappingInner that = (FieldMappingInner) o;
+ return Objects.equals(id, that.id) && Objects.equals(outId, that.outId) && Objects.equals(createDate, that.createDate);
+ }
+
+ @Override
+ public int hashCode() {
+ return Objects.hash(id, outId, createDate);
+ }
+
+ @Override
+ public String toString() {
+ return "FieldMappingInner{" +
+ "id='" + id + '\'' +
+ ", outId='" + outId + '\'' +
+ ", createDate=" + createDate +
+ '}';
+ }
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/Gender.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/Gender.java
new file mode 100644
index 00000000..2a12bc67
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/Gender.java
@@ -0,0 +1,41 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.mybatisflex.loveqq.test.model;
+
+import com.mybatisflex.annotation.EnumValue;
+
+/**
+ * @author 王帅
+ * @since 2023-06-14
+ */
+public enum Gender {
+
+ // MALE, FEMALE;
+ MALE(1), FEMALE(0);
+
+ public int getCode() {
+ return code;
+ }
+
+ @EnumValue
+ private final int code;
+
+ Gender(int code) {
+ this.code = code;
+ }
+
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/Good.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/Good.java
new file mode 100644
index 00000000..c6315adf
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/Good.java
@@ -0,0 +1,108 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.mybatisflex.loveqq.test.model;
+
+import com.mybatisflex.annotation.Id;
+import com.mybatisflex.annotation.KeyType;
+import com.mybatisflex.annotation.Table;
+import com.mybatisflex.core.activerecord.Model;
+
+import java.util.Objects;
+
+/**
+ * 商品。
+ *
+ * @author 王帅
+ * @since 2023-06-07
+ */
+@Table(value = "tb_good", onSet = GoodOnSetListener.class)
+public class Good extends Model {
+
+ @Id(keyType = KeyType.Auto)
+ private Integer goodId;
+ private String name;
+ private Double price;
+
+ public static Good create() {
+ return new Good();
+ }
+
+ public Integer getGoodId() {
+ return goodId;
+ }
+
+ public Good setGoodId(Integer goodId) {
+ this.goodId = goodId;
+ return this;
+ }
+
+ public String getName() {
+ return name;
+ }
+
+ public Good setName(String name) {
+ this.name = name;
+ return this;
+ }
+
+ public Double getPrice() {
+ return price;
+ }
+
+ public Good setPrice(Double price) {
+ this.price = price;
+ return this;
+ }
+
+ @Override
+ public String toString() {
+ return "Good{" +
+ "goodId=" + goodId +
+ ", name='" + name + '\'' +
+ ", price=" + price +
+ '}';
+ }
+
+ @Override
+ public boolean equals(Object o) {
+ if (this == o) {
+ return true;
+ }
+ if (o == null || getClass() != o.getClass()) {
+ return false;
+ }
+
+ Good good = (Good) o;
+
+ if (!Objects.equals(goodId, good.goodId)) {
+ return false;
+ }
+ if (!Objects.equals(name, good.name)) {
+ return false;
+ }
+ return Objects.equals(price, good.price);
+ }
+
+ @Override
+ public int hashCode() {
+ int result = goodId != null ? goodId.hashCode() : 0;
+ result = 31 * result + (name != null ? name.hashCode() : 0);
+ result = 31 * result + (price != null ? price.hashCode() : 0);
+ return result;
+ }
+
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/GoodOnSetListener.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/GoodOnSetListener.java
new file mode 100644
index 00000000..fea52c6e
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/GoodOnSetListener.java
@@ -0,0 +1,33 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.mybatisflex.loveqq.test.model;
+
+import com.mybatisflex.annotation.SetListener;
+
+/**
+ * @author 王帅
+ * @since 2023-08-11
+ */
+public class GoodOnSetListener implements SetListener {
+
+ @Override
+ public Object onSet(Object entity, String property, Object value) {
+ System.out.println("Good: " + property + " --- " + value);
+ return value;
+ }
+
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/IdCard.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/IdCard.java
new file mode 100644
index 00000000..fb13a153
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/IdCard.java
@@ -0,0 +1,55 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.mybatisflex.loveqq.test.model;
+
+import com.mybatisflex.annotation.Table;
+
+/**
+ * @author 王帅
+ * @since 2023-07-12
+ */
+@Table("tb_id_card")
+public class IdCard {
+
+ private Integer id;
+ private String idNumber;
+
+ public Integer getId() {
+ return id;
+ }
+
+ public void setId(Integer id) {
+ this.id = id;
+ }
+
+ public String getIdNumber() {
+ return idNumber;
+ }
+
+ public void setIdNumber(String idNumber) {
+ this.idNumber = idNumber;
+ }
+
+ @Override
+ public String toString() {
+ return "IdCard{" +
+ "id=" + id +
+ ", IdNumber='" + idNumber + '\'' +
+ '}';
+ }
+
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/IdEntity.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/IdEntity.java
new file mode 100644
index 00000000..f036ee20
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/IdEntity.java
@@ -0,0 +1,44 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.mybatisflex.loveqq.test.model;
+
+import com.mybatisflex.annotation.Id;
+import com.mybatisflex.annotation.KeyType;
+
+import java.io.Serializable;
+
+/**
+ * @author 王帅
+ * @since 2023-06-13
+ */
+public class IdEntity implements Serializable {
+
+ /**
+ * 主键。
+ */
+ @Id(keyType = KeyType.Auto)
+ protected T id;
+
+ public T getId() {
+ return id;
+ }
+
+ public void setId(T id) {
+ this.id = id;
+ }
+
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/Order.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/Order.java
new file mode 100644
index 00000000..55624be7
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/Order.java
@@ -0,0 +1,61 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.mybatisflex.loveqq.test.model;
+
+import com.mybatisflex.annotation.Id;
+import com.mybatisflex.annotation.Table;
+
+import java.time.LocalDateTime;
+
+/**
+ * 订单。
+ *
+ * @author 王帅
+ * @since 2023-06-07
+ */
+@Table("tb_order")
+public class Order {
+
+ @Id
+ private int orderId;
+ private LocalDateTime createTime;
+
+ public int getOrderId() {
+ return orderId;
+ }
+
+ public void setOrderId(int orderId) {
+ this.orderId = orderId;
+ }
+
+ public LocalDateTime getCreateTime() {
+ return createTime;
+ }
+
+ public void setCreateTime(LocalDateTime createTime) {
+ this.createTime = createTime;
+ }
+
+ @Override
+ public String toString() {
+ return "Order{" +
+ "orderId=" + orderId +
+ ", createTime=" + createTime +
+ '}';
+ }
+
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/OrderGood.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/OrderGood.java
new file mode 100644
index 00000000..edd92cc7
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/OrderGood.java
@@ -0,0 +1,49 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.mybatisflex.loveqq.test.model;
+
+import com.mybatisflex.annotation.Table;
+
+/**
+ * 订单与商品连接表。
+ *
+ * @author 王帅
+ * @since 2023-06-07
+ */
+@Table("tb_order_good")
+public class OrderGood {
+
+ private Integer orderId;
+ private Integer goodId;
+
+ public Integer getOrderId() {
+ return orderId;
+ }
+
+ public void setOrderId(Integer orderId) {
+ this.orderId = orderId;
+ }
+
+ public Integer getGoodId() {
+ return goodId;
+ }
+
+ public void setGoodId(Integer goodId) {
+ this.goodId = goodId;
+ }
+
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/OrderInfo.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/OrderInfo.java
new file mode 100644
index 00000000..bfdcde3a
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/OrderInfo.java
@@ -0,0 +1,106 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.mybatisflex.loveqq.test.model;
+
+import com.mybatisflex.annotation.Column;
+import com.mybatisflex.annotation.Id;
+import com.mybatisflex.annotation.Table;
+
+import java.util.List;
+import java.util.Objects;
+
+/**
+ * 角色。
+ *
+ * @author 王帅
+ * @since 2023-06-07
+ */
+@Table("tb_role")
+public class Role implements Comparable {
+
+ @Id
+ private Integer roleId;
+ private String roleKey;
+ private String roleName;
+
+ @Column(ignore = true)
+ private List userVOS;
+
+ public Integer getRoleId() {
+ return roleId;
+ }
+
+ public void setRoleId(Integer roleId) {
+ this.roleId = roleId;
+ }
+
+ public String getRoleKey() {
+ return roleKey;
+ }
+
+ public void setRoleKey(String roleKey) {
+ this.roleKey = roleKey;
+ }
+
+ public String getRoleName() {
+ return roleName;
+ }
+
+ public void setRoleName(String roleName) {
+ this.roleName = roleName;
+ }
+
+ public List getUserVOS() {
+ return userVOS;
+ }
+
+ public void setUserVOS(List userVOS) {
+ this.userVOS = userVOS;
+ }
+
+ @Override
+ public String toString() {
+ return "Role{" +
+ "roleId=" + roleId +
+ ", roleKey='" + roleKey + '\'' +
+ ", roleName='" + roleName + '\'' +
+ '}';
+ }
+
+ @Override
+ public int compareTo(Role o) {
+ return Integer.compare(this.roleId, o.roleId);
+ }
+
+ @Override
+ public boolean equals(Object o) {
+ if (this == o) {
+ return true;
+ }
+ if (o == null || getClass() != o.getClass()) {
+ return false;
+ }
+
+ Role role = (Role) o;
+
+ if (!Objects.equals(roleId, role.roleId)) {
+ return false;
+ }
+ if (!Objects.equals(roleKey, role.roleKey)) {
+ return false;
+ }
+ if (!Objects.equals(roleName, role.roleName)) {
+ return false;
+ }
+ return Objects.equals(userVOS, role.userVOS);
+ }
+
+ @Override
+ public int hashCode() {
+ int result = roleId != null ? roleId.hashCode() : 0;
+ result = 31 * result + (roleKey != null ? roleKey.hashCode() : 0);
+ result = 31 * result + (roleName != null ? roleName.hashCode() : 0);
+ result = 31 * result + (userVOS != null ? userVOS.hashCode() : 0);
+ return result;
+ }
+
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/RoleKey.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/RoleKey.java
new file mode 100644
index 00000000..c898a278
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/RoleKey.java
@@ -0,0 +1,40 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.mybatisflex.loveqq.test.model;
+
+/**
+ * @author 王帅
+ * @since 2023-06-15
+ */
+public class RoleKey {
+
+ private T roleKey;
+
+ public T getRoleKey() {
+ return roleKey;
+ }
+
+ public void setRoleKey(T roleKey) {
+ this.roleKey = roleKey;
+ }
+
+ @Override
+ public String toString() {
+ return roleKey.toString();
+ }
+
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/RoleVO1.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/RoleVO1.java
new file mode 100644
index 00000000..6e02805a
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/RoleVO1.java
@@ -0,0 +1,74 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.mybatisflex.loveqq.test.model;
+
+/**
+ * 角色。
+ *
+ * @author 王帅
+ * @since 2023-06-13
+ */
+public class RoleVO1 {
+
+ private Integer roleId;
+ private String roleKey;
+ private String roleName;
+ private UserVO1 user;
+
+ public Integer getRoleId() {
+ return roleId;
+ }
+
+ public void setRoleId(Integer roleId) {
+ this.roleId = roleId;
+ }
+
+ public String getRoleKey() {
+ return roleKey;
+ }
+
+ public void setRoleKey(String roleKey) {
+ this.roleKey = roleKey;
+ }
+
+ public String getRoleName() {
+ return roleName;
+ }
+
+ public void setRoleName(String roleName) {
+ this.roleName = roleName;
+ }
+
+ public UserVO1 getUser() {
+ return user;
+ }
+
+ public void setUser(UserVO1 user) {
+ this.user = user;
+ }
+
+ @Override
+ public String toString() {
+ return "Role{" +
+ "roleId=" + roleId +
+ ", roleKey='" + roleKey + '\'' +
+ ", roleName='" + roleName + '\'' +
+ ", userVO1='" + user + '\'' +
+ '}';
+ }
+
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/RoleVO2.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/RoleVO2.java
new file mode 100644
index 00000000..b4d12c37
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/RoleVO2.java
@@ -0,0 +1,52 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.mybatisflex.loveqq.test.model;
+
+/**
+ * @author 王帅
+ * @since 2023-06-15
+ */
+public class RoleVO2 {
+
+ private T roleName;
+ private RoleKey roleKey;
+
+ public T getRoleName() {
+ return roleName;
+ }
+
+ public void setRoleName(T roleName) {
+ this.roleName = roleName;
+ }
+
+ public RoleKey getRoleKey() {
+ return roleKey;
+ }
+
+ public void setRoleKey(RoleKey roleKey) {
+ this.roleKey = roleKey;
+ }
+
+ @Override
+ public String toString() {
+ return "RoleName{" +
+ "roleName=" + roleName +
+ ", roleKey=" + roleKey +
+ '}';
+ }
+
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/RoleVO3.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/RoleVO3.java
new file mode 100644
index 00000000..3a1f67f0
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/RoleVO3.java
@@ -0,0 +1,62 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.mybatisflex.loveqq.test.model;
+
+/**
+ * @author 王帅
+ * @since 2023-06-15
+ */
+public class RoleVO3 {
+
+ private Integer roleId;
+ private String roleKey;
+ private String userName;
+
+ public Integer getRoleId() {
+ return roleId;
+ }
+
+ public void setRoleId(Integer roleId) {
+ this.roleId = roleId;
+ }
+
+ public String getRoleKey() {
+ return roleKey;
+ }
+
+ public void setRoleKey(String roleKey) {
+ this.roleKey = roleKey;
+ }
+
+ public String getUserName() {
+ return userName;
+ }
+
+ public void setUserName(String userName) {
+ this.userName = userName;
+ }
+
+ @Override
+ public String toString() {
+ return "RoleVO3{" +
+ "roleId=" + roleId +
+ ", roleKey='" + roleKey + '\'' +
+ ", roleName='" + userName + '\'' +
+ '}';
+ }
+
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/Tag.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/Tag.java
new file mode 100644
index 00000000..ba16d2cc
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/Tag.java
@@ -0,0 +1,44 @@
+package com.mybatisflex.loveqq.test.model;
+
+import com.mybatisflex.annotation.Id;
+import com.mybatisflex.annotation.Table;
+
+import java.io.Serializable;
+
+/**
+ * 标签
+ *
+ * @author Ice 2023/09/26
+ * @version 1.0
+ */
+@Table(value = "tb_tag")
+public class Tag implements Serializable {
+ private static final long serialVersionUID = 5600670055904157386L;
+
+ /**
+ * ID
+ */
+ @Id
+ private Integer tagId;
+
+ /**
+ * 标签名称
+ */
+ private String name;
+
+ public Integer getTagId() {
+ return tagId;
+ }
+
+ public void setTagId(Integer tagId) {
+ this.tagId = tagId;
+ }
+
+ public String getName() {
+ return name;
+ }
+
+ public void setName(String name) {
+ this.name = name;
+ }
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/TbClass.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/TbClass.java
new file mode 100644
index 00000000..23c850ad
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/TbClass.java
@@ -0,0 +1,47 @@
+package com.mybatisflex.loveqq.test.model;
+
+import com.mybatisflex.annotation.Id;
+import com.mybatisflex.annotation.Table;
+
+@Table(value = "tb_class")
+public class TbClass {
+ @Id
+ private Long id;
+
+ private Long user_id;
+
+ private String className;
+
+ public Long getId() {
+ return id;
+ }
+
+ public Long getUser_id() {
+ return user_id;
+ }
+
+ public String getClassName() {
+ return className;
+ }
+
+ public void setId(Long id) {
+ this.id = id;
+ }
+
+ public void setUser_id(Long user_id) {
+ this.user_id = user_id;
+ }
+
+ public void setClassName(String className) {
+ this.className = className;
+ }
+
+ @Override
+ public String toString() {
+ return "TbClass{" +
+ "id=" + id +
+ ", user_id=" + user_id +
+ ", className='" + className + '\'' +
+ '}';
+ }
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/UnmappedBaseEntity.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/UnmappedBaseEntity.java
new file mode 100644
index 00000000..5608f80f
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/UnmappedBaseEntity.java
@@ -0,0 +1,35 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package com.mybatisflex.loveqq.test.model;
+
+import lombok.Getter;
+import lombok.Setter;
+
+import java.util.Map;
+
+/**
+ * UnMappedBaseEntity
+ *
+ * @author wy
+ * @version 1.0
+ * @date 2024/9/12 11:36
+ **/
+@Getter
+@Setter
+public class UnmappedBaseEntity {
+
+ protected Map unmappedMap;
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/UnmappedUser.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/UnmappedUser.java
new file mode 100644
index 00000000..89b8b2f6
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/UnmappedUser.java
@@ -0,0 +1,53 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package com.mybatisflex.loveqq.test.model;
+
+import com.mybatisflex.annotation.Id;
+import com.mybatisflex.annotation.KeyType;
+import com.mybatisflex.annotation.Table;
+import lombok.Getter;
+import lombok.Setter;
+import org.springframework.util.CollectionUtils;
+
+/**
+ * UnMapped
+ *
+ * @author wy
+ * @version 1.0
+ * @date 2024/9/12 11:28
+ **/
+@Getter
+@Setter
+@Table("tb_unmapped_user")
+public class UnmappedUser extends UnmappedBaseEntity {
+
+ @Id(keyType = KeyType.Auto)
+ private Long id;
+
+ private Integer age;
+
+ private String name;
+
+ @Override
+ public String toString() {
+ return "UnmappedUser{" +
+ "id='" + id + '\'' +
+ ", name='" + name + '\'' +
+ ", age=" + age +
+ (CollectionUtils.isEmpty(unmappedMap) ? "" : ", unmappedMap=" + unmappedMap.toString())
+ + '}';
+ }
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/User.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/User.java
new file mode 100644
index 00000000..3e3ef1f8
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/User.java
@@ -0,0 +1,96 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.mybatisflex.loveqq.test.model;
+
+import com.mybatisflex.annotation.Id;
+import com.mybatisflex.annotation.RelationManyToMany;
+import com.mybatisflex.annotation.Table;
+import com.mybatisflex.core.activerecord.Model;
+
+import java.util.List;
+
+/**
+ * 用户。
+ *
+ * @author 王帅
+ * @since 2023-06-07
+ */
+
+@Table("tb_user")
+public class User extends Model {
+
+ @Id
+ private Integer userId;
+ private String userName;
+ private String password;
+
+ @RelationManyToMany(
+ selfField = "userId",
+ targetField = "roleId",
+ joinTable = "tb_user_role",
+ joinSelfColumn = "user_id",
+ joinTargetColumn = "role_id"
+ )
+ private List roleList;
+
+ public static User create() {
+ return new User();
+ }
+
+ public Integer getUserId() {
+ return userId;
+ }
+
+ public void setUserId(Integer userId) {
+ this.userId = userId;
+ }
+
+ public String getUserName() {
+ return userName;
+ }
+
+ public void setUserName(String userName) {
+ this.userName = userName;
+ }
+
+ public String getPassword() {
+ return password;
+ }
+
+ public void setPassword(String password) {
+ this.password = password;
+ }
+
+ public List getRoleList() {
+ return roleList;
+ }
+
+ public void setRoleList(List roleList) {
+ this.roleList = roleList;
+ }
+
+ @Override
+ public String toString() {
+ return "User{" +
+ "userId=" + userId +
+ ", userName='" + userName + '\'' +
+ ", password='" + password + '\'' +
+ ", roleList=" + roleList +
+ '}';
+ }
+
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/UserInfo.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/UserInfo.java
new file mode 100644
index 00000000..b8e9d321
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/UserInfo.java
@@ -0,0 +1,115 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.mybatisflex.loveqq.test.model;
+
+import com.mybatisflex.annotation.RelationManyToMany;
+
+import java.util.List;
+
+/**
+ * 用户信息。
+ *
+ * @author 王帅
+ * @since 2023-06-07
+ */
+public class UserInfo {
+
+ private Integer userId;
+ private String userName;
+ private String password;
+ private String idNumber;
+
+ @RelationManyToMany(
+ selfField = "userId",
+ targetField = "roleId",
+ joinTable = "tb_user_role",
+ joinSelfColumn = "user_id",
+ joinTargetColumn = "role_id"
+ )
+ private List roleList;
+
+ @RelationManyToMany(
+ selfField = "userId",
+ targetField = "orderId",
+ targetTable = "tb_order",
+ joinTable = "tb_user_order",
+ joinSelfColumn = "user_id",
+ joinTargetColumn = "order_id"
+ )
+ private List orderInfoList;
+
+ public Integer getUserId() {
+ return userId;
+ }
+
+ public void setUserId(Integer userId) {
+ this.userId = userId;
+ }
+
+ public String getUserName() {
+ return userName;
+ }
+
+ public void setUserName(String userName) {
+ this.userName = userName;
+ }
+
+ public String getPassword() {
+ return password;
+ }
+
+ public void setPassword(String password) {
+ this.password = password;
+ }
+
+ public String getIdNumber() {
+ return idNumber;
+ }
+
+ public void setIdNumber(String idNumber) {
+ this.idNumber = idNumber;
+ }
+
+ public List getRoleList() {
+ return roleList;
+ }
+
+ public void setRoleList(List roleList) {
+ this.roleList = roleList;
+ }
+
+ public List getOrderInfoList() {
+ return orderInfoList;
+ }
+
+ public void setOrderInfoList(List orderInfoList) {
+ this.orderInfoList = orderInfoList;
+ }
+
+ @Override
+ public String toString() {
+ return "UserInfo{" +
+ "userId=" + userId +
+ ", userName='" + userName + '\'' +
+ ", password='" + password + '\'' +
+ ", idNumber='" + idNumber + '\'' +
+ ", roleList=" + roleList +
+ ", orderInfoList=" + orderInfoList +
+ '}';
+ }
+
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/UserOrder.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/UserOrder.java
new file mode 100644
index 00000000..f570898b
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/UserOrder.java
@@ -0,0 +1,49 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.mybatisflex.loveqq.test.model;
+
+import com.mybatisflex.annotation.Table;
+
+/**
+ * 用户订单映射。
+ *
+ * @author 王帅
+ * @since 2023-06-07
+ */
+@Table("tb_user_order")
+public class UserOrder {
+
+ private Integer userId;
+ private Integer orderId;
+
+ public Integer getUserId() {
+ return userId;
+ }
+
+ public void setUserId(Integer userId) {
+ this.userId = userId;
+ }
+
+ public Integer getOrderId() {
+ return orderId;
+ }
+
+ public void setOrderId(Integer orderId) {
+ this.orderId = orderId;
+ }
+
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/UserRole.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/UserRole.java
new file mode 100644
index 00000000..5f2b0e78
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/UserRole.java
@@ -0,0 +1,49 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.mybatisflex.loveqq.test.model;
+
+import com.mybatisflex.annotation.Table;
+
+/**
+ * 用户与角色连接表。
+ *
+ * @author 王帅
+ * @since 2023-06-07
+ */
+@Table("tb_user_role")
+public class UserRole {
+
+ private Integer userId;
+ private Integer roleId;
+
+ public Integer getUserId() {
+ return userId;
+ }
+
+ public void setUserId(Integer userId) {
+ this.userId = userId;
+ }
+
+ public Integer getRoleId() {
+ return roleId;
+ }
+
+ public void setRoleId(Integer roleId) {
+ this.roleId = roleId;
+ }
+
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/UserVO.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/UserVO.java
new file mode 100644
index 00000000..61106bab
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/UserVO.java
@@ -0,0 +1,70 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.mybatisflex.loveqq.test.model;
+
+import java.util.HashMap;
+import java.util.Map;
+
+/**
+ * 用户 VO 对象。
+ *
+ * @author 王帅
+ * @since 2023-06-07
+ */
+
+public class UserVO {
+
+ private String userId;
+ private String userName;
+ // private TreeSet roleList;
+// private Role[] roleList;
+ private HashMap roleList;
+
+ public String getUserId() {
+ return userId;
+ }
+
+ public void setUserId(String userId) {
+ this.userId = userId;
+ }
+
+ public String getUserName() {
+ return userName;
+ }
+
+ public void setUserName(String userName) {
+ this.userName = userName;
+ }
+
+ public Map getRoleList() {
+ return roleList;
+ }
+
+ public void setRoleList(HashMap roleList) {
+ this.roleList = roleList;
+ }
+
+ @Override
+ public String toString() {
+ return "UserVO{" +
+ "userId='" + userId + '\'' +
+ ", userName='" + userName + '\'' +
+ ", roleList=" + roleList +
+ '}';
+ }
+
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/UserVO1.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/UserVO1.java
new file mode 100644
index 00000000..a571acc3
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/UserVO1.java
@@ -0,0 +1,62 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.mybatisflex.loveqq.test.model;
+
+/**
+ * @author 王帅
+ * @since 2023-06-07
+ */
+public class UserVO1 {
+
+ private String userId;
+ private String userName;
+ private RoleVO1 role;
+
+ public String getUserId() {
+ return userId;
+ }
+
+ public void setUserId(String userId) {
+ this.userId = userId;
+ }
+
+ public String getUserName() {
+ return userName;
+ }
+
+ public void setUserName(String userName) {
+ this.userName = userName;
+ }
+
+ public RoleVO1 getRole() {
+ return role;
+ }
+
+ public void setRole(RoleVO1 role) {
+ this.role = role;
+ }
+
+ @Override
+ public String toString() {
+ return "UserVO1{" +
+ "userId='" + userId + '\'' +
+ ", userName='" + userName + '\'' +
+ ", roleVO1=" + role +
+ '}';
+ }
+
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/UserVO2.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/UserVO2.java
new file mode 100644
index 00000000..db46c857
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/UserVO2.java
@@ -0,0 +1,75 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.mybatisflex.loveqq.test.model;
+
+import java.util.List;
+
+/**
+ * @author 王帅
+ * @since 2023-06-07
+ */
+
+public class UserVO2 {
+
+ private String userId;
+ private String userName;
+ private List roles;
+ private List roleIds;
+
+ public String getUserId() {
+ return userId;
+ }
+
+ public void setUserId(String userId) {
+ this.userId = userId;
+ }
+
+ public String getUserName() {
+ return userName;
+ }
+
+ public void setUserName(String userName) {
+ this.userName = userName;
+ }
+
+ public List getRoles() {
+ return roles;
+ }
+
+ public void setRoles(List roles) {
+ this.roles = roles;
+ }
+
+ public List getRoleIds() {
+ return roleIds;
+ }
+
+ public void setRoleIds(List roleIds) {
+ this.roleIds = roleIds;
+ }
+
+ @Override
+ public String toString() {
+ return "UserVO2{" +
+ "userId='" + userId + '\'' +
+ ", userName='" + userName + '\'' +
+ ", roles=" + roles +
+ ", roleIds=" + roleIds +
+ '}';
+ }
+
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/UserVO3.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/UserVO3.java
new file mode 100644
index 00000000..fc076fd4
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/UserVO3.java
@@ -0,0 +1,68 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.mybatisflex.loveqq.test.model;
+
+import com.mybatisflex.annotation.Id;
+
+import java.util.List;
+
+/**
+ * @author 王帅
+ * @since 2023-06-07
+ */
+
+public class UserVO3 {
+
+ @Id
+ private String userId;
+ private String userName;
+ private List roleVO3;
+
+ public String getUserId() {
+ return userId;
+ }
+
+ public void setUserId(String userId) {
+ this.userId = userId;
+ }
+
+ public String getUserName() {
+ return userName;
+ }
+
+ public void setUserName(String userName) {
+ this.userName = userName;
+ }
+
+ public List getRoleVO3() {
+ return roleVO3;
+ }
+
+ public void setRoleVO3(List roleVO3) {
+ this.roleVO3 = roleVO3;
+ }
+
+ @Override
+ public String toString() {
+ return "UserVO3{" +
+ "userId='" + userId + '\'' +
+ ", userName='" + userName + '\'' +
+ ", roleVO3=" + roleVO3 +
+ '}';
+ }
+
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/UserVO4.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/UserVO4.java
new file mode 100644
index 00000000..d365cbc0
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/model/UserVO4.java
@@ -0,0 +1,56 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.mybatisflex.loveqq.test.service;
+
+import com.kfyty.loveqq.framework.core.autoconfig.annotation.Service;
+import com.mybatisflex.loveqq.test.mapper.AccountMapper;
+import com.mybatisflex.loveqq.test.model.Account;
+import org.springframework.transaction.annotation.Transactional;
+
+import javax.annotation.Resource;
+import java.util.concurrent.TimeUnit;
+
+@Service
+public class AccountService {
+
+
+ @Resource
+ AccountMapper accountMapper;
+
+
+ @Transactional
+ public void update2() {
+ int x = 1 / 0;
+ Account account = new Account();
+ account.setId(2L);
+ account.setUserName("haha");
+ accountMapper.update(account);
+ }
+
+ @Transactional(rollbackFor = Exception.class, timeout = 3)
+ public void transactionTimeTest() throws InterruptedException {
+ Account account = new Account();
+ account.setId(100L);
+ account.setUserName("aliothmoon");
+ accountMapper.insert(account);
+ TimeUnit.SECONDS.sleep(5);
+ accountMapper.selectOneById(account.getId());
+ }
+
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/service/ArticleService.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/service/ArticleService.java
new file mode 100644
index 00000000..8c32d7fb
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/service/ArticleService.java
@@ -0,0 +1,30 @@
+/*
+ * Copyright (c) 2022-2024, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.mybatisflex.loveqq.test.service;
+
+import com.mybatisflex.core.service.IService;
+import com.mybatisflex.loveqq.test.model.Article;
+
+/**
+ * @author 王帅
+ * @since 2023-07-22
+ */
+public interface ArticleService extends IService {
+
+ void changeDataSource();
+
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/service/impl/ArticleServiceImpl.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/service/impl/ArticleServiceImpl.java
new file mode 100644
index 00000000..6126c8ec
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/service/impl/ArticleServiceImpl.java
@@ -0,0 +1,52 @@
+/*
+ * Copyright (c) 2022-2024, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.mybatisflex.loveqq.test.service.impl;
+
+import com.kfyty.loveqq.framework.core.autoconfig.annotation.Service;
+import com.mybatisflex.annotation.UseDataSource;
+import com.mybatisflex.core.datasource.DataSourceKey;
+import com.mybatisflex.loveqq.framework.boot.autoconfig.service.ServiceImpl;
+import com.mybatisflex.loveqq.test.mapper.ArticleMapper;
+import com.mybatisflex.loveqq.test.model.Article;
+import com.mybatisflex.loveqq.test.service.ArticleService;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+/**
+ * @author 王帅
+ * @since 2023-07-22
+ */
+@Service
+public class ArticleServiceImpl extends ServiceImpl implements ArticleService {
+
+ private static final Logger LOGGER = LoggerFactory.getLogger(ArticleServiceImpl.class);
+
+ @Override
+ @UseDataSource("annotation ds")
+ public void changeDataSource() {
+ LOGGER.info("start1: {}", DataSourceKey.get());
+ DataSourceKey.use("ds outer", () -> {
+ LOGGER.info("start2: {}", DataSourceKey.get());
+ DataSourceKey.use("ds inner", () -> {
+ LOGGER.info("start3: {}", DataSourceKey.get());
+ LOGGER.info("end3: {}", DataSourceKey.get());
+ });
+ LOGGER.info("end2: {}", DataSourceKey.get());
+ });
+ LOGGER.info("end1: {}", DataSourceKey.get());
+ }
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/unmapped/MyUnMappedColumnHandler.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/unmapped/MyUnMappedColumnHandler.java
new file mode 100644
index 00000000..a523ba74
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/main/java/com/mybatisflex/loveqq/test/unmapped/MyUnMappedColumnHandler.java
@@ -0,0 +1,46 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.mybatisflex.loveqq.test.common;
+
+import com.mybatisflex.core.query.QueryWrapper;
+import com.mybatisflex.core.util.MapperUtil;
+import org.junit.jupiter.api.Test;
+
+import static com.mybatisflex.loveqq.test.model.table.RoleTableDef.ROLE;
+import static com.mybatisflex.loveqq.test.model.table.UserRoleTableDef.USER_ROLE;
+import static com.mybatisflex.loveqq.test.model.table.UserTableDef.USER;
+
+/**
+ * @author 王帅
+ * @since 2023-06-09
+ */
+class MapperUtilTest {
+
+ @Test
+ void testOptimizeCountQueryWrapper() {
+ QueryWrapper queryWrapper = QueryWrapper.create()
+ .select(USER.USER_ID, USER.USER_NAME, ROLE.ALL_COLUMNS)
+ .from(USER.as("u"))
+ .leftJoin(USER_ROLE).as("ur").on(USER_ROLE.USER_ID.eq(USER.USER_ID))
+ .leftJoin(ROLE).as("r").on(USER_ROLE.ROLE_ID.eq(ROLE.ROLE_ID))
+ .where(USER.USER_ID.eq(3))
+ .and(USER_ROLE.ROLE_ID.eq(6))
+ .groupBy(ROLE.ROLE_ID);
+ System.out.println(queryWrapper.toSQL());
+ System.out.println(MapperUtil.rawCountQueryWrapper(queryWrapper).toSQL());
+ System.out.println(MapperUtil.optimizeCountQueryWrapper(queryWrapper).toSQL());
+ }
+
+ /**
+ * 测试 (sql1) union (sql2)
+ */
+ @Test
+ void testOptimizeCountQueryWrapperOfUnion1() {
+ //简单union
+ //SELECT `user_id`, `user_name` FROM `tb_user` WHERE `user_id` = 1 order by user_id desc
+ QueryWrapper union1 = QueryWrapper.create().select(USER.USER_ID, USER.USER_NAME).from(USER).where(USER.USER_ID.eq(1)).orderBy(USER.USER_ID.desc());
+ //SELECT `user_id`, `user_name` FROM `tb_user` WHERE `user_name` LIKE '%test%'
+ QueryWrapper union2 = QueryWrapper.create().select(USER.USER_ID, USER.USER_NAME).from(USER).where(USER.USER_NAME.like("test"));
+
+ QueryWrapper query1 = union1.union(union2);
+
+ String sql = MapperUtil.optimizeCountQueryWrapper(query1).toSQL();
+ //SELECT COUNT(*) AS `total` FROM ((SELECT `user_id`, `user_name` FROM `tb_user` WHERE `user_id` = 1) UNION (SELECT `user_id`, `user_name` FROM `tb_user` WHERE `user_name` LIKE '%test%')) AS `t`
+ System.out.println(sql);
+ }
+
+ /**
+ * 测试 (sql1 ) union (sql2 with group by)
+ */
+ @Test
+ void testOptimizeCountQueryWrapperOfUnion2() {
+ //with group by union
+ //SELECT `user_id`, `user_name` FROM `tb_user` WHERE `user_id` = 1 order by user_id desc
+ QueryWrapper union1 = QueryWrapper.create().select(USER.USER_ID, USER.USER_NAME).from(USER).where(USER.USER_ID.eq(1)).orderBy(USER.USER_ID.desc());
+ //SELECT `user_id`, `user_name` FROM `tb_user` WHERE `user_name` LIKE '%test%' group by user_id, user_name
+ QueryWrapper union2 = QueryWrapper.create().select(USER.USER_ID, USER.USER_NAME).from(USER).where(USER.USER_NAME.like("test")).groupBy(USER.USER_ID, USER.USER_NAME);
+
+ QueryWrapper query1 = union1.union(union2);
+
+ //SELECT COUNT(*) AS `total` FROM ((SELECT `user_id`, `user_name` FROM `tb_user` WHERE `user_id` = 1) UNION (SELECT `user_id`, `user_name` FROM `tb_user` WHERE `user_name` LIKE '%test%' GROUP BY `user_id`, `user_name`)) AS `t`
+ String sql = MapperUtil.optimizeCountQueryWrapper(query1).toSQL();
+ System.out.println(sql);
+ }
+
+ /**
+ * 测试 (sql1) union (sql2 union sql3)
+ */
+ @Test
+ void testOptimizeCountQueryWrapperOfUnion3() {
+ //with sub query union
+ //SELECT `user_id`, `user_name` FROM `tb_user` WHERE `user_id` = 1 order by user_id desc
+ QueryWrapper union1 = QueryWrapper.create().select(USER.USER_ID, USER.USER_NAME).from(USER).where(USER.USER_ID.eq(1)).orderBy(USER.USER_ID.desc());
+ //SELECT `user_id`, `user_name` FROM `tb_user` WHERE `user_name` LIKE '%test%' group by user_id, user_name
+ QueryWrapper union2 = QueryWrapper.create().select(USER.USER_ID, USER.USER_NAME).from(USER).where(USER.USER_NAME.like("test")).orderBy(USER.USER_NAME.desc());
+
+ QueryWrapper union3 = QueryWrapper.create().select(USER.USER_ID, USER.USER_NAME).from(USER).where(USER.PASSWORD.isNull()).orderBy(USER.USER_NAME.desc());
+
+
+ QueryWrapper query1 = union1.union(union2.union(union3));
+
+ //SELECT COUNT(*) AS `total` FROM ((SELECT `user_id`, `user_name` FROM `tb_user` WHERE `user_id` = 1) UNION ((SELECT `user_id`, `user_name` FROM `tb_user` WHERE `user_name` LIKE '%test%') UNION (SELECT `user_id`, `user_name` FROM `tb_user` WHERE `password` IS NULL ))) AS `t`
+ String sql = MapperUtil.optimizeCountQueryWrapper(query1).toSQL();
+
+ System.out.println(sql);
+ }
+
+ @Test
+ void testOptimizeCountQueryWrapperOfUnion4() {
+ //with sub query union
+ //SELECT `user_id`, `user_name` FROM `tb_user` WHERE `user_id` = 1 order by user_id desc
+ QueryWrapper union1 = QueryWrapper.create().select(USER.USER_ID, USER.USER_NAME).from(USER).where(USER.USER_ID.eq(1)).orderBy(USER.USER_ID.desc());
+ //SELECT `user_id`, `user_name` FROM `tb_user` WHERE `user_name` LIKE '%test%' group by user_id, user_name
+ QueryWrapper union2 = QueryWrapper.create().select(USER.USER_ID, USER.USER_NAME).from(USER).where(USER.USER_NAME.like("test")).orderBy(USER.USER_NAME.desc());
+
+ QueryWrapper union3 = QueryWrapper.create().from(union2).as("a");
+
+
+ QueryWrapper query1 = union1.union(union3);
+
+ //SELECT COUNT(*) AS `total` FROM ((SELECT `user_id`, `user_name` FROM `tb_user` WHERE `user_id` = 1) UNION ((SELECT `user_id`, `user_name` FROM `tb_user` WHERE `user_name` LIKE '%test%') UNION (SELECT `user_id`, `user_name` FROM `tb_user` WHERE `password` IS NULL ))) AS `t`
+ String sql = MapperUtil.optimizeCountQueryWrapper(query1).toSQL();
+
+ System.out.println(sql);
+ }
+
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/test/java/com/mybatisflex/loveqq/test/common/QueryWrapperTest.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/test/java/com/mybatisflex/loveqq/test/common/QueryWrapperTest.java
new file mode 100644
index 00000000..effecd5e
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/test/java/com/mybatisflex/loveqq/test/common/QueryWrapperTest.java
@@ -0,0 +1,202 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.mybatisflex.loveqq.test.common;
+
+import com.mybatisflex.core.util.ClassUtil;
+import com.mybatisflex.loveqq.test.model.Account;
+import org.apache.ibatis.reflection.TypeParameterResolver;
+import org.junit.jupiter.api.Test;
+
+import java.lang.reflect.Field;
+import java.lang.reflect.Type;
+import java.util.List;
+
+/**
+ * @author 王帅
+ * @since 2023-06-14
+ */
+class ReflectTest {
+
+ @Test
+ void test() {
+ List allFields = ClassUtil.getAllFields(Account.class);
+ for (Field field : allFields) {
+ Type type = TypeParameterResolver.resolveFieldType(field, Account.class);
+ System.out.println("field: " + field + "----->Type:" + type);
+ }
+
+ }
+
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/test/java/com/mybatisflex/loveqq/test/common/SerialUtil.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/test/java/com/mybatisflex/loveqq/test/common/SerialUtil.java
new file mode 100644
index 00000000..e19519a1
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/test/java/com/mybatisflex/loveqq/test/common/SerialUtil.java
@@ -0,0 +1,105 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.mybatisflex.loveqq.test.common;
+
+import com.alibaba.fastjson2.JSON;
+import com.alibaba.fastjson2.JSONReader;
+import com.alibaba.fastjson2.JSONWriter;
+import com.fasterxml.jackson.annotation.JsonAutoDetect;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.PropertyAccessor;
+import com.fasterxml.jackson.databind.ObjectMapper;
+import com.mybatisflex.core.query.QueryCondition;
+
+import java.io.ByteArrayInputStream;
+import java.io.ByteArrayOutputStream;
+import java.io.IOException;
+import java.io.ObjectInputStream;
+import java.io.ObjectOutputStream;
+
+/**
+ * 序列化工具类。
+ *
+ * @author 王帅
+ * @since 2023-06-10
+ */
+public class SerialUtil {
+
+ public static byte[] writeObject(Object obj) {
+ try (ByteArrayOutputStream bos = new ByteArrayOutputStream();
+ ObjectOutputStream oos = new ObjectOutputStream(bos)) {
+ oos.writeObject(obj);
+ oos.flush();
+ return bos.toByteArray();
+ } catch (IOException e) {
+ return new byte[0];
+ }
+ }
+
+ public static Object readObject(byte[] bytes) {
+ try (ByteArrayInputStream bis = new ByteArrayInputStream(bytes);
+ ObjectInputStream ois = new ObjectInputStream(bis)) {
+ return ois.readObject();
+ } catch (IOException | ClassNotFoundException e) {
+ return null;
+ }
+ }
+
+ public static T cloneObject(Object obj) {
+ //noinspection unchecked
+ return (T) readObject(writeObject(obj));
+ }
+
+ public static String toJSONString(Object obj) {
+ return JSON.toJSONString(obj, JSONWriter.Feature.FieldBased,
+ JSONWriter.Feature.WriteClassName,
+ JSONWriter.Feature.NotWriteRootClassName,
+ JSONWriter.Feature.ReferenceDetection);
+ }
+
+ public static T parseObject(String str, Class tClass) {
+ return JSON.parseObject(str, tClass, JSONReader.Feature.FieldBased,
+ JSONReader.Feature.SupportClassForName);
+ }
+
+ public static T cloneObject(Object obj, Class tClass) {
+ return parseObject(toJSONString(obj), tClass);
+ }
+
+
+ /**
+ * 使用jackson对QueryWrapper进行序列化反序列化操作，需要注意QueryCondition的protected属性以及prev和next的递归问题。
+ *
+ * @return Jackson序列化映射
+ */
+ public static ObjectMapper jacksonMapper(){
+ ObjectMapper mapper = new ObjectMapper();
+ // 为了将QueryWrapper里的protected属性可见
+ mapper.setVisibility(PropertyAccessor.FIELD, JsonAutoDetect.Visibility.PROTECTED_AND_PUBLIC);
+ // 避免QueryCondition里的prev和next在序列化时出现递归调用错误
+ mapper.addMixIn(QueryCondition.class,QueryConditionMixIn.class);
+ return mapper;
+ }
+
+ /**
+ * 因无法修改QueryCondition而添加的映射属性包装
+ */
+ class QueryConditionMixIn{
+ @JsonProperty(access = JsonProperty.Access.WRITE_ONLY)
+ protected QueryCondition prev;
+ }
+}
diff --git a/mybatis-flex-test/mybatis-flex-loveqq-test/src/test/java/com/mybatisflex/loveqq/test/mapper/AccountMapperTest.java b/mybatis-flex-test/mybatis-flex-loveqq-test/src/test/java/com/mybatisflex/loveqq/test/mapper/AccountMapperTest.java
new file mode 100644
index 00000000..72331295
--- /dev/null
+++ b/mybatis-flex-test/mybatis-flex-loveqq-test/src/test/java/com/mybatisflex/loveqq/test/mapper/AccountMapperTest.java
@@ -0,0 +1,232 @@
+/*
+ * Copyright (c) 2022-2025, Mybatis-Flex (fuhai999@gmail.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *