一、MyBatis 配置文件基本结构

1. <?xml version="1.0" encoding="UTF-8" ?>  
2. <!DOCTYPE configuration  
3. PUBLIC "-//mybatis.org//DTD Config 3.0//EN"  
4. "http://mybatis.org/dtd/mybatis-3-config.dtd">  
5. <!-- 配置文件的根元素 -->  
6. <configuration>  
7.     <!-- 属性：定义配置外在化 -->  
8.     <properties></properties>  
9.     <!-- 设置：定义mybatis的一些全局性设置 -->  
10.     <settings>  
11.        <!-- 具体的参数名和参数值 -->  
12.        <setting name="" value=""/>   
13.     </settings>  
14.     <!-- 类型名称：为一些类定义别名 -->  
15.     <typeAliases></typeAliases>  
16.     <!-- 类型处理器：定义Java类型与数据库中的数据类型之间的转换关系 -->  
17.     <typeHandlers></typeHandlers>  
18.     <!-- 对象工厂 -->  
19.     <objectFactory type=""></objectFactory>  
20.     <!-- 插件：mybatis的插件,插件可以修改mybatis的内部运行规则 -->  
21.     <plugins>  
22.        <plugin interceptor=""></plugin>  
23.     </plugins>  
24.     <!-- 环境：配置mybatis的环境 -->  
25.     <environments default="">  
26.        <!-- 环境变量：可以配置多个环境变量，比如使用多数据源时，就需要配置多个环境变量 -->  
27.        <environment id="">  
28.           <!-- 事务管理器 -->  
29.           <transactionManager type=""></transactionManager>  
30.           <!-- 数据源 -->  
31.           <dataSource type=""></dataSource>  
32.        </environment>   
33.     </environments>  
34.     <!-- 数据库厂商标识 -->  
35.     <databaseIdProvider type=""></databaseIdProvider>  
36.     <!-- 映射器：指定映射文件或者映射类 -->  
37.     <mappers></mappers>  
38. </configuration>  

1. <properties resource="org/mybatis/example/config.properties">  
2.   <property name="username" value="dev_user"/>  
3.   <property name="password" value="F2Fa3!33TYyg"/>  
4. </properties>  

1. <dataSource type="POOLED">  
2.   <property name="driver" value="${driver}"/>  
3.   <property name="url" value="${url}"/>  
4.   <property name="username" value="${username}"/>  
5.   <property name="password" value="${password}"/>  
6. </dataSource>  

1. SqlSessionFactory factory = sqlSessionFactoryBuilder.build(reader, props);  
2.   
3.   
4. // ... or ...  
5.   
6.   
7. SqlSessionFactory factory = sqlSessionFactoryBuilder.build(reader, environment, props);  

1. <settings>  
2.   <setting name="cacheEnabled" value="true"/>  
3.   <setting name="lazyLoadingEnabled" value="true"/>  
4.   <setting name="multipleResultSetsEnabled" value="true"/>  
5.   <setting name="useColumnLabel" value="true"/>  
6.   <setting name="useGeneratedKeys" value="false"/>  
7.   <setting name="autoMappingBehavior" value="PARTIAL"/>  
8.   <setting name="defaultExecutorType" value="SIMPLE"/>  
9.   <setting name="defaultStatementTimeout" value="25"/>  
10.   <setting name="defaultFetchSize" value="100"/>  
11.   <setting name="safeRowBoundsEnabled" value="false"/>  
12.   <setting name="mapUnderscoreToCamelCase" value="false"/>  
13.   <setting name="localCacheScope" value="SESSION"/>  
14.   <setting name="jdbcTypeForNull" value="OTHER"/>  
15.   <setting name="lazyLoadTriggerMethods" value="equals,clone,hashCode,toString"/>  
16. </settings>  

1. <typeAliases>  
2.   <typeAlias alias="Author" type="domain.blog.Author"/>  
3.   <typeAlias alias="Blog" type="domain.blog.Blog"/>  
4.   <typeAlias alias="Comment" type="domain.blog.Comment"/>  
5.   <typeAlias alias="Post" type="domain.blog.Post"/>  
6.   <typeAlias alias="Section" type="domain.blog.Section"/>  
7.   <typeAlias alias="Tag" type="domain.blog.Tag"/>  
8. </typeAliases>  

1. <typeAliases>  
2.   <package name="domain.blog"/>  
3. </typeAliases>  

1. @Alias("author") public class Author  
2.     {  
3. ...}  

1.  //  
2. ExampleTypeHandler.java  
3. @MappedJdbcTypes(JdbcType.VARCHAR) public class ExampleTypeHandler extends BaseTypeHandler<String>  
4.   
5.   {  
6.   
7.   @Override public void setNonNullParameter(PreparedStatement ps, int i, String parameter, JdbcType jdbcType) throws SQLException  
8.     { ps.setString(i,  
9.   parameter)  
10. ;  
11.   }  
12.   
13.   @Override public String getNullableResult(ResultSet rs, String columnName) throws SQLException  
14.     { return  
15.   rs.getString(columnName)  
16. ;  
17.   }  
18.   
19.   @Override public String getNullableResult(ResultSet rs, int columnIndex) throws SQLException  
20.     { return  
21.   rs.getString(columnIndex)  
22. ;  
23.   }  
24.   
25.   @Override public String getNullableResult(CallableStatement cs, int columnIndex) throws SQLException  
26.     { return  
27.   cs.getString(columnIndex);  
28. }}  

1. <!-- mybatis-config.xml -->  
2. <typeHandlers>  
3.   <typeHandler handler="org.mybatis.example.ExampleTypeHandler"/>  
4. </typeHandlers>  

1. <!-- mybatis-config.xml -->  
2. <typeHandlers>  
3.   <package name="org.mybatis.example"/>  
4. </typeHandlers>  

1. //GenericTypeHandler.java public class GenericTypeHandler<E extends MyObject> extends BaseTypeHandler<E>  
2.   
3.   { private Class<E>  
4.   
5.   type; public GenericTypeHandler(Class<E> type){  
6.     if (type == null) throw new IllegalArgumentException("Type argument cannot be null");  
7.     this.type =   
8.   type;}  
9.   ...  

1. <!-- mybatis-config.xml -->  
2. <typeHandlers>  
3.   <typeHandler handler="org.apache.ibatis.type.EnumOrdinalTypeHandler" javaType="java.math.RoundingMode"/>  
4. </typeHandlers>  

1. <!DOCTYPE mapper  
2.     PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"  
3.     "http://mybatis.org/dtd/mybatis-3-mapper.dtd">  
4.   
5.   
6. <mapper namespace="org.apache.ibatis.submitted.rounding.Mapper">  
7.     <resultMap type="org.apache.ibatis.submitted.rounding.User" id="usermap">  
8.         <id column="id" property="id"/>  
9.         <result column="name" property="name"/>  
10.         <result column="funkyNumber" property="funkyNumber"/>  
11.         <result column="roundingMode" property="roundingMode"/>  
12.     </resultMap>  
13.   
14.   
15.     <select id="getUser" resultMap="usermap">  
16.         select * from users  
17.     </select>  
18.     <insert id=  
19.         "insert"> insert into users (id, name, funkyNumber, roundingMode) values  
20.             ( #{id}, #{name}, #{funkyNumber},  
21.         #{roundingMode})  
22.     </insert>  
23.           
24.     <resultMap type="org.apache.ibatis.submitted.rounding.User" id="usermap2">  
25.         <id column="id" property="id"/>  
26.         <result column="name" property="name"/>  
27.         <result column="funkyNumber" property="funkyNumber"/>  
28.         <result column="roundingMode" property="roundingMode" typeHandler="org.apache.ibatis.type.EnumTypeHandler"/>  
29.     </resultMap>  
30.     <select id="getUser2" resultMap="usermap2">  
31.         select * from users2  
32.     </select>  
33.     <insert id=  
34.         "insert2"> insert into users2 (id, name, funkyNumber, roundingMode) values(  
35.             #{id}, #{name}, #{funkyNumber}, #{roundingMode, typeHandler=  
36.         org.apache.ibatis.type.EnumTypeHandler})  
37.     </insert>  
38.   
39.   
40. </mapper>  

1. //  
2. xampleObjectFactory.java public class ExampleObjectFactory extends DefaultObjectFactory  
3.  { public Object create(Class type)  
4.    { return  
5.  super.create(type);  
6.  } public Object create(Class type, List<Class> constructorArgTypes, List<Object> constructorArgs)  
7.    { return super.create(type, constructorArgTypes,  
8.  constructorArgs);  
9.  } public void setProperties(Properties properties)  
10.    {  
11.  super.setProperties(properties);  
12.  } public <T> boolean isCollection(Class<T> type){  
13.    return Collection.class.isAssignableFrom(type);  
14.  }}  

1. <!-- mybatis-config.xml -->  
2. <objectFactory type="org.mybatis.example.ExampleObjectFactory">  
3.   <property name="someProperty" value="100"/>  
4. </objectFactory>  

1. // ExamplePlugin.java  
2. @Intercepts({@Signature(  
3.   type= Executor.class,  
4.   method = "update",  
5.   args =   
6. {MappedStatement.class,Object.class})}) public class ExamplePlugin implements Interceptor  
7.   { public Object intercept(Invocation invocation) throws Throwable  
8.     { return  
9.   invocation.proceed();  
10.   } public Object plugin(Object target)  
11.     { return Plugin.wrap(target,  
12.   this);  
13.   } public void setProperties(Properties properties)  
14.   {}  
15. }  

1. <!-- mybatis-config.xml -->  
2. <plugins>  
3.   <plugin interceptor="org.mybatis.example.ExamplePlugin">  
4.     <property name="someProperty" value="100"/>  
5.   </plugin>  
6. </plugins>  

1. SqlSessionFactory factory = sqlSessionFactoryBuilder.build(reader, environment);  
2. SqlSessionFactory factory = sqlSessionFactoryBuilder.build(reader, environment,properties);  

1. SqlSessionFactory factory = sqlSessionFactoryBuilder.build(reader);  
2. SqlSessionFactory factory = sqlSessionFactoryBuilder.build(reader,properties);  

1. <environments default="development">  
2.   <environment id="development">  
3.     <transactionManager type="JDBC">  
4.       <property name="..." value="..."/>  
5.     </transactionManager>  
6.     <dataSource type="POOLED">  
7.       <property name="driver" value="${driver}"/>  
8.       <property name="url" value="${url}"/>  
9.       <property name="username" value="${username}"/>  
10.       <property name="password" value="${password}"/>  
11.     </dataSource>  
12.   </environment>  
13. </environments>  

1. <transactionManager type="MANAGED">  
2.   <property name="closeConnection" value="false"/>  
3. </transactionManager>  

1. public interface TransactionFactory{  
2.   void setProperties(Properties props);     
3.   Transaction newTransaction(Connection conn);  
4.   Transaction newTransaction(DataSource dataSource, TransactionIsolationLevel level, boolean autoCommit);     
5. }  

1. public interface Transaction{  
2.  Connection getConnection() throws SQLException;  
3.  void commit() throws SQLException;  
4.  void rollback() throws SQLException;  
5.  void close() throws SQLException;  

• initial_context  -- 这个属性用来在InitialContext中寻找上下文（即，initialContext.lookup(initial_context)）。这是个可选属性，如果忽略，那么data_source属性将会直接从InitialContext中寻找。
• data_source  -- 这是引用数据源实例位置的上下文的路径。提供了 initial_context配置时会在其返回的上下文中进行查找，没有提供时则直接在InitialContext中查找。

• env.encoding=UTF-8

databaseIdProvider

映射器（mappers）