首页 > 代码库 > mybatis-config详细配置说明

mybatis-config详细配置说明

<?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>
	<!-- 属性配置元素可以将配置值具体化到一个属性文件中,并且使用配置文件的key作为占位符
		application.properties
		jdbc.driverClassName=com.mysql.jdbc.Driver
		jdbc.url=jdbc:mysql://localhost:3306/mybatisdemo
		jdbc.username=root
		jdbc.password=admin
		在mybatis-config.xml中可以使用application.properties文件中定义的占位符
		当然也可以直接使用properties来设置值
	 -->
	<properties resource="application.properties">
		<property name="username" value="http://www.mamicode.com/db_user" />
		<property name="password" value="http://www.mamicode.com/verysecurepwd" />
	</properties>
	<!-- 全局设置settings -->
	<settings>
		<setting name="cacheEnabled" value="http://www.mamicode.com/true" />
		<setting name="lazyLoadingEnabled" value="http://www.mamicode.com/true" />
		<setting name="multipleResultSetsEnabled" value="http://www.mamicode.com/true" />
		<setting name="useColumnLabel" value="http://www.mamicode.com/true" />
		<setting name="useGeneratedKeys" value="http://www.mamicode.com/false" />
		<setting name="autoMappingBehavior" value="http://www.mamicode.com/PARTIAL" />
		<setting name="defaultExecutorType" value="http://www.mamicode.com/SIMPLE" />
		<setting name="defaultStatementTimeout" value="http://www.mamicode.com/25000" />
		<setting name="safeRowBoundsEnabled" value="http://www.mamicode.com/false" />
		<setting name="mapUnderscoreToCamelCase" value="http://www.mamicode.com/false" /> 
		<setting name="localCacheScope" value="http://www.mamicode.com/SESSION" />
		<setting name="jdbcTypeForNull" value="http://www.mamicode.com/OTHER" />
		<setting name="lazyLoadTriggerMethods" value="http://www.mamicode.com/equals,clone,hashCode ,toString" />
	</settings>
	<!-- 类型别名
		主要是为了简化在mapper文件中paramerType和resultType对应的类全限定名
	 -->
	<typeAliases>
		<typeAlias alias="Tutor" type="com.mybatis3.domain.Tutor" />
		<!-- 可以提供需要取别名的类所在的包,mybatis会自动扫描包内的javaBean,然后分别为每个javaBean定义一个小写字母开头的
			 例如这个包下有一个Student,那么别名为:student
			 除此之外:@Alias("StudentAlias")
				   public class Student{
				   		...
				   }
			@Alias 注解将会覆盖配置文件中的<typeAliases>定义
		-->
		<package name="com.mybatis3.domain" />
	</typeAliases>
	<!-- 
		类型句柄,类型处理器
		当mybatis执行一个INSERT操作的时候,汇创建一个PreparedStatement对象,并且执行一系列操作(操作下面详细说)
		这个过程中有一个setXXX()方式为占位符设置值的过程,xxx可以是Int,String,Date的任何一种类型,
		那么mybatis是依据什么来判断该使用setInt()还是setString()呢?其实 MyBatis 是通过使用类型处理器(type handlers)来决定这么做的。
		MyBatis 对于以下的类型使用内建的类型处理器:所有的基本数据类型、基本类型的包裹类型、byte[] 、
		java.util.Date、java.sql.Date、java,sql.Time、java.sql.Timestamp、java 枚举类型等。所以当 MyBatis 发现
		属性的类型属于上述类型,他会使用对应的类型处理器将值设置到 PreparedStatement 中,同样地,当从 SQL 结果集构
		建 JavaBean 时,也有类似的过程。
	 -->
	<typeHandlers>
		<typeHandler handler="com.mybatis3.typehandlers. PhoneTypeHandler" />
		<package name="com.mybatis3.typehandlers" />
	</typeHandlers>
	<!-- 数据库连接环境配置-->
	<environments default="development">
		<!-- environment:
		mybatis可以有多个dataScource环境,如DEV(开发),TEST(测试),
		可以通过默认的设置environment值来设定想要的environment  id。
		如果一个应用需要连接多个数据库,需要将每一个数据库设置成一个单独的环境,
		并且为每一个数据库设置一个SqlSessionFactory -->
		<environment id="development">
			<!-- 事务管理器
				type1:JDBC:mybatis内部会使用JdbcTransactionFactory来创建TransectionManager。
					       例如,部署到tomcat的应用程序,需要应用程序自己来管理程序
				type2:MANAGED(托管,应用本身不去管理实务,交给所在服务器来管理):
					  mybatis内部使用ManagedTransactionFactory来创建事务管理其TransactionManager
					       例如:当一个 JavaEE的应用程序部署在类似 JBoss, WebLogic,GlassFish 应用服务器上时,
					       它们会使用 EJB 进行应用服务器的事务管理能力。在这些管理环境中,你可以使用 MANAGED 事务管理器。
			 -->
			<transactionManager type="JDBC" />
			<!-- 数据源dataSource
				type1:UNPOOLED:会为每一个数据库操作创建一个新的链接,并关闭它。适合于小数据小并发的情况
				type2:POOLED:会穿件一个数据库连接池,开发和测试阶段常用模式
				type3:JNDI:从在服务器上配置好的JNDI数据源dataSource获取数据库连接,在生产环境,优先考虑
			 -->
			<dataSource type="POOLED">
				<property name="driver" value="http://www.mamicode.com/${jdbc.driverClassName}" />
				<property name="url" value="http://www.mamicode.com/${jdbc.url}" />
				<property name="username" value="http://www.mamicode.com/${jdbc.username}" />
				<property name="password" value="http://www.mamicode.com/${jdbc.password}" />
			</dataSource>
		</environment>
		<environment id="production">
			<transactionManager type="MANAGED" />
			<dataSource type="JNDI">
				<property name="data_source" value="http://www.mamicode.com/java:comp/jdbc/MyBatisDemoDS" />
			</dataSource>
		</environment>
	</environments>
	<!-- mapper文件映射 -->
	<mappers>
		<mapper resource="com/mybatis3/mappers/StudentMapper.xml" /> 
		<mapper url="file:///D:/mybatisdemo/mappers/TutorMapper.xml" />
		<mapper class="com.mybatis3.mappers.TutorMapper" />
	</mappers>
	<!-- 
		附:
		1、mybatis执行一条INSERT语句的过程
			1)创建一个有占位符的 PreparedStatement 接口,如下:
			Java Code 
			PreparedStatement pstmt = connection.prepareStatement
			("INSERT INTO STUDENTS(STUD_ID,NAME,EMAIL,DOB) VALUES(?,?,?,?)");
			2)检查 Student 对象的属性 studId 的类型,然后使用合适 setXXX 方法去设置参数值。这里 studId 是 integer
			类型,所以会使用 setInt()方法:
			Java Code 
			pstmt.setInt(1,student.getStudId());
			3)类似地,对于 name 和 email 属性都是 String 类型,MyBatis 使用 setString()方法设置参数。
			Java Code
			pstmt.setString(2, student.getName());
			pstmt.setString(3, student.getEmail());
			4)至于 dob 属性, MyBatis 会使用 setDate() 方法设置 dob 处占位符位置的值。
			5)MyBaits 会将 java.util.Date 类型转换为 into java.sql.Timestamp 并设值:
			pstmt.setTimestamp(4, new Timestamp((student.getDob()).
			getTime()));
		2、自定义typeHandler
			假设表 STUDENTS 有一个 PHONE 字段,类型为 VARCHAR(15),而 JavaBean  Student 有一个 PhoneNumber 类定义类型的 phoneNumber 属性。
			Java Code  
			public class PhoneNumber{
				private String countryCode;
				private String stateCode;
				private String number;
				public PhoneNumber(){
					//...
				}
			public PhoneNumber(String countryCode, String stateCode, String number){
				this.countryCode = countryCode;
				this.stateCode = stateCode;
				this.number = number;
			}
			public PhoneNumber(String string){
				if(string != null){
					String[] parts = string.split("-");
					if(parts.length > 0) this.countryCode = parts[0];
					if(parts.length > 1) this.stateCode = parts[1];
					if(parts.length > 2) this.number = parts[2];
				}
			}
			public String getAsString(){
				return countryCode + "-" + stateCode + "-" + number;
			}
				// Setters and getters
			}
			public class Student{
				private Integer id;
				private String name;
				private String email;
				private PhoneNumber phone;
				// Setters and getters
			}
			XML Code  
			<insert id="insertStudent" parameterType="Student">
				insert into students(name,email,phone)
				values(#{name},#{email},#{phone})
			</insert>
			这里,phone 参数需要传递给#{phone};而 phone 对象是 PhoneNumber 类型。然而,MyBatis 并不知道该怎样来处理这个类型的对象。
			为了让 MyBatis 明白怎样处理这个自定义的 Java 对象类型,如 PhoneNumber,我们可以创建一个自定义的类型处理器,如下所示:
			1)MyBatis 提供了抽象类 BaseTypeHandler<T> ,我们可以继承此类创建自定义类型处理器。
			Java Code 
			packagecom.mybatis3.typehandlers;
			importjava.sql.CallableStatement;
			importjava.sql.PreparedStatement;
			importjava.sql.ResultSet;
			importjava.sql.SQLException;
			importorg.apache.ibatis.type.BaseTypeHandler;
			importorg.apache.ibatis.type.JdbcType;
			importcom.mybatis3.domain.PhoneNumber;
			public class PhoneTypeHandler extends BaseTypeHandler<PhoneNumber>{
				@Override
				public void setNonNullParameter(PreparedStatement ps, int i,
				PhoneNumber parameter, JdbcType jdbcType) throwsSQLException{
					ps.setString(i, parameter.getAsString());
				}
				@Override
				public PhoneNumber getNullableResult(ResultSet rs, String columnName)throws SQLException{
					return new PhoneNumber(rs.getString(columnName));
				}
				@Override
				public PhoneNumber getNullableResult(ResultSet rs, int columnIndex)throws SQLException{
					return new PhoneNumber(rs.getString(columnIndex)); 
				}
				@Override
				public PhoneNumber getNullableResult(CallableStatement cs, int columnIndex)throws SQLException{
					return new PhoneNumber(cs.getString(columnIndex));
				}
			}
			2)我们使用 ps.setString()和 rs.getString()方法是因为 phone 列是 VARCHAR 类型。
			3)一旦我们实现了自定义的类型处理器,我们需要在 mybatis-config.xml 中注册它:
			XML Code 
			<?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="application.properties" />
				<typeHandlers>
					<typeHandler handler="com.mybatis3.typehandlers. PhoneTypeHandler" />
				</typeHandlers>
			</configuration>
			注册 PhoneTypeHandler 后, MyBatis 就能够将 Phone 类型的对象值存储到 VARCHAR 类型的列上。
	 -->
</configuration>

本文参考:Java Persistence with MyBatis 3(中文版)

本文出自 “不羁的风” 博客,请务必保留此出处http://fengcl.blog.51cto.com/9961331/1875460

mybatis-config详细配置说明