Mybatis 核心配置文件详解

一、简介

        Mybatis 的核心配置文件，习惯上命名为 mybatis-config.xml，这个文件名仅仅只是建议，并非强制要求。将来整合 Spring 之后，这个配置文件可以省略。

二、标签顺序

        核心配置文件中的标签必须按照固定的顺序，顺序为：properties、settings、typeAliases、typeHandlers、objectFactory、objectWrapperFactory、reflectorFactory、plugins、environments、databaseIdProvider、mappers。

三、properties 标签

        引入 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="jdbc.properties"></properties>

	<environments default="mysql_test">
		<environment id="mysql_test">       
			<dataSource type="POOLED">
				<property name="driver" value="${jdbc.driver}"/>
				<property name="url" value="${jdbc.url}"/>
				<property name="username" value="${jdbc.username}"/>
				<property name="password" value="${jdbc.password}"/>
			</dataSource>
		</environment>
	</environments>
</configuration>

四、settings 标签

        它里面有两个子标签，分别为开启驼峰原则和开启延时加载，如下：

<?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>
   
   <settings>
		<!-- 将表中字段的下划线自动转换为驼峰 -->
		<setting name="mapUnderscoreToCamelCase" value="true"/>
		<!-- 开启延迟加载 -->
		<setting name="lazyLoadingEnabled" value="true"/>
	</settings>
</configuration>

五、typeAliases 标签

        设置某个具体的类型的别名，当设置完别名之后，就可以在 UserMapper.xml 中使用别名了，不需要编写类的全路径名称了，如下：

<?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>
   
	<typeAliases>
		<!-- 若没有设置 alias 属性，则该类型拥有默认的别名，即类名且不区分大小 -->
		<typeAlias type="com.mybatis.bean.User"></typeAlias>
		
		<!-- 若设置了 alias 属性，该类型的别名只能使用 alias 所设置的值-->
		<typeAlias type="com.mybatis.bean.User" alias="abc"></typeAlias>
	
		<!-- 现在都是下面这种写法-->
		<!-- 以包为单位，设置改包下所有的类型都拥有默认的别名，即类名且不区分大小写 -->
		<package name="com.mybatis.bean"/>
	</typeAliases>
	
</configuration>

<!-- 未使用别名写法 -->
<select id="getUserById" resultType="com.mybatis.pojo.User">
	select * from user where id = 2
</select>

<!-- 使用别名写法 -->
<select id="getUserById" resultType="User">
	select * from user where id = 2
</select>

六、environments

        设置多个连接数据库的环境

<?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>
   
	<!-- default：设置默认使用的环境的id -->
	<environments default="mysql_test">
	
		<!-- environment：设置具体的连接数据库的环境信息 -->
		<!-- id：设置环境的唯一标识，可通过 environments 标签中的 default 设置某一个环境的 id,表示默认使用的环境 -->
		<environment id="mysql_test">
		
			<!-- transactionManager：设置事务管理方式,type="JDBC|MANAGED" -->
			<!-- type="JDBC"：设置当前环境的事务管理都必须手动处理 -->
			<!-- type="MANAGED"：设置事务被管理，例如spring中的 AOP -->
			<transactionManager type="JDBC"/>
			
			<!-- dataSource：设置数据源，type="POOLED|UNPOOLED|JNDI" -->
			<!-- type="POOLED"：使用数据库连接池，即会将创建的连接进行缓存，下次使用可以从缓存中直接获取，不需要重新创建 -->
			<!-- type="UNPOOLED"：不使用数据库连接池，即每次使用连接都需要重新创建 -->
			<!-- type="JNDI"：调用上下文中的数据源 -->
			<dataSource type="POOLED">
			
				<!-- 设置驱动类的全类名 -->
				<property name="driver" value="${jdbc.driver}"/>
				
				<!-- 设置连接数据库的连接地址 -->
				<property name="url" value="${jdbc.url}"/>
				
				<!-- 设置连接数据库的用户名 -->
				<property name="username" value="${jdbc.username}"/>
				
				<!-- 设置连接数据库的密码 -->
				<property name="password" value="${jdbc.password}"/>
			</dataSource>
		</environment>
		
		<environment id="mysql_produce">	
			<transactionManager type="JDBC"/>						
			<dataSource type="POOLED">				
				<property name="driver" value="${jdbc.driver}"/>		
				<property name="url" value="${jdbc.url}"/>				
				<property name="username" value="${jdbc.username}"/>				
				<property name="password" value="${jdbc.password}"/>
			</dataSource>
		</environment>
	</environments>
</configuration>

七、mappers

        引入映射文件，如下所示：

<?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>
   
	<mappers>
		<!-- 引入单个的 mapper.xml -->
		<mapper resource="UserMapper.xml"/>
		
		<!--以包为单位，将包下所有的映射文件引入核心配置文件,注意：此方式必须保证 mapper 接口和 mapper 映射文件必须在相同的包下-->
		<package name="com.mybatis.mapper"/>
	</mappers>
</configuration>

八、设置核心配置文件模板

        1、打开 idea 的 File 目录的 Settings 选项

        2、选择 Editor 选项的 File and Code Templates

        3、点击 +，输入Name 和 Extension 

        4、测试效果