MyBatis别名和settings设置

2022-07-13 12:56:39

别名(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>
  • 作者:瞭望塔
  • 原文链接:https://blog.csdn.net/congge_1993/article/details/73548506
    更新时间:2022-07-13 12:56:39