MyBatis——核心配置文件

一、核心配置文件介绍
 核心配置文件或者说总控文件即上文提到的mybatis-config.xml配置文件，该文件中包含了影响MyBatis行为的设置和属性信息，在配置这些属性的时候要严格遵循xml文件的dtd约束，dtd约束了各个属性出现的位置。

二、核心配置文件的内容
 1、<properties>标签：引入外部资源文件，比如c3p0、数据库的配置等
  ①在src下新建数据库的配置文件db.properties，内容如下：注意空格

db.driver=com.mysql.cj.jdbc.Driver
db.url=jdbc:mysql:///smve_test?serverTimezone=UTC
db.user=root
db.password=123456

  ②在mybatis-config.xml文件中通过<properties>标签引入上述配置：

<?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>
	<!-- 引入配置信息 -->
	<properties resource="db.properties" />
	<environments default="development">
		<environment id="development">
			<transactionManager type="JDBC" />
			<!-- 配置数据源，也可引用c3p0外部文件 -->
			<dataSource type="POOLED">
				<!-- db.properties文件会被加载到内存创建一个个的全局变量，因此可以在此处引用，其实不止可以在此处引用在其他地方也可以使用 -->
				<property name="driver" value="${db.driver}" />
				<property name="url" value="${db.url}" />
				<property name="username" value="${db.user}" />
				<property name="password" value="${db.password}" />
			</dataSource>
		</environment>
	</environments>

	<mappers>
		<!-- 映射的文件，也可以是类:框架根据此处的配置创建相应的实现类 -->
		<mapper resource="com/bdm/mappers/StudentMapper.xml" />
		<!-- <mapper class="com.bdm.mappers.StudentMapper" /> -->
	</mappers>
</configuration>  

  Tip：<properties>标签可以没有，如果有的话必须在<configuration>的最前面，这是由dtd约束决定的：这很合理因为<properties>引入的都是全局配置信息，这些信息会被加载到内存成为全局变量供后面的配置使用，因此应该放在最前面

<!ELEMENT configuration (properties?, settings?, typeAliases?, typeHandlers?, objectFactory?, objectWrapperFactory?, reflectorFactory?, plugins?, environments?, databaseIdProvider?, mappers?)>

 2、<settings>标签：设置全局参数，如二级缓存、懒加载等，该标签若有的话需放在<properties>后，若没有<properties>则放在最前面

<settings>
	<!-- 全局映射器启用缓存 -->
	<setting name="cacheEnabled" value="true" />
	<!-- 查询时，关闭关联对象即时加载以提高性能 -->
	<setting name="lazyLoadingEnabled" value="true" />
	<!-- 设置关联对象加载的形态，此处为按需加载字段(加载字段由SQL指 定)，不会加载关联表的所有字段，以提高性能 -->
	<setting name="aggressiveLazyLoading" value="false" />
	<!-- 对于未知的SQL查询，允许返回不同的结果集以达到通用的效果 -->
	<setting name="multipleResultSetsEnabled" value="true" />
	<!-- 允许使用列标签代替列名 -->
	<setting name="useColumnLabel" value="true" />
	<!-- 允许使用自定义的主键值(比如由程序生成的UUID32位编码作为键值)，数据表的PK生成策略将被覆盖 -->
	<setting name="useGeneratedKeys" value="true" />
	<!-- 给予被嵌套的resultMap以字段-属性的映射支持 -->
	<setting name="autoMappingBehavior" value="FULL" />
	<!-- 对于批量更新操作缓存SQL以提高性能 -->
	<setting name="defaultExecutorType" value="BATCH" />
	<!-- 数据库超过25000秒仍未响应则超时 -->
	<setting name="defaultStatementTimeout" value="25000" />
</settings>

 3、<typeAliases> 标签：别名处理器
  别名是为 Java 类起一个短的名字，它基本上只和 XxxMapper.xml 的配置有关，可用来减少类名重复的部分。
  示例1️⃣：为单个类起别名
   ①：在mybatis-config.xml文件中为单个类起别名

<typeAliases>
    <!-- type的值必须是全类名，alias的值即是别名，可以任意取 -->
    <typeAlias type="com.bdm.mybatis.entities.Student" alias="student"/>
</typeAliases>

   ②在XxxMapper.xml中使用别名：起了别名后也可以使用全类名

<mapper namespace="com.bdm.mybatis.daos.StudentMapper">
    <insert id="add" parameterType="student">
        INSERT INTO students(name,schoolName,age,birth)
        VALUES(#{name},#{schoolName},#{age},#{birth})
    </insert>
    <select id="getAll" resultType="com.bdm.mybatis.entities.Student">
        SELECT * FROM students
    </select>
</mapper>

  示例2️⃣：为整个包下的类起别名
   ①为整个包下的类起别名

<typeAliases>
    <!-- name的值必须是包名，该包下放的是与表对应的类 -->
    <package name="com.bdm.mybatis.entities"/>
</typeAliases>  

   ②此时XxxMapper.xml中再使用类名的时候既可以使用全类名，也可以使用简单类名，还可以使用简单类名的首字母小写

<!-- namespace指定该映射对应的接口，必须使用全类名 -->
<mapper namespace="com.bdm.mybatis.daos.StudentMapper">
    <insert id="add" parameterType="student">
        INSERT INTO students(name,schoolName,age,birth)
        VALUES(#{name},#{schoolName},#{age},#{birth})
    </insert>
    <select id="getById" parameterType="integer" 
    		resultType="com.bdm.mybatis.entities.Student">
        SELECT * FROM students WHERE id = #{id}
    </select>
    <select id="getAll" resultType="Student">
        SELECT * FROM students
    </select>
</mapper> 

  MyBatis对大部分常用类做了别名处理：基本数据类型前加_，包装类型和其他常用类型均为类名首字母小写



 4、<typeHandlers>标签：类型转换器，用来完成Java数据类型和JDBC数据类型之间的转换，举个比较简单的例子，表中的创建时间和修改时间用VARCHAR类型，但是在POJO对象中，创建时间和修改时间的类型是Date，这样我在向数据库插入数据时，需要将Date类型转化成VARCHAR，而从数据库中查询出的结果中，又需要将VARCHAR类型转换成Date，在MyBatis中，可以使用typeHandlers配置来实现这个转换过程。MyBatis的提供的映射基本已经满足，不太需要重新定义，详情参看MyBatis的类型转换器

  使用：指定参数的jdbc类型

<delete id="delete" parameterType="integer">
    DELETE FROM students WHERE id = #{id,jdbcType=Integer}
</delete> 

 5、<environments>标签：环境
  ①environment：环境变量
  ②transactionManager：事务管理器
  ③dataSource：数据源

<environments default="development">
    <environment id="development">
        <transactionManager type="JDBC" />
        <!-- 配置数据源，可引用c3p0外部文件 -->
        <dataSource type="POOLED">
            <property name="driver" value="${db.driver}" />
            <property name="url" value="${db.url}" />
            <property name="username" value="${db.user}" />
            <property name="password" value="${db.password}" />
        </dataSource>
    </environment>
</environments> 

 6、<mappers>标签：映射器

<mappers>
    <!-- XML配置文件 -->
    <mapper resource="com/bdm/mybatis/mapper/PersonMapper.xml" />
    <!-- 全类名 -->
    <mapper class="com.bdm.mybatis.mapper.PersonMapper" />
    <!-- 物理地址：不建议使用 -->
    <mapper url="file://D:\mybatis\mappers\Person.xml" />
    <!-- 注册mapper包下的所有mapper接口,
    此种方法要求mapper接口名称和mapper映射文件名称遵守mabatis规范——名称一致，且放在同一个目录中 -->
    <package name="com.bdm.mybatis.mapper" />
</mappers>