Mybatis-全局配置文件

简介

MyBatis 的配置文件包含了会深深影响 MyBatis 行为的设置和属性信息。 配置文档的顶层结构如下

引入dtd约束

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
  PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
  "http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>

</configuration>

properties-引入外部属性

使用properties来引入外部properties配置文件内容

resource: 引入类路径下的资源resources下

url: 引入网络路径或磁盘路径下的资源

dbconfig.properties

jdbc.driver=com.mysql.cj.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/mybatis
jdbc.username=root
jdbc.password=root

<properties resource="dbconfig/dbconfig.properties"></properties>

settings-运行时行为设置

settings 包含很多配置项
setting 就是每一个配置项
name 配置项名称

<settings>
    <setting name="mapUnderscoreToCamelCase" value="true"/>
    <setting name="lazyLoadingEnabled" value="true"/>
    <setting name="aggressiveLazyLoading" value="false"/>
</settings>

typeAliases-类型别名

别名不区分大小写

type： 指定要起别名的类型全类名 默认别名就是类名小写

alias: 指定新的别名

<typeAliases>
    <typeAlias type="com.edu.mybatis.bean.Employee" alias="emp"/>
</typeAliases>

使用注解配置

@Alias("emp")
public class Employee {

也可以指定一个包名，MyBatis 会在包名下面搜索需要的 Java Bean，比如：

<typeAliases>
  <package name="domain"/>
</typeAliases>

typeHandlers-类型处理器

MyBatis 在设置预处理语句（PreparedStatement）中的参数或从结果集中取出一个值时， 都会用类型处理器将获取到的值以合适的方式转换成 Java 类型。下表描述了一些默认的类型处理器。从 3.4.5 开始，MyBatis 默认支持 JSR-310（日期和时间 API） 。

plugins-插件

MyBatis 允许你在映射语句执行过程中的某一点进行拦截调用。默认情况下，MyBatis 允许使用插件来拦截的方法调用包括：

• Executor (update, query, flushStatements, commit, rollback, getTransaction, close, isClosed)
• ParameterHandler (getParameterObject, setParameters)
• ResultSetHandler (handleResultSets, handleOutputParameters)
• StatementHandler (prepare, parameterize, batch, update, query)

environments-环境配置

MyBatis 可以配置成适应多种环境，这种机制有助于将 SQL 映射应用于多种数据库之中， 现实情况下有多种理由需要这么做。例如，开发、测试和生产环境需要有不同的配置；或者想在具有相同 Schema 的多个生产数据库中使用相同的 SQL 映射。还有许多类似的使用场景。

• 默认使用的环境 ID（比如：default=“development”）。
• 每个 environment 元素定义的环境 ID（比如：id=“development”）。
• 事务管理器的配置（比如：type=“JDBC”）。
• 数据源的配置（比如：type=“POOLED”）。

<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>

databaseIdProvider-多数据库支持

MyBatis 可以根据不同的数据库厂商执行不同的语句，这种多厂商的支持是基于映射语句中的 databaseId 属性。

mybatis加载的时候，会加载所有默认的sql语句和带databaseId的sql语句，如果默认和指定的冲突则会加载指定的sql

<!--为不同的数据库厂商取别名-->
<databaseIdProvider type="DB_VENDOR">
    <property name="MYSQL" value="mysql"/>
    <property name="SQL Server" value="sqlserver"/>
    <property name="DB2" value="db2"/>
    <property name="Oracle" value="oracle"/>
</databaseIdProvider>

<select id="getDeptById" resultType="com.edu.mybatis.bean.Department">
    SELECT id, dept_name name
    FROM `tbl_dept`
    WHERE id = #{id}
</select>

<select id="getDeptById" resultType="com.edu.mybatis.bean.Department" databaseId="mysql">
    SELECT id, dept_name name
    FROM `tbl_dept`
    WHERE id = #{id}
</select>

mappers-sql映射注册

在自动查找资源方面，Java 并没有提供一个很好的解决方案，所以最好的办法是直接告诉 MyBatis 到哪里去找映射文件。

<!-- 使用相对于类路径的资源引用 -->
<mappers>
	<mapper resource="mapper/EmployeeMapper.xml"/>
</mappers>

<!-- 使用完全限定资源定位符（URL） -->
<mappers>
  <mapper url="file:///var/mappers/AuthorMapper.xml"/>
</mappers>

mapper映射接口和实现类需要在同一个包下

<!-- 使用映射器接口实现类的完全限定类名 -->
<mappers>
  <mapper class="com.edu.mybatis.mapper.EmployeeMapper"/>
</mappers>

mapper映射接口和实现类需要在同一个包下

<!-- 将包内的映射器接口实现全部注册为映射器 -->
<mappers>
  <package name="com.edu.mybatis.mapper"/>
</mappers>