MyBatis别名和settings设置方式

MyBatis别名和settings设置

别名（typeAliases）是一个指代的名称，在类的限定名过长时可以指定别名来简化使用，MyBatis里分为系统定义别名和自定义别名两种，系统定义别名是不需要我们再去指定的，通过TypeAliasRegistry类注册。

MyBatis中别名不区分大小写，一个typeAliases的实例是在解析配置文件时生成的，然后长期保存在Configuration对象中。

接下来配置别名：

1、在MyBatis Spring配置文件中引入配置

指定configLocation属性，即可在对应的xml文件中进行配置，如下所示：

    <!-- spring和MyBatis完美整合，不需要mybatis的配置映射文件 -->
    <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
        <property name="dataSource" ref="dataSource"/>
        <!-- 自动扫描mapping.xml文件 -->
        <property name="mapperLocations" value="classpath:com.fc.mapper/*-sqlmap.xml"/>
        <!-- 配置 -->
        <property name="configLocation" value="classpath:sqlmap-alias.xml"/>
    </bean>

2、sqlmap-alias.xml中的配置：

<?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>
    <!-- 开启驼峰规则与下划线间的映射关系 -->
    <settings>
        <setting name="mapUnderscoreToCamelCase" value="true"/>
    </settings>
 
    <!-- 别名 -->
    <typeAliases>
        <typeAlias alias="USER" type="com.fc.bean.User" />
    </typeAliases> 
</configuration>

在<typeAliases>标签下即可指定对应bean的别名，多个类的别名添加多个<typeAlias>标签即可。

<settings>是MyBatis最复杂的配置也是最重要的配置之一，不过不配置也可以正常工作，因为MyBatis已经提供了默认的配置，

如需要进行设置的自定义改动可以在配置中添加<settings>标签，如上例所示（注意configuration中的设置是有序的，如上述的settings和typeAliases标签交换顺序，会有错误提示）

具体的属性可以参考Configuration类，在配置文件中可以通过<setting>标签更改默认属性值，mapUnderscoreToCamelCase是

开启camel case（自动驼峰命名规则）映射，使用示例：

<select id="queryUser" parameterType="java.util.Map" resultType="USER">
        SELECT
          id,
          real_name,
          sex sex,
          age age,
          login_name,
          login_password,
          create_time,
          update_time
        from temp_user
        <trim prefix="where" prefixOverrides="and">
            <if test="realName != null and realName != '' ">
                and real_name = #{realName}
            </if>
            <if test="loginName != null and loginName != '' ">
                and login_name = #{loginName}
            </if>
        </trim>
    </select>

3、相对完整的setting设置和说明如下：

<!-- settings设置 -->
    <settings>
        <!-- 映射器缓存全局开关，默认true -->
        <setting name="cacheEnabled" value="true"/>
        <!-- 延迟加载的全局开关,默认false -->
        <setting name="lazyLoadingEnabled" value="false"/>
        <!-- 是带有延迟加载属性的对象完整加载，默认true -->
        <setting name="aggressiveLazyLoading" value="true"/>
        <!-- 是否允许单一语句返回多结果集，默认true -->
        <setting name="multipleResultSetsEnabled" value="true"/>
        <!-- 列标签代替列名，默认true -->
        <setting name="useColumnLabel" value="true"/>
        <!-- 允许jdbc支持自动生成主键,默认false -->
        <setting name="useGeneratedKeys" value="false"/>
        <!-- 指定 MyBatis 应如何自动映射列到字段或属性。
            NONE 表示取消自动映射；PARTIAL 只会自动映射没有定义嵌套结果集映射的结果集。
            FULL 会自动映射任意复杂的结果集（无论是否嵌套） -->
        <setting name="autoMappingBehavior" value="PARTIAL"/>
        <!-- 指定发现自动映射目标未知列的行为，默认NONE -->
        <setting name="autoMappingUnknownColumnBehavior" value="NONE"/>
        <!-- 指定默认执行器，SIMPLE/REUSE/BATCH -->
        <setting name="defaultExecutorType" value="SIMPLE"/>
        <!-- 设置超时时间，默认不设置 -->
        <setting name="defaultStatementTimeout" value="3000"/>
        <!-- 为驱动的结果集获取数量（fetchSize）设置一个提示值,默认不设置 -->
        <setting name="defaultFetchSize" value="1000"/>
        <!-- 嵌套语句中采用分页,默认false表示开启 -->
        <setting name="safeRowBoundsEnabled" value="false"/>
        <!-- 驼峰规则，默认false -->
        <setting name="mapUnderscoreToCamelCase" value="false"/>
        <!-- 会话开启本地缓存查询机制,其它值STATEMENT用于语句执行上 -->
        <setting name="localCacheScope" value="SESSION"/>
        <!-- 没有为参数指定jdbc类型时,为空值指定jdbc类型 -->
        <setting name="jdbcTypeForNull" value="OTHER"/>
        <!-- 指定对象的方法触发一次延迟加载 -->
        <setting name="lazyLoadTriggerMethods" value="equals,clone,hashCode,toString"/>
        <!-- 指定动态SQL生成的默认语言 -->
        <setting name="defaultScriptingLanguage" value="org.apache.ibatis.scripting.xmltags.XMLLanguageDriver"/>
        <!-- 指定当结果集中值为null的时候是否调用映射对象的setter（map 对象时为 put） -->
        <setting name="callSettersOnNulls" value="false"/>
        <!-- 指定mybatis增加到日志名称的前缀，默认不设置 -->
        <setting name="logPrefix" value="xxx_"/>
        <!-- 指定Mybatis创建具有延迟加载能力的对象所用到的代理工具,3.3或以上JAVASSIST -->
        <setting name="proxyFactory" value="CGLIB"/>
    </settings>

MyBatis setting的用法和解释

setting 用法

<!-- settings是 MyBatis 中极为重要的调整设置，它们会改变 MyBatis 的运行时行为。 -->  
    <settings>  
        <!-- 该配置影响的所有映射器中配置的缓存的全局开关。默认值true -->  
      <setting name="cacheEnabled" value="true"/>  
      <!--延迟加载的全局开关。当开启时，所有关联对象都会延迟加载。 特定关联关系中可通过设置fetchType属性来覆盖该项的开关状态。默认值false  -->  
      <setting name="lazyLoadingEnabled" value="true"/>  
        <!-- 是否允许单一语句返回多结果集（需要兼容驱动）。 默认值true -->  
      <setting name="multipleResultSetsEnabled" value="true"/>  
      <!-- 使用列标签代替列名。不同的驱动在这方面会有不同的表现， 具体可参考相关驱动文档或通过测试这两种不同的模式来观察所用驱动的结果。默认值true -->  
      <setting name="useColumnLabel" value="true"/>  
      <!-- 允许 JDBC 支持自动生成主键，需要驱动兼容。 如果设置为 true 则这个设置强制使用自动生成主键，尽管一些驱动不能兼容但仍可正常工作（比如 Derby）。 默认值false  -->  
      <setting name="useGeneratedKeys" value="false"/>  
     <!--  指定 MyBatis 应如何自动映射列到字段或属性。 NONE 表示取消自动映射；PARTIAL 只会自动映射没有定义嵌套结果集映射的结果集。 FULL 会自动映射任意复杂的结果集（无论是否嵌套）。 -->   
     <!-- 默认值PARTIAL -->  
      <setting name="autoMappingBehavior" value="PARTIAL"/>  
      <setting name="autoMappingUnknownColumnBehavior" value="WARNING"/>  
     <!--  配置默认的执行器。SIMPLE 就是普通的执行器；REUSE 执行器会重用预处理语句（prepared statements）； BATCH 执行器将重用语句并执行批量更新。默认SIMPLE  -->  
      <setting name="defaultExecutorType" value="SIMPLE"/>  
      <!-- 设置超时时间，它决定驱动等待数据库响应的秒数。 -->  
      <setting name="defaultStatementTimeout" value="25"/>  
      <setting name="defaultFetchSize" value="100"/>  
      <!-- 允许在嵌套语句中使用分页（RowBounds）默认值False -->  
      <setting name="safeRowBoundsEnabled" value="false"/>  
      <!-- 是否开启自动驼峰命名规则（camel case）映射，即从经典数据库列名 A_COLUMN 到经典 Java 属性名 aColumn 的类似映射。  默认false -->  
      <setting name="mapUnderscoreToCamelCase" value="false"/>  
      <!-- MyBatis 利用本地缓存机制（Local Cache）防止循环引用（circular references）和加速重复嵌套查询。  
             默认值为 SESSION，这种情况下会缓存一个会话中执行的所有查询。  
            若设置值为 STATEMENT，本地会话仅用在语句执行上，对相同 SqlSession 的不同调用将不会共享数据。  -->  
      <setting name="localCacheScope" value="SESSION"/>  
      <!-- 当没有为参数提供特定的 JDBC 类型时，为空值指定 JDBC 类型。 某些驱动需要指定列的 JDBC 类型，多数情况直接用一般类型即可，比如 NULL、VARCHAR 或 OTHER。  -->  
      <setting name="jdbcTypeForNull" value="OTHER"/>  
    <!--   指定哪个对象的方法触发一次延迟加载。  -->  
      <setting name="lazyLoadTriggerMethods" value="equals,clone,hashCode,toString"/>  
    </settings>  

具体解释

• 源自官方文档搬运，如有误请指正。谢谢！
• 为了提高阅读性，所以分为了4个表格。

以上为个人经验，希望能给大家一个参考，也希望大家多多支持猪先飞。