别名(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>