Mybatis学习总结（四）:输入映射和输出映射详解编程语言
在前面几篇文章的例子中也可以看到mybatis中输入映射和输出映射的身影，但是没有系统的总结一下，这篇博客主要对这两个东东做一个总结。我们知道mybatis中输入映射和输出映射可以是基本数据类型、hashmap或者pojo的包装类型，这里主要来总结一下pojo包装类型的使用，因为这个在开发中比较常用。
1、输入映射
输入映射，是在映射文件中通过parameterType指定输入参数的类型，类型可以是简单类型、hashmap、pojo的包装类型。假设现在有个比较复杂的查询需求：完成用户信息的综合查询，需要传入查询条件很复杂（可能包括用户信息、其它信息，比如商品、订单的），那么我们单纯的传入一个User就不行了，所以首先我们得根据查询条件，自定义一个新的pojo，在这个pojo中包含所有的查询条件。
1.1、定义包装类型pojo
定义一个UserQueryVo类，将要查询的条件包装进去。这里为了简单起见，就不添加其他的查询条件了，UserQueryVo中就包含一个User，假设复杂的查询条件在User中都已经包含了。
package com.mybatis.entity;
public class UserQueryVo {
//在这里添加所需要的查询条件
//用户查询条件，这里假设一个User就已经够了
private User user;
public User getUser() {
return user;
public void setUser(User user) {
this.user = user;
//可以包装其他的查询条件，比如订单、商品等
//......
}
1.2、配置UserMapper.xml文件
定义好了我们自己的pojo后，需要在UserMapper.xml映射文件中配置查询的statement，如下：
!-- 模拟包装类型组合查询
#{user.sex}:取出pojo包装对象中性别值
${user.username}：取出pojo对象中姓名值
select id="findUserList" parameterType="com.mybatis.entity.UserQueryVo" resultType="com.mybatis.entity.User"
select * from t_user where sex = #{user.sex} and username like %${user.username}%
/select
我们看到，输入的parameterType的值是我们自己定义的pojo，输出的是User，当然这里的User也可以换成另一个用户自定义的pojo，包含用户所需要的条件，都行，不仅仅局限为User。然后查询条件使用OGNL表达式，取出UserQueryVo中User的相应属性即可。
1.3、UserMapper.java类的代码
package com.mybatis.mapper;
import java.util.List;
import com.mybatis.entity.User;
import com.mybatis.entity.UserQueryVo;
* 用户管理mapper接口
* @author lixiaoxi
* 2017-02-06
public interface UserMapper {
//用户信息综合查询
public List User findUserList(UserQueryVo userQueryVo);
}
1.4、JUnit单元测试代码
package com.mybatis.test;
import java.io.InputStream;
import java.util.Date;
import java.util.List;
import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
import org.junit.Before;
import org.junit.Test;
import com.mybatis.entity.User;
import com.mybatis.entity.UserQueryVo;
import com.mybatis.mapper.UserMapper;
public class UserMapperTest {
private SqlSessionFactory sqlSessionFactory;
// [email protected]
@Before
public void setUp() throws Exception {
String resource = "SqlMapConfig.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
// 创建SqlSessionFcatory
sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
@Test
public void testFindUserList() {
SqlSession sqlSession = sqlSessionFactory.openSession();
//创建包装对象，设置查询条件
UserQueryVo userQueryVo = new UserQueryVo();
User user = new User();
user.setSex("1");
user.setUsername("小");
userQueryVo.setUser(user);
// 创建UserMapper对象，mybatis自动生成mapper代理对象
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
List User list=mapper.findUserList(userQueryVo);
System.out.println(list);
sqlSession.commit();
sqlSession.close();
}
2、输出映射
2.1、resultType
使用resultType进行输出映射，只有查询出来的列名和pojo中的属性名一致，该列才可以映射成功。如果查询出来的列名和pojo中的属性名全部不一致，没有创建pojo对象。
只要查询出来的列名和pojo中的属性有一个一致，就会创建pojo对象。
2.1.1、输出简单类型
需求：用户信息的综合查询列表，通过查询总数才能实现分页功能。
UserMapper.xml的代码：
?xml version="1.0" encoding="UTF-8" ?
!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd"
!-- namespace命名空间,作用就是对sql进行分类化的管理,理解为sql隔离
注意:使用mapper代理开发时，namespace有特殊作用,namespace等于mapper接口地址
mapper namespace="com.mybatis.mapper.UserMapper"
!-- 用户信息综合查询总数
parameterType:指定输入类型，和findUserList一致。
resultType:输出结果类型.
select id="findUserCount" parameterType="com.mybatis.entity.UserQueryVo" resultType="int"
select count(*) from t_user where sex=#{user.sex} and username like %${user.username}%
/select
/mapper
UserMapper.java的代码：
public interface UserMapper {
//用户信息综合查询总数
public int findUserCount(UserQueryVo userQueryVo);
}
JUnit测试代码：
package com.mybatis.test;
import java.io.InputStream;
import java.util.Date;
import java.util.List;
import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
import org.junit.Before;
import org.junit.Test;
import com.mybatis.entity.User;
import com.mybatis.entity.UserQueryVo;
import com.mybatis.mapper.UserMapper;
public class UserMapperTest {
private SqlSessionFactory sqlSessionFactory;
// [email protected]
@Before
public void setUp() throws Exception {
String resource = "SqlMapConfig.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
// 创建SqlSessionFcatory
sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
@Test
public void findUserCountTest() {
SqlSession sqlSession = sqlSessionFactory.openSession();
//创造查询条件
UserQueryVo userQueryVo = new UserQueryVo();
User user = new User();
user.setSex("1");
user.setUsername("小");
userQueryVo.setUser(user);
// 创建UserMapper对象，mybatis自动生成mapper代理对象
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
int count=mapper.findUserCount(userQueryVo);
System.out.println(count);
sqlSession.commit();
sqlSession.close();
}
小结:查询出来的结果集只有一行一列，可以使用简单类型进行输出映射。
2.1.2、输出pojo对象和pojo列表
不管是输出的pojo单个对象还是一个列表（list中包括pojo），在mapper.xml中resultType指定的类型是一样的。但在mapper.java指定的方法返回值类型不一样。
输出单个pojo对象，方法返回值是单个对象类型
public interface UserMapper {
/** 根据ID查询用户信息 */
public User findUserById(int id);
}
输出pojo对象list，方法返回值是List pojo
public interface UserMapper {
/** 根据用户名称模糊查询用户信息 */
public List User findUserByName(String username);
}
小结：生成的动态代理对象中是根据mapper.java方法的返回值类型确定是调用selectOne(返回单个对象调用)还是selectList(返回集合对象调用)
2.2、resultMap
我们知道，通过resultType输出映射的时候，查询出来的列名和pojo中对应的属性名要一致才可以做正确的映射，如果不一致就会映射错误。但是如果不一致呢？该如何解决这个问题呢？这就要使用resultMap来映射了。
假设现在映射文件中有个sql语句：select id id_,username username_ from t_user where id=#{id}，从这个sql语句中可以看出，查询出了id和username两列，但是都起了别名了，也就是说，如果我们现在用resultType去映射到User中的话，肯定会出问题，所以我们现在要定义一个resultMap来做查询结果列与User的属性之间的一个映射。
2.2.1、resultMap使用方法
(1).定义resultMap
(2).使用resultMap作为statement的输出映射类型
2.2.2、demo例子
(1).需求：将下面的sql使用resultMap完成映射
select id id_,username username_ from t_user where id=?
User类中属性名和上边的列名不一致。
(2).在SqlMapConfig.xml中自定义别名
!-- 批量别名的定义: package:指定包名，mybatis会自动扫描包中的pojo类，自动定义别名，别名就是类名(首字母大写或小写都可以) typeAliases package name="com.mybatis.entity"/ /typeAliases
(3).定义resultMap
?xml version="1.0" encoding="UTF-8" ? !DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd" !-- namespace命名空间,作用就是对sql进行分类化的管理,理解为sql隔离 注意:使用mapper代理开发时，namespace有特殊作用,namespace等于mapper接口地址 mapper namespace="com.mybatis.mapper.UserMapper" !-- 定义resultMap select id id_,username username_ from t_user和User类中的属性作为一个映射关系 type:resultMap最终映射的java对象类型，可以使用别名； id:对resultMap的唯一标识 resultMap type="user" id="userResultMap" !--id表示查询结果中的唯一标识， column：查询出来的列名 property：type指定的pojo类型中的属性名 最终resultMap对column和property作一个映射关系（对应关系） id column="id_" property="id"/ !--result:表示对普通列名的映射， column：查询出来的列名 property：type指定的pojo类型中的属性名 最终resultMap对column和property作一个映射关系（对应关系） result column="username_" property="username"/ /resultMap /mapper
(4).使用resultMap作为statement的输出类型映射
!-- 使用resultMap作为输出映射
resultMap:指定定义的resultMap的id，如果这个resultMap在其它的mapper.xml文件中，前边需要添加namespace命名空间
select id="findUserByIdResultMap" parameterType="int" resultMap="userResultMap"
select id id_,username username_ from t_user where id=#{id}
/select
(5).UserMapper.java代码：
public interface UserMapper {
/** 根据ID查询用户信息,使用resultMap进行输出 */
public User findUserByIdResultMap(int id);
}
(6).JUnit测试代码：
package com.mybatis.test;
import java.io.InputStream;
import java.util.Date;
import java.util.List;
import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
import org.junit.Before;
import org.junit.Test;
import com.mybatis.entity.User;
import com.mybatis.entity.UserQueryVo;
import com.mybatis.mapper.UserMapper;
public class UserMapperTest {
private SqlSessionFactory sqlSessionFactory;
// [email protected]
@Before
public void setUp() throws Exception {
String resource = "SqlMapConfig.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
// 创建SqlSessionFcatory
sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
@Test
public void testFindUserByIdResultMap() {
SqlSession sqlSession = sqlSessionFactory.openSession();
// 创建Usermapper对象，mybatis自动生成mapper代理对象
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
User user = mapper.findUserByIdResultMap(1);
System.out.println(user);
sqlSession.close();
}
3、小结：
用resultType进行输出映射，只有查询出来的列名和pojo中的属性名一致，该列才可以映射成功。
如果查询出来的列名和pojo的属性名不一致，通过定义一个resultMap对列名和pojo属性名之间作一个映射关系。
原创文章，作者：ItWorker，如若转载，请注明出处：https://blog.ytso.com/17273.html
cjavaxml相关文章
- 深入理解mybatis原理(五) MyBatis缓存机制的设计与实现
- Mybatis与Spring集成：SqlSessionTemplate[通俗易懂]
- SpringBoot配置PageHelper分页插件以及配置MyBatis
- mybatis拦截器执行顺序配置_springmvc拦截器执行顺序
- MyBatis框架：第十章：mybatis缓存
- MyBatis框架：第八章：自定义结果集，一对一，一对多，延迟加载，赖加载
- MyBatis框架：第二章：传统mybatis的hello world 示例
- 懒加载(Lazy Loading) – MyBatis懒加载 – Spring懒加载
- Mybatis Generator使用
- Mybatis错误 ：columnNumber: 6; 不允许有匹配 "[xX][mM][lL]" 的处理指令目标。解决方法
- MyBatis-Plus联表查询(Mybatis-Plus-Join)
- Mybatis插件better-mybatis-generator的下载与使用
- MyBatis学习总结(八)——Mybatis3.x与Spring4.x整合详解编程语言
- MyBatis select标签
- MyBatis配置文件（mybatis-config.xml）
- Mybatis操作MySQL存储过程实现数据库交互（mybatis调用mysql存储过程）