MyBatis --> 3. 配置解析
3.1 核心配置文件
-
mybatis-config.xml
-
MyBatis 的配置文件包含了会深深影响 MyBatis 行为的设置和属性信息。
-
配置文档的顶层结构如下:
configuration(配置) properties(属性) settings(设置) typeAliases(类型别名) typeHandlers(类型处理器) objectFactory(对象工厂) plugins(插件) environments(环境配置) environment(环境变量) transactionManager(事务管理器) dataSource(数据源) databaseIdProvider(数据库厂商标识) mappers(映射器)
3.2 environments(环境配置)
- MyBatis可以配置成适应多种环境;
- 不过要记住:尽管可以配置多个环境,但每个SqlSessionFactory实例只能选择一种环境。
- MyBatis 中有两种类型的transactionManager(事务管理器)(也就是 type="[JDBC|MANAGED]"),默认是JDBC
- 有三种内建的dataSource(数据源)类型(也就是 type="[UNPOOLED|POOLED|JNDI]"),默认是POOLED
3.3 properties(属性)
-
通过properties来实现引用配置文件;
-
这些属性可以在外部进行配置,并可以进行动态替换。你既可以在典型的 Java 属性文件中配置这些属性,也可以在 properties 元素的子元素中设置。
-
db.properties
driver=com.mysql.jdbc.Driver url=jdbc:mysql://localhost:3306/mybatis?useSSL=true&useUnicode=true&characterEncoding=UTF-8 username=root password=123456
-
在核心配置文件中引入
<!--引入外部配置文件--> <properties resource="db.properties"> <property name="username" value="root"/> <property name="password" value="123456"/> </properties>
可以直接引入外部文件;
可以在其中增加一些属性的配置;
如何两个文件有同一个字段的属性,优先使用外部配置文件的属性。
-
3.4 typeAliases(类型别名)
- 类型别名可为 Java 类型设置一个缩写名字。它仅用于 XML 配置,意在降低冗余的全限定类名书写。
<typeAliases>
<typeAlias type="com.ano.pojo.User" alias="User"/>
</typeAliases>
- 也可以指定一个包名,MyBatis 会在包名下面搜索需要的 Java Bean
<typeAliases>
<package name="com.ano.pojo"/>
</typeAliases>
- 在实体类比较少的时候使用第一种方式,否则使用第二种方式
3.5 settings(设置)
-
这是 MyBatis 中极为重要的调整设置,它们会改变 MyBatis 的运行时行为。
<settings> <setting name="cacheEnabled" value="true"/> <setting name="lazyLoadingEnabled" value="true"/> <setting name="multipleResultSetsEnabled" value="true"/> <setting name="useColumnLabel" value="true"/> <setting name="useGeneratedKeys" value="false"/> <setting name="autoMappingBehavior" value="PARTIAL"/> <setting name="autoMappingUnknownColumnBehavior" value="WARNING"/> <setting name="defaultExecutorType" value="SIMPLE"/> <setting name="defaultStatementTimeout" value="25"/> <setting name="defaultFetchSize" value="100"/> <setting name="safeRowBoundsEnabled" value="false"/> <setting name="mapUnderscoreToCamelCase" value="false"/> <setting name="localCacheScope" value="SESSION"/> <setting name="jdbcTypeForNull" value="OTHER"/> <setting name="lazyLoadTriggerMethods" value="equals,clone,hashCode,toString"/> </settings>
3.6 其他
- typeHandlers(类型处理器)
- objectFactory(对象工厂)
- plugins(插件)
- mybatis-generator-core
- mybatis-plus
- 通用mapper
3.7 mappers(映射器)
-
每一个Mapper.xml都需要在mybatis核心配置文件中注册!
-
MyBatis 的行为已经由上述元素配置完了,现在就要来定义 SQL 映射语句了。首先,需要告诉 MyBatis 到哪里去找到这些语句;
-
可以使用相对于类路径的资源引用,
或完全限定资源定位符(包括,或类名和包名等。file:///
形式的 URL)
<mappers>
<mapper resource="com/ano/dao/UserMapper.xml"></mapper>
</mappers>
<mappers>
<mapper class="com.ano.dao.UserMapper"></mapper>
</mappers>
- 使用类名的注意点
- 接口和它的Mapper配置文件必须同名
- 接口和它的Mapper配置文件必须在同一个包下
<mappers>
<package name="com.ano.dao"/>
</mappers>
3.8 作用域(Scope)和生命周期
作用域和生命周期类别是至关重要的,因为错误的使用会导致非常严重的并发问题!
-
SqlSessionFactoryBuilder
- 一旦创建了 SqlSessionFactory,就不再需要它了;
- 因此,SqlSessionFactoryBuilder 实例的最佳作用域是方法作用域(也就是局部方法变量)
-
SqlSessionFactory
- SqlSessionFactory 一旦被创建就应该在应用的运行期间一直存在,没有任何理由丢弃它或重新创建另一个实例;
- 因此SqlSessionFactory 的最佳作用域是应用作用域;
- 最简单的就是使用单例模式或者静态单例模式。
-
SqlSession
- 每个线程都应该有它自己的 SqlSession 实例;
- SqlSession的实例不是线程安全的,因此是不能被共享的,所以它的最佳的作用域是请求或方法作用域;
- 用完之后需要关闭,否则资源被占用