推荐看这篇文章前可以看看文档:
http://www.mybatis.org/mybatis-3/zh/configuration.html
1.properties属性:
需求:
将数据库连接参数单独配置在db.properties中,只需要在SqlMapConfig.xml中加载db.properties的属性值。在SqlMapConfig.xml中就不需要对数据库连接参数硬编码。
将数据库连接参数只配置在db.properties中,原因:方便对参数进行统一管理,其他xml可以引用该db.properties
SqlMapConfig.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>
<properties resource="db.properties"></properties>
<environments default="development">
<environment id="development">
<!-- 使用jdbc事务管理,事务控制由mybatis -->
<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>
<!-- 加载映射文件 -->
<mappers>
<mapper resource="sqlmap/User.xml"/>
<mapper resource="mapper/UserMapper.xml"/>
</mappers>
</configuration>
db.properties
jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/mybatis
jdbc.username=xxxx
jdbc.password=xxxxx
如果属性在不只一个地方进行了配置,那么 MyBatis 将按照下面的顺序来加载:
- 在 properties 元素体内指定的属性首先被读取。
- 然后根据 properties 元素中的 resource 属性读取类路径下属性文件或根据 url 属性指定的路径读取属性文件,并覆盖已读取的同名属性。
- 最后读取作为方法参数传递的属性,并覆盖已读取的同名属性。
因此,通过方法参数传递的属性具有最高优先级,resource/url 属性中指定的配置文件次之,最低优先级的是 properties 属性中指定的属性。
建议:不要在properties元素体内添加任何属性值,只将属性值定义在properties属性文件中,在文件中定义的属性名要有一定的特殊性,如xxx.xxx.xxx
2.settings全局参数配置
mybatis框架在运行时可以调整一些运行参数。
比如:开启二级缓存、开启延迟加载
3.typeAliases(别名) ——重点
需求:
在mapper.xml中,定义很多的statement,statement需要parameterType指定输入参数的类型、需要resultType输出参数的映射类型
如果在指定类型时输入类型全路径,不方便进行开发,可以针对parameterType或resultType指定的类型定义一些别名,在mapper.xml中通过别名定义,方便开发。
默认别名可以去文档里面看:
http://www.mybatis.org/mybatis-3/zh/configuration.html
运用:
<typeAliases>
<!-- 单个别名 -->
<typeAlias type="com.TiHom.mybatis.po.User" alias="user"/>
</typeAliases>
引用的话直接在resultType上写user
<typeAliases>
<!-- 批量别名
指定包名:mybatis会自动扫描包中的po类,自动的来定义别名,别名就是类名(首字母大写或小写)
-->
<package name="com.TiHom.mybatis.po"/>
</typeAliases>
4.typeHandlers(类型处理器)
mybatis中通过typeHandlers来完成jdbc类型和java类型的转换
还是看文档:http://www.mybatis.org/mybatis-3/zh/configuration.html
通常情况下,mybatis提供的类型处理器满足日常使用,不需要定义
5.mappers(映射配置)
<!--
通过mapper接口加载映射文件
遵循一些规范:需要将mapper接口类名和mapper.xml映射文件名称保持一致,且在一个目录中
上边规范的前提是:使用的是mapper代理方法
-->
<mapper class="com.TiHom.mybatis.mapper.UserMapper" />
按照上面的规范将mapper.xml和mapper.java放在一个包下,且同名
<!-- 批量加载
同时需要遵守上面的规范
-->
<mapper package="com.TiHom.mybatis.mapper" />
6.输入映射
通过parameterType指定输入参数的类型,类型可以是简单类型、hashMap、pojo的包装类型。
- 传递pojo的包装对象
需求:我们要完成用户信息的综合查询,需要传入查询条件很复杂(可能包括用户信息、其他信息,比如商品、订单的)
定义包装类型pojo:针对上面需求,建议使用自定义的包装类型的pojo,针对上边需求,建议使用自定义的包装类型的pojo,在包装类型的pojo中将复杂的查询条件包装
package com.TiHom.mybatis.po;
/**
* 包装类型
* @author TiHom
*/
public class UserQueryVo {
//在这里包装所需要的查询条件
//用户查询条件
private UserCustom userCustom;
//可以包装
public UserCustom getUserCustom() {
return userCustom;
}
public void setUserCustom(UserCustom userCustom) {
this.userCustom = userCustom;
}
}
package com.TiHom.mybatis.po;
/**
* 用户的扩展类
* @author TiHom
*/
public class UserCustom extends User{
}
- mapper.xml
在UserMapper.xml中定义用户信息综合查询(查询条件复杂,通过高级查询进行复杂关联查询)
<select id="findUserList" parameterType="com.TiHom.mybatis.po.UserQueryVo" resultType="com.TiHom.mybatis.po.UserCustom">
select * from user where user.sex=#{userCustom.sex} and user.username like '%${userCustom.username}%'
</select>
- mapper.java
List<UserCustom> findUserList(UserQueryVo userQueryVo) throws Exception;
测试方法:
@Test
public void testFindUserList(){
SqlSession sqlSession = sqlSessionFactory.openSession();
//创建UserMapper对象,mybatis自动生成mapper代理对象
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
//创建包装对象,设置查询条件
UserQueryVo userQueryVo = new UserQueryVo();
UserCustom userCustom = new UserCustom();
userCustom.setSex("m");
userCustom.setUsername("小兰");
userQueryVo.setUserCustom(userCustom);
//调用userMapper方法
List<UserCustom> list = userMapper.findUserList(userQueryVo);
System.out.println(list);
}
7.输出映射
-
7.1 resultType
使用resultType进行输出的映射,只有查询出来的列名和pojo中的属性名一致,该列才可以映射成功。
如果查询出来的列名和pojo中的属性名全部不一致,没有创建pojo对 象
只要查询出来的列名和pojo中的属性有一个一致,就会创建pojo对象
7.1.1.1 需求
用户信息的综合查询列表总数,通过查询总数和上边用户综合查询列表才可以实现分页。
7.1.1.2 mapper.xml
<select id="findUserCount" parameterType="com.TiHom.mybatis.po.UserQueryVo" resultType="int">
select count(*) from user where user.sex=#{userCustom.sex} and user.username like '%${userCustom.username}%'
</select>
7.1.1.3 mapper.java
int findUserCount(UserQueryVo userQueryVo) throws Exception;
-
7.1.2 输出pojo对象和pojo列表
不管是输出的pojo单个对象还是一个列表(list中包括pojo),在mapper.xml中resultType指定的类型是一样的。
在mapper.java指定的方法返回值类型不一样:
1.输出单个pojo对象,方法返回值是单个对象类型
2.输出多个pojo对象,返回值是list类型
生成的动态代理对象中是根据mapper方法的返回值类型确定是调用selectOne(返回单个对象调用)还是selectList(返回集合调用)
-
7.2 resultMap
mybatis中使用resultMap完成高级输出结果映射
7.2.1 resultMap的使用方法
如果查询出来的列名和pojo的属性名不一致,通过定义一个resultMap对列名和pojo属性名之间做一个映射关系
1.定义resultMap
2.使用resultMap作为statement的输出映射类型
7.2.2 将下边的sql使用UserCustom完成映射
select id id_,username username_ from user where id=#{value}
userCustom类中属性名和上边查询列名不一致。
- 7.2.2.1 定义resultMap
<!--
type:resultMap最终映射的java对象类型,可以使用别名
id:对resultMap的唯一标识
-->
<resultMap id="userResultMap" type="user">
<!--id表示查询结果集中唯一标识
column:查询出来的列名
property:type指定的pojo类型中的属性名
最终resultMap对column和property做一个映射关系
-->
<id column="id_" property="id"/>
<!--
result:对普通列映射定义
column:查询出来的列名
property:type指定的pojo类型中的属性名
-->
<result column="username_" property="username"/>
</resultMap>
- 7.2.2.2 使用resultMap作为映射输出对象
<!-- 使用resultMap进行输出映射
如果这个resultMap在其他的mapper文件中,前面需要加上namespace
-->
<select id="findUserByIdResultMap" parameterType="int" resultMap="userResultMap">
select id id_,username username_ from user where id=#{value}
</select>
7.3 总结
1.使用resultType进行输出的映射,只有查询出来的列名和pojo中的属性名一致,该列才可以映射成功。
2.如果查询出来的列名和pojo的属性名不一致,通过定义一个resultMap对列名和pojo属性名之间做一个映射关系