Mybatis配置文件——全配置解析

我把总结放在开头，方便大家使用

为了让大家方便的使用，特意把总结放在文章开头，有帮助到你就点个关注呗

configuration

properties

第一个一级标签是properties，用来配置参数信息，比如最常见的数据库连接信息。

settings

setttings里面是MyBatis的一些核心配置，在 MyBatis 中 settings 是最复杂的配置，它能深刻影响 MyBatis 底层的运行，但是在大部分情况下使用默认值便可以运行，所以在大部分情况下不需要大量配置它，只需要修改一些常用的规则即可，比如自动映射、驼峰命名映射、级联规则、是否启动缓存、执行器（Executor）类型等。

settings 的配置项很多，但是真正用到的不会太多，我们把常用的配置项研究清楚就可以了，比如关于缓存的 cacheEnabled，关于级联的 lazyLoadingEnabled 和 aggressiveLazy Loading，关于自动映射的 autoMappingBehavior 和 mapUnderscoreToCamelCase，关于执行器类型的 defaultExecutorType 等。

<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="autoMappingUnknownColumnBehavior" value="WARNING"/> <setting name="defaultExecutorType" value="SIMPLE"/> <setting name="defaultStatementTimeout" value="25"/> <setting name="defaultFetchSize" value="100"/> <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> 

typeAliases

<typeAliases> <typeAlias alias="blog" type="com.domain.Blog" /> </typeAliases> 

配置了别名以后，在配置文件中只需要写别名就可以了，比如com.domain.Blog 可以简化成 blog。

<select id="selectBlogByBean" parameterType="blog" resultType="blog" select bid, name, author_id authorld from blog where name = 'S{ 
   name}' </select> 

MyBatis里面有很多系统预先定义好的类型别名，在TypeAliasRegistry 中。所以可以用string 代替java.lang.String。

typeHandlers

举个例子:

public class MyTypeHandler extends BaseTypeHandler<String> { 
    public void setNonNullParameter(PreparedStatement ps, int i, String parameter, JdbcType jdbcType) throws SQLException { 
    // 设置 String 类型的参数的时候调用，Java类型到JDBC类型 // 注意只有在字段上添加typeHandler属性才会生效 // insertBlog name字段 System.out.println("---------------setNonNullParameter1："+parameter); ps.setString(i, parameter); } public String getNullableResult(ResultSet rs, String columnName) throws SQLException { 
    // 根据列名获取 String 类型的参数的时候调用，JDBC类型到java类型 // 注意只有在字段上添加typeHandler属性才会生效 System.out.println("---------------getNullableResult1："+columnName); return rs.getString(columnName); } public String getNullableResult(ResultSet rs, int columnIndex) throws SQLException { 
    // 根据下标获取 String 类型的参数的时候调用 System.out.println("---------------getNullableResult2："+columnIndex); return rs.getString(columnIndex); } public String getNullableResult(CallableStatement cs, int columnIndex) throws SQLException { 
    System.out.println("---------------getNullableResult3："); return cs.getString(columnIndex); } } 

第二步，在mybatis-config.xml文件中注册:

<typeHandlers> <typeHandler handler="com.type.MyTypeHandler"></typeHandler> </typeHandlers>--> 

 <insert id="insertBlog" parameterType="blog"> insert into blog <trim prefix="(" suffix=")" suffixOverrides=","> <if test="bid != null"> bid, </if> <if test="name != null"> name, </if> <if test="authorId != null"> author_id, </if> </trim> <trim prefix="values (" suffix=")" suffixOverrides=","> <if test="bid != null"> #{ 
   bid,jdbcType=INTEGER}, </if> <if test="name != null"> #{ 
   name,jdbcType=VARCHAR,typeHandler=com.gupaoedu.type.MyTypeHandler}, </if> <if test="authorId != null"> #{ 
   authorId,jdbcType=INTEGER}, </if> </trim> </insert> 

返回值的时候，从JDBC类型到Java类型,在resultMap 的列上指定typehandler:

<result column="name" property="name" jdbcType="VARCHAR" typeHandler="com.type.MyTypeHandler"/> 

objectFactory

ObjectFactory有一个默认的实现类DefaultObjectFactory。创建对象的方法最终都调用了instantiateClass()，这里面能看到反射的代码。

默认情况下，所有的对象都是由DefaultObjectFactory 创建。

我们可以直接用自定义的工厂类来创建对象:

public class ObjectFactoryTest { 
    public static void main(String[] args) { 
    GPObjectFactory factory = new GPObjectFactory(); Blog myBlog = (Blog) factory.create(Blog.class); System.out.println(myBlog); } } 

public class ObjectFactory extends DefaultObjectFactory { 
    @Override public Object create(Class type) { 
    System.out.println("创建对象方法：" + type); if (type.equals(Blog.class)) { 
    Blog blog = (Blog) super.create(type); blog.setName("object factory"); blog.setBid(1111); blog.setAuthorId(2222); return blog; } Object result = super.create(type); return result; } } 

<objectFactory type="org.mybatis.example.ObjectFactory" <!--对象工厂注入的参数--> <property name="666" value="666"/> </objectFactory> 

plugins

environments environment

environments标签用来管理数据库的环境，比如我们可以有开发环境、测试环境、生产环境的数据库。可以在不同的环境中使用不同的数据库地址或者类型。

jdbc.driver=com.mysql.jdbc.Driver jdbc.url=jdbc:mysql://localhost:3306/mybatis?useUnicode=true&characterEncoding=utf-8&rewriteBatchedStatements=true jdbc.username=root jdbc.password= 

 <environments default="development"> <environment id="development"> <transactionManager type="JDBC"/><!-- 单独使用时配置成MANAGED没有事务 --> <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> 

一个environment标签就是一个数据源，代表一个数据库。这里面有两个关键的标签，一个是事务管理器，一个是数据源。

transactionManager

如果配置的是JDBC，则会使用Connection对象的commit()、rollback()、close()管理事务。

如果配置成MANAGED，会把事务交给容器来管理，比如JBOSS，Weblogic。因为我们跑的是本地程序，如果配置成MANAGE不会有任何事务。

如果是Spring + MyBatis,则没有必要配置，因为我们会直接在applicationContext.xml里面配置数据源和事务，覆盖MyBatis的配置。

dataSource

为什么要用连接池?

除了连接池之外，大家应该也听过很多其他的池，比如线程池，内存池，对象池,这种池化技术达到的目的基本上一样的。

如果没有连接池，那么每一个用户、每一次会话连接数据库都需要直接创建和释放连接，这个过程是会消耗的一定的时间的，并且会消耗应用和服务器的性能。

当我们没有使用连接池的时候，客户程序得到的连接是一个物理连接，我们调用close()方法会把这个连接真正地关闭。

如果采用连接池技术，在应用程序里面关闭连接的时候，物理连接没有被真正关闭掉，只是回到了连接池里面。

从这个角度来考虑，一般的连接池都会有初始连接数、最大连接数、回收时间等等这些参数，提供提前创建/资源重用/数量控制/超时管理等等这些功能。

MyBatis自带了两种数据源，UNPOOLED和POOLED。也可以配置成其他数据库，比如C3P0、Hikari等等。市面上流行的数据源，一般都有连接池功能。

在跟Spring集成的时候,事务和数据源都会交给Spring来管理,不再使用MyBatis配置的数据源。