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="db_user" />
<property name="password" value="verysecurepwd" />
</properties>
<!-- 全局设置settings -->
<settings>
<setting name="cacheEnabled" value="true" />
<setting name="lazyLoadingEnabled" value="true" />
<setting name="multipleResultSetsEnabled" value="true" />
<setting name="useColumnLabel" value="true" />
<setting name="useGeneratedKeys" value="false" />
<setting name="autoMappingBehavior" value="PARTIAL" />
<setting name="defaultExecutorType" value="SIMPLE" />
<setting name="defaultStatementTimeout" value="25000" />
<setting name="safeRowBoundsEnabled" value="false" />
<setting name="mapUnderscoreToCamelCase" value="false" />
<setting name="localCacheScope" value="SESSION" />
<setting name="jdbcTypeForNull" value="OTHER" />
<setting name="lazyLoadTriggerMethods" value="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="${jdbc.driverClassName}" />
<property name="url" value="${jdbc.url}" />
<property name="username" value="${jdbc.username}" />
<property name="password" value="${jdbc.password}" />
</dataSource>
</environment>
<environment id="production">
<transactionManager type="MANAGED" />
<dataSource type="JNDI">
<property name="data_source" value="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>