配置解析
1.配置种类
MyBatis 的配置文件包含了会深深影响 MyBatis 行为的设置和属性信息
configuration(配置)
- properties(属性)
- settings(设置)
- typeAliases(类型别名)
- typeHandlers(类型处理器)
- objectFactory(对象工厂)
- plugins(插件)
- environments(环境配置)
- environment(环境变量)
- transactionManager(事务管理器)
- dataSource(数据源)
- environment(环境变量)
- databaseIdProvider(数据库厂商标识)
- mappers(映射器)
2.环境配置(environments)
-
MyBatis 可以配置成适应多种环境
-
不过要记住:尽管可以配置多个环境,但每个 SqlSessionFactory 实例只能选择一种环境。
<environments default="development"> <environment id="development"> <transactionManager type="JDBC"> <property name="..." value="..."/> </transactionManager> <dataSource type="POOLED"> <property name="driver" value="${driver}"/> <property name="url" value="${url}"/> <property name="username" value="${username}"/> <property name="password" value="${password}"/> </dataSource> </environment> </environments>
注意一些关键点:
- 默认使用的环境 ID(比如:default=“development”)。
- 每个 environment 元素定义的环境 ID(比如:id=“development”)。
- 事务管理器的配置(比如:type=“JDBC”)。
- 数据源的配置(比如:type=“POOLED”)。
-
事务管理器(transactionManager)
- 在 MyBatis 中有两种类型的事务管理器(也就是 type="[JDBC|MANAGED]")
- 默认的是JDBC
-
数据源(dataSource)
- 有三种内建的数据源类型(也就是 type="[UNPOOLED|POOLED|JNDI]")
- 默认的是POOLED(有池:用完可以回收)
3.属性(properties)
-
我们可以通过properties属性来实现引用配置文件
-
这些属性可以在外部进行配置,并可以进行动态替换。你既可以在典型的 Java 属性文件中配置这些属性,也可以在 properties 元素的子元素中设置。
-
编写一个配置文件
driver=com.mysql.jdbc.Driver url=jdbc:mysql://localhost:3306/mybatis?useSSL=true&useUnicode=true&charcaterEncoding=UTF-8 username=root password=123456
-
在核心配置文件中引入
<properties resource="dp.properties"> </properties> <environments default="development"> <environment id="development"> <transactionManager type="JDBC"/> <dataSource type="POOLED"> <property name="driver" value="${driver}"/> <property name="url" value="${url}"/> <property name="username" value="${username}"/> <property name="password" value="${password}"/> </dataSource> </environment> </environments>
5.类型别名(typeAliases)
- 类型别名可为 Java 类型设置一个缩写名字。
- 意在降低冗余的全限定类名书写。
<!-- 给实体类起别名 -->
<typeAliases>
<typeAlias type="com.pojo.User" alias="user"/>
</typeAliases>
<update id="updataList" parameterType="user">
- 也可以指定一个包名,MyBatis 会在包名下面搜索需要的 Java Bean,
- 在没有注解的情况下,会使用 Bean 的首字母小写的非限定类名来作为它的别名
<!-- 给实体类起别名 -->
<typeAliases>
<typeAlias name="com.pojo"/>
</typeAliases>
-
在实体类比较少的时候,使用第一种方式。
-
如果实体类十分多,建议使用第二种。
-
第一种可以DIY(自定义)别名,第二种则不行,如果非要改,需要在实体类上增加注解
@Alias("user") public class User{}
6.设置(settings)
这是 MyBatis 中极为重要的调整设置,它们会改变 MyBatis 的运行时行为。
设置名 | 描述 | 有效值 | 默认值 |
---|---|---|---|
mapUnderscoreToCamelCase | 是否开启驼峰命名自动映射,即从经典数据库列名 A_COLUMN 映射到经典 Java 属性名 aColumn。 | true|false | false |
cacheEnabled | 全局性地开启或关闭所有映射器配置文件中已配置的任何缓存。 | true|false | true |
logImpl | 指定 MyBatis 所用日志的具体实现,未指定时将自动查找。 | SLF4J、LOG4J、LOG4J2、JDK_LOGGING、COMMONS_LOGGING、STDOUT_LOGGING、NO_LOGGING | 未设置 |
azyLoadingEnabled | 延迟加载的全局开关。当开启时,所有关联对象都会延迟加载。 特定关联关系中可通过设置 fetchType 属性来覆盖该项的开关状态。 | true|false | false |
7.映射器(mappers)
MapperRegistry:注册绑定我们的Mapper文件
-
方式一:使用相对于类路径的资源引用
<!-- 使用相对于类路径的资源引用 --> <mappers> <mapper resource="com/mapper/UserMapper.xml"/> </mappers>
-
方式二:使用完全限定资源定位符(URL)(不建议使用)
<!-- 使用完全限定资源定位符(URL) --> <mappers> <mapper url="file:///var/mappers/UserMapper.xml"/> </mappers>
-
方式三:使用映射器接口实现类的完全限定类名
<!-- 使用映射器接口实现类的完全限定类名 --> <mappers> <mapper class="com.mapper.UserMapper"/> </mappers>
注意点:
- 接口和它的Mapper配置文件必须同名!
- 接口和它的Mapper配置文件必须在同一个包下!
-
方式四:将包内的映射器接口实现全部注册为映射器
<!-- 将包内的映射器接口实现全部注册为映射器 --> <mappers> <package name="com.mapper"/> </mappers>
注意点:
- 接口和它的Mapper配置文件必须同名!
- 接口和它的Mapper配置文件必须在同一个包下!
8.其他配置
- typeHandlers(类型处理器)
- objectFactory(对象工厂)
- plugins(插件)
- databaseIdProvider(数据库厂商标识)
9.作用域和生命周期
-
作用域和生命周期类别是至关重要的,因为错误的使用会导致非常严重的并发问题。
-
SqlSessionFactoryBuilder:
- 一旦创建了 SqlSessionFactory,就不再需要它了。
- 适用于局部变量
-
SqlSessionFactory:
- 说白了就是可以想象为:数据库连接池
- SqlSessionFactory 一旦被创建就应该在应用的运行期间一直存在,没有任何理由丢弃它或重新创建另一个实例。
- 因此 SqlSessionFactory 的最佳作用域是应用作用域。
- 有很多方法可以做到,最简单的就是使用单例模式或者静态单例模式。
-
SqlSession:
- 连接到连接池的一个请求
- SqlSession 的实例不是线程安全的,因此是不能被共享的,所以它的最佳的作用域是请求或方法作用域。
- 用完之后需要赶紧关闭,否则资源被占用!