mirror of
https://gitee.com/mybatis-flex/mybatis-flex.git
synced 2025-12-07 00:58:24 +08:00
142 lines
3.7 KiB
Markdown
142 lines
3.7 KiB
Markdown
# 配置选项
|
||
|
||
在使用 MyBatis-Flex 中，可能需要进行一些个性化配置，其中也包括 MyBatis 原生的配置。
|
||
|
||
## 使用配置
|
||
|
||
### 原生方式：
|
||
|
||
```java
|
||
FlexGlobalConfig defaultConfig = FlexGlobalConfig.getDefaultConfig();
|
||
// defaultConfig.setXxx(...);
|
||
```
|
||
|
||
### Spring MVC
|
||
|
||
同原生配置
|
||
|
||
### Spring Boot
|
||
|
||
```yaml
|
||
mybatis-flex:
|
||
#......
|
||
configuration:
|
||
#......
|
||
global-config:
|
||
#......
|
||
```
|
||
|
||
## mybatis-flex
|
||
|
||
### datasource
|
||
|
||
- 类型：`Map<String, Map<String, String>>`
|
||
- 默认值：`null`
|
||
|
||
MyBatis-Flex 多数据源配置，参考 [多数据源配置](../core/multi-datasource.md#更多的-spring-yaml-配置支持)。
|
||
|
||
### config-location
|
||
|
||
- 类型：`String`
|
||
- 默认值：`null`
|
||
|
||
MyBatis 配置文件位置，如果有单独的 MyBatis 配置，需要将其路径配置到 `configLocation` 中。MyBatis Configuration
|
||
的具体内容请参考 [MyBatis 官方文档](https://www.mybatis.org/mybatis-3/zh/configuration.html)。
|
||
|
||
### mapper-locations
|
||
|
||
- 类型：`String[]`
|
||
- 默认值：`["classpath*:/mapper/**/*.xml"]`
|
||
|
||
MyBatis Mapper 所对应的 XML 文件位置，如果在 Mapper 中有自定义的方法（XML 中有自定义的实现），需要进行该配置，指定 Mapper
|
||
所对应的 XML 文件位置。
|
||
|
||
### type-aliases-package
|
||
|
||
- 类型：`String`
|
||
- 默认值：`null`
|
||
|
||
MyBaits 别名包扫描路径，通过该属性可以给包中的类注册别名，注册后在 Mapper 对应的 XML 文件中可以直接使用类名，而不用使用全限定的类名（即
|
||
XML 中调用的时候不用包含包名）。
|
||
|
||
### type-aliases-super-type
|
||
|
||
- 类型：`Class<?>`
|
||
- 默认值：`null`
|
||
|
||
该配置请和 [typeAliasesPackage](#typealiasespackage) 一起使用，如果配置了该属性，则仅仅会扫描路径下以该类作为父类的域对象。
|
||
|
||
### type-handlers-package
|
||
|
||
- 类型：`String`
|
||
- 默认值：`null`
|
||
|
||
TypeHandler 扫描路径，如果配置了该属性，SqlSessionFactoryBean 会把该包下面的类注册为对应的 TypeHandler 处理器。
|
||
|
||
### check-config-location
|
||
|
||
- 类型：`boolean`
|
||
- 默认值：`false`
|
||
|
||
启动时检查是否存在 MyBatis XML 文件，默认不检查。
|
||
|
||
### executor-type
|
||
|
||
- 类型：`ExecutorType`
|
||
- 默认值：`simple`
|
||
|
||
通过该属性可指定 MyBatis 的执行器，MyBatis 的执行器总共有三种：
|
||
|
||
- `ExecutorType.SIMPLE`：该执行器类型不做特殊的事情，为每个语句的执行创建一个新的预处理语句（PreparedStatement）。
|
||
- `ExecutorType.REUSE`：该执行器类型会复用预处理语句（PreparedStatement）。
|
||
- `ExecutorType.BATCH`：该执行器类型会批量执行所有的更新语句。
|
||
|
||
### defaults-scripting-language-driver
|
||
|
||
- 类型：`Class<? extends LanguageDriver>`
|
||
- 默认值：`null`
|
||
|
||
指定默认的脚本语言驱动器。
|
||
|
||
### configuration-properties
|
||
|
||
- 类型：`Properties`
|
||
- 默认值：`null`
|
||
|
||
指定外部化 MyBatis Properties 配置，通过该配置可以抽离配置，实现不同环境的配置部署。
|
||
|
||
## configuration
|
||
|
||
本部分（Configuration）的配置都为 MyBatis
|
||
原生支持的配置，有关配置请参考 [MyBatis Configuration](https://mybatis.org/mybatis-3/zh/configuration.html#%E8%AE%BE%E7%BD%AE%EF%BC%88settings%EF%BC%89)。
|
||
|
||
## global-config
|
||
|
||
### print-banner
|
||
|
||
- 类型：`boolean`
|
||
- 默认值：`true`
|
||
|
||
是否控制台打印 MyBatis-Flex 的 LOGO 及版本号。
|
||
|
||
### key-config
|
||
|
||
- 类型：`com.mybatisflex.core.FlexGlobalConfig.KeyConfig`
|
||
- 默认值：`null`
|
||
|
||
全局的 ID 生成策略配置，当 `@Id` 未配置或者配置 `KeyType` 为 `None` 时 使用当前全局配置。
|
||
|
||
### normal-value-of-logic-delete
|
||
|
||
- 类型：`java.lang.Object`
|
||
- 默认值：`0`
|
||
|
||
逻辑删除数据存在标记值。
|
||
|
||
### deleted-value-of-logic-delete
|
||
|
||
- 类型：`java.lang.Object`
|
||
- 默认值：`1`
|
||
|
||
逻辑删除数据删除标记值，
|