mybatis 配置详解
SqlMapConfig.xml配置详解
具体配置如下
properties(属性)
settings(全局配置参数)
typeAliases(类型别名)
typeHandlers(类型处理器)
objectFactory(对象工厂)
plugins(插件)
environments(环境集合属性对象)
environment(环境子属性对象)
transactionManager(事务管理)
dataSource(数据源)
mappers(映射器)
<?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>
<!-- 在classpath下定义属性文件引入 -->
<properties resource="db.properties"/>
<!-- mybatis的全局配置参数 -->
<settings>
<!-- 延迟加载的总开关 -->
<setting name="lazyLoadingEnabled" value="true"/>
<!-- 设置为false,实现按需求加载 -->
<setting name="aggressiveLazyLoading" value="false"/>
</settings>
<!-- 别名 -->
<typeAliases>
<!-- 单个指定 -->
<typeAlias type="cn.ade.domain.User" alias="user"/>
<!-- 批量指定,扫描包下的所有类,别名为类名大写或者小写都可以 -->
<package name="cn.ade.domain"/>
</typeAliases>
<!-- 与spring整合之后,environments将被废除 -->
<environments default="development">
<!-- 可以配置多个环境 -->
<environment id="development">
<!-- 使用JDBC事务管理 -->
<transactionManager type="JDBC"/>
<!-- 数据库连接池,使用mybatis自带的连接池 -->
<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>
<!-- 加载mapper.xml -->
<mappers>
<!-- 指定classpath下的文件 -->
<!--<mapper resource="sqlmap/User.xml"/>-->
<!-- 使用绝对路径 -->
<!--<mapper url="file:///D:\workspace\mybatis\src\main\resources\sqlmap" />-->
<!-- 使用mapper接口类路径,通过mapper.java进行映射,映射文件和类路径保持一致 -->
<!--<mapper class="cn.adepper.UserMapper"/>-->
<!-- 通过包扫描进行映射 -->
<package name="cn.ade.mapper"/>
</mappers>
</configuration>
属性
mybatis加载属性的顺序:
- 加载properties元素体中定义的属性
- 加载properties元素中resource或url加载的属性
- 加载parameterType传递的属性
加载规则:后面加载的会覆盖前面加载的同名属性
全局参数settings
别名typeAliases
mybatis除了可以自定义别名,也有一些默认支持的别名
默认支持别名
别名 | 映射的类型 |
---|---|
_byte | byte |
_long | long |
_short | short |
_int | int |
_integer | int |
_double | double |
_float | float |
_boolean | boolean |
string | String |
byte | Byte |
long | Long |
short | Short |
int | Integer |
integer | Integer |
double | Double |
float | Float |
boolean | Boolean |
date | Date |
decimal | BigDecimal |
bigdecimal | BigDecimal |
类型处理器typeHandlers
类型处理器用于java和jdbc类型的映射。
mybatis支持的类型处理器已经满足日常需要,一般不需要再自定义。
mybatis支持的类型处理器
类型处理器 | java类型 | jdbc类型 |
---|---|---|
BooleanTypeHandler | Boolean,boolean | 任何兼容的布尔值 |
ByteTypeHandler | Byte,byte | 任何兼容的数字或字节类型 |
ShortTypeHandler | Short,short | 任何兼容的数字或短整型 |
IntegerTypeHandler | Integer,int | 任何兼容的数字和整型 |
LongTypeHandler | Long,long | 任何兼容的数字或长整型 |
FloatTypeHandler | Float,float | 任何兼容的数字或单精度浮点型 |
DoubleTypeHandler | Double,double | 任何兼容的数字或双精度浮点型 |
BigDecimalTypeHandler | BigDecimal | 任何兼容的数字或十进制小数类型 |
StringTypeHandler | String | CHAR和VARCHAR类型 |
ClobTypeHandler | String | CLOB和LONGVARCHAR类型 |
NStringTypeHandler | String | NVARCHAR和NCHAR类型 |
NClobTypeHandler | String | NCLOB类型 |
ByteArrayTypeHandler | byte[] | 任何兼容的字节流类型 |
BlobTypeHandler | byte[] | BLOB和LONGVARBINARY类型 |
DateTypeHandler | Date(java.util) | TIMESTAMP类型 |
DateOnlyTypeHandler | Date(java.util) | DATE类型 |
TimeOnlyTypeHandler | Date(java.util) | TIME类型 |
SqlTimestampTypeHandler | Timestamp(java.sql) | TIMESTAMP类型 |
SqlDateTypeHandler | Date(java.sql) | DATE类型 |
SqlTimeTypeHandler | Time(java.sql) | TIME类型 |
ObjectTypeHandler | 任意 | 其他或未指定类型 |
EnumTypeHandler | Enumeration类型 | VARCHAR-任何兼容的字符串类型,作为代码存储(而不是索引) |
映射器mappers
参考代码中注释
Mapper.xml 配置详解
Mapper.xml映射文件中定义了操作数据库的sql,每个sql是一个statement,映射文件是mybatis的核心。
parameterType
- #{}与${}
占位符#{}可以有效防止sql注入,在使用时不需要关心参数值的类型,mybatis会自动进行java类型和jdbc类型的转换。
占位符#{}可以接收简单类型值或pojo属性值.
如果parameterType传输单个简单类型值,#{}括号中可以是value或其它名称。
占位符${}可以将parameterType 传入的内容拼接在sql中且不进行jdbc类型转换。
占位符${}可以接收简单类型值或pojo属性值。
如果parameterType传输单个简单类型值,${}括号中只能是value。
- 传递简单类型
- 传递pojo对象
mybatis使用ognl表达式解析对象字段的值:#{username} - 传递包装对象
mybatis使用ognl表达式解析对象字段的值:#{user.username} - 传递hashmap
mybatis使用映射解析key对应的值:#{key}
resultType
- 输出简单类型
输出简单类型必须查询出来的结果集有一条记录,最终将第一个字段的值转换为输出类型。<select id="findUserCount" parameterType="user" resultType="int"> select count(1) from user </select>
- 输出pojo类
无论单条记录还是多条记录,都用user。只不过底层根据接口的定义使用selectOne还是selectList。<select id="findUserById" parameterType="int" resultType="user"> select * from user where id = #{id} </select>
- 输出hashmap
将输出的结果改为hashmap输出类型,将字段和值映射为key和value - resultMap
resultType可以指定pojo将查询结果映射为pojo,但需要pojo的属性名和sql查询的列名一致方可映射成功。
如果sql查询字段名和pojo的属性名不一致,可以通过resultMap将字段名和属性名作一个对应关系 ,resultMap实质上还需要将查询结果映射到pojo对象中。<resultMap id="queryUserResultMap" type="user"> <!-- <id />属性表示结果集的唯一标识,如果是联合主键,可以有多个id --> <id column="id_" property="id"/> <!-- <result />属性表示结果集的普通属性 --> <!-- column表示查询出来的字段名;property表示对应pojo的属性名称 --> <result column="username_" property="username"/> <result column="address_" property="address"/> <result column="sex_" property="sex"/> <result column="birthday_" property="birthday"/> </resultMap> <select id="findUserByIdResultMap" parameterType="int" resultMap="queryUserResultMap"> SELECT id id_,username username_,birthday birthday_,sex sex_,address address_ FROM USER WHERE id = #{id} </select>
动态sql
- if判断
<select id="findUserList" parameterType="user" resultType="user"> select * from user where 1=1 <if test="id!=null and id!=''"> and id=#{id} </if> <if test="username!=null and username!=''"> and username like '%${username}%' </if> </select>
- where
可以自动处理第一个and<select id="findUserList" parameterType="user" resultType="user"> select * from user <where> <if test="id!=null and id!=''"> and id=#{id} </if> <if test="username!=null and username!=''"> and username like '%${username}%' </if> </where> </select>
- foreach
<select id="selectUserByList" parameterType="java.util.List" resultType="user"> select * from user <where> <!-- 传递的是pojo的list集合 --> <if test="list!=null"> <foreach collection="list" item="item" open="and id in(" separator="," close=")"> #{item.id} </foreach> </if> </where> </select>
<select id="selectUserByArray" parameterType="Object[]" resultType="user"> select * from user <where> <!-- 传递的是pojo的array数组 --> <if test="array!=null"> <foreach collection="array" index="index" item="item" open="and id in(" separator="," close=")"> #{item.id} </foreach> </if> </where> </select>
- sql片段
<sql id="query_user_where">
<if test="user != null">
<if test="user.id != 0">
and id = #{user.id}
</if>
<if test="ids != null and ids.size > 0">
<foreach collection="ids" item="id" open="and id in (" close=")" separator=",">
#{id}
</foreach>
</if>
</if>
</sql>
<select id="findUserList" parameterType="queryUserVo" resultType="user">
SELECT * FROM user
<where>
<include refid="query_user_where"/>
</where>
</select>