MyBatis(3.2.3)的配置文件详解

<?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元素可以将配置值具体化到一个属性文件中，并且使用属性文件的key名作为占位符 -->
	<properties resource="jdbc.properties">
		<!-- 
			如果<properties>中定义的元素和属性文件定义元素的 key值相同，
			它们会被属性文件中定义的值覆盖。
		-->
		<property name="jdbc.username" value="huey"/>
		<property name="jdbc.password" value="huey"/>
	</properties>
	
	<!-- 全局参数设置 -->
	<settings>
		
		<!-- 设置全局的映射器启用或禁用缓存 。-->
		<!-- 可取值：true|false	默认值：true -->
		<setting name="cacheEnabled" value="true" />
		
		<!-- 设置全局启用或禁用延迟加载。当禁用时，所有关联对象都会被即时加载。 -->
		<!-- 可取值：true|false	默认值：true -->
		<setting name="lazyLoadingEnabled" value="true" />
		
		<!-- 启用的时候，将会加载对象的所有懒属性，否则，按需加载。 -->
		<!-- 可取值：true|false	默认值：true -->
		<setting name="aggressiveLazyLoading" value="true"/>
		
		<!-- 设置是否允许多种结果集从一个单独的语句中返回（需要合适的驱动）。 -->
		<!-- 可取值：true|false	默认值：true -->
		<setting name="multipleResultSetsEnabled" value="true" />
		
		<!-- 使用列标签代替列名。不同的驱动在这方便表现不同。 -->
		<!-- 可取值：true|false	默认值：true -->
		<setting name="useColumnLabel" value="true" />
		
		<!-- 设置是否允许JDBC支持生成的键。需要适合的驱动。如果设置为true则这个设置强制生成的键被使用，尽管一些驱动拒绝兼容但仍然有效 -->
		<!-- 可取值：true|false	默认值：false -->
		<setting name="useGeneratedKeys" value="false" />
		
		<!-- 
			指定 MyBatis如何自动映射列到字段/属性。
			PARTIAL只会自动映射简单，没有嵌套的结果。
			FULL会自动映射任 意复杂的结果（嵌套的或其他情况）。
		-->
		<!-- 可取值：NONE|PARTIAL|FULL		默认值：PARTIAL -->
		<setting name="autoMappingBehavior" value="PARTIAL" />
		
		<!-- 
			设置默认执行器。
			SIMPLE执行器无特殊处理，
			RESUE可以执行预编译的Statement，
			BATCH可以执行预编译并且支持批量更新。
		-->
		<!-- 可取值：SIMPLE|RESUE|BATCH	默认值：SIMPLE -->
		<setting name="defaultExecutorType" value="SIMPLE" />
		
		<!-- 设置默认连接超时时间。 -->
		<!-- 可取值：任意int型正数 -->
		<setting name="defaultStatementTimeout" value="25000" />
		
		<!-- 设置是否允许在嵌套的语句中使用分页处理。 -->
		<!-- 可取值：true|false	默认值：false -->
		<setting name="safeRowBoundsEnabled" value="false" />
		
		<!-- 设置是否允许将数据库的复合式的列名映射为驼峰法的列名。 -->
		<!-- 可取值：true|false	默认值：false -->
		<setting name="mapUnderscoreToCamelCase" value="false" /> 
		
		<!--
			MyBatis使用本地缓存来放置循环引用和加快重复嵌套查询。
			SESSION：在session中执行的所有查询都被缓，
			STATEMENT：将会在语句执行的时候进行缓存，并且在两个调用间没有共享的数据，即便他们调用的是同一个sqlSession。 
		-->
		<!-- 可取值：SESSION|STATEMENT		默认值：SESSION -->
		<setting name="localCacheScope" value="SESSION" />
		
		<!-- 当没有特别的JDBC类型被提供，指定空值的类型为定义值。 -->
		<!-- 可取值： NULL|VARCHAR|OTHER等	默认值：OTHER -->
		<setting name="jdbcTypeForNull" value="OTHER" />
		
		<!-- 指定对象的哪些方法会被延迟加载。 -->
		<!-- 可取值：方法名的集合，用逗号隔开 -->
		<setting name="lazyLoadTriggerMethods" value="equals,clone,hashCode,toString" />
		
		<!-- 指定默认动态SQL生成器。 -->
		<!-- 可取值：类型的完全限定名或类型的别名 -->
		<setting name="defaultScriptingLanguage" value="org.apache.ibatis.scripting.xmltags.XMLDynamicLanguageDriver"/>
		
		<!-- 
			当结果集中含有NULL的时候，是否执行映射对象的setter方法或者Map的put方法。
			但是对于基础的int、boolean等基础对象无效。 
		-->
		<!-- 可取值：true|false	默认值：false -->
		<setting name="callSettersOnNull" value=""/>
		
		<!-- 指定MyBatis日志文件的后缀名。 -->
		<!-- 可取值：任意字符串 -->
		<setting name="logPrefix" value="log"/>
		
		<!-- 指定MyBatis中使用何种的日志处理程序，如果没有显示的指定的话，系统会自动尝试使用。 -->
		<!-- 可取值：SLF4J|LOG4J|LOG4J2|JDK_LOGGING|COMMONS_LOGGING|STDOUT_LOGGING|NO_LOGGING -->
		<setting name="logImpl" value="SLF4J"/>
		
		<!-- 指定MyBatis用于延迟对象加载的动态代理工具。 -->
		<!-- 可取值：CGLIB|JAVASSIST	默认值：CGLIB -->
		<setting name="proxyFactory" value="CGLIB"/>
	
	</settings>

	<!-- 设置别名 -->
	<!-- 在SQLMapper配置文件中，对于 resultType和 parameterType属性值，需要使用 JavaBean的完全限定名。 -->
	<!-- 可以为完全限定名取一个别名（alias），然后其需要使用完全限定名的地方使用别名，而不是到处使用完全限定名。 -->
	<!-- 还可以用注解@Alias在JavaBean进行配置，@Alias注解将会覆盖配置文件中的<typeAliases>定义 -->
	<typeAliases>
		<typeAlias type="com.huey.mybatis.entity.Student" alias="Student" />
		<typeAlias type="com.huey.mybatis.entity.Teacher" alias="Teacher" />
		<!-- 
			可以不用为每一个JavaBean单独定义别名，可以为提供需要取别名的JavaBean所在的包(package)，
			MyBatis会自动扫描包内定义的JavaBeans，然后分别为JavaBean注册一个小写字母开头的非完全限定的类名形式的别名。 
		-->
		<package name="com.huey.mybatis.entity"/>
	</typeAliases>
	
	<!-- 注册自定义类型处理器 -->
	<typeHandlers>
		<typeHandler handler="com.huey.mybatis.typehandlers.TelTypeHandler" />
	</typeHandlers>

	<!-- 数据源环境，default属性指定默认的environment -->
	<environments default="development">
		<environment id="development">
		
			<!-- MyBatis支持两种类型的事务管理器：JDBC和MANAGED。 -->
			<!-- JDBC事务管理器被用作当应用程序负责管理数据库连接的生命周期（提交、回退等等）的时候。 -->
			<!-- MANAGED事务管理器是当由应用服务器负责管理数据库连接生命周期的时候使用。 -->
			<transactionManager type="JDBC" />
			
			<!-- 配置数据源 -->
			<!-- 类型可以配置成其内置类型之一UNPOOLED、POOLED、JNDI -->
			<!-- 
				UNPOOLED，MyBatis会为每一个数据库操作创建一个新的连接，并关闭它。
				该方式适用于只有小规模数量并发用户的简单应用程序上。 
			-->
			<!-- 
				POOLED，MyBatis会创建一个数据库连接池，连接池中的一个连接将会被用作数据库操作。
				一旦数据库操作完成，MyBatis 会将此连接返回给连接池。
				在开发或测试环境中，经常使用此种方式。
			-->
			<!-- 
				JNDI，MyBatis从在应用服务器向配置好的JNDI数据源获取数据库连接。
				在生产环境中，优先考虑这种方式。
			-->
			<dataSource type="POOLED">
				<property name="driver" value="${jdbc.driverClassName}" />
				<property name="url" value="${jdbc.url}" />
				<property name="username" value="${jdbc.username}" />
				<property name="password" value="${jdbc.password}" />
			</dataSource>
		</environment>
		
		<!-- 
			MyBatis支持配置多个DataSource环境，可以将应用部署到不同的环境上。
			如果应用需要连接多个数据库，需要将每个数据库配置成独立的环境，
			并且为每一个数据库创建一个SqlSessionFactory。	
		-->
		<environment id="test">
			<transactionManager type="MANAGED" />
			<dataSource type="JNDI">
				<property name="data_source" value="java:comp/jdbc/anotherDS" />
			</dataSource>
		</environment>
	</environments>

	<!-- mapper对应的xml配置文件 -->
	<mappers>
		<!-- resource属性用来指定在 classpath中的 mapper文件。 -->
		<mapper resource="com/huey/mybatis/mapper/StudentMapper.xml" />
		<mapper resource="com/huey/mybatis/mapper/TeacherMapper.xml" />
		
		<!-- url属性用来通过完全文件系统路径或者 web URL地址来指向 mapper文件 -->
		<mapper url="file:///D:/mybatis/app/mappers/StudentMapper.xml" />
		<!-- class属性用来指向一个 mapper接口 -->
		<mapper class="com.huey.mybatis.mapper.StudentMapper" />
		<!-- package元素用来指向可以找到 Mapper接口的包名 -->
		<package name="com.huey.mybatis.mapper" />
	</mappers>
	
</configuration>