【mybatis深度历险系列】mybatis中的输入映射和输出映射

在前面的博文中，小编介绍了mybatis的框架原理以及入门程序，还有mybatis中开发到的两种方法，原始开发dao的方法和mapper代理方法，今天博文，我们来继续学习mybatis中的相关知识，随着小编的脚步，今天小编要向小伙伴们介绍的是mybatis中的输入映射和输出映射。

一、输入映射

通过parameterType指定输入参数的类型，类型可以是简单类型、hashmap、pojo的包装类型。

a、传递pojo的包装对象

1）需求描述

完成用户信息的综合查询，需要传入的查询条件可能很复杂(可能包括用户信息，其它信息，比如，商品，订单等等)。

2）定义包装类型的pojo

针对上边的需求，建议使用自定义的包装类型pojo，在包装类型的pojo中将复杂的查询条件包装进去。

第一步、包装条件查询pojo类的UserQueryVo类的代码，如下所示：

package cn.itcast.mybatis.po; import java.util.List; /** * * <p>Title: UserQueryVo</p> * <p>Description:包装类型 </p> * <p>Company: www.itcast.com</p> * @author 丁国华 * @date 2016年8月7日 10:20:38 * @version 1.0 */ public class UserQueryVo { //在这里包装所需要的查询条件 //用户查询条件 private UserCustom userCustom; public UserCustom getUserCustom() { return userCustom; } public void setUserCustom(UserCustom userCustom) { this.userCustom = userCustom; } //可以包装其它的查询条件，订单、商品 //.... }

第二步、编写UserCustom类的代码，如下所示：

package cn.itcast.mybatis.po; /** * * @ClassName: UserCustom * @Description: 用户的扩展类 * @author 丁国华 * @date 2016年8月7日 11:47:20 * */ public class UserCustom extends User { //可以扩展用户的信息 } 第三步、编写UserMapper.xml的代码，在UserMapper.xml中定义用户信息综合查询，假设查询条件很复杂，通过高级查询复杂关联查询，如下所示：

<!-- 用户信息综合查询 #{userCustom.sex}:取出pojo包装对象中性别值 ${userCustom.username}：取出pojo包装对象中用户名称 --> <select id="findUserList" parameterType="cn.itcast.mybatis.po.UserQueryVo" resultType="cn.itcast.mybatis.po.UserCustom"> SELECT * FROM USER WHERE user.sex=#{userCustom.sex} ADN user.username LIKE '%${userCustom.username}%' </select> 第四步、编写UserMapper.java类中的代码如下所示： /** * * @ClassName: UserMapper * @Description: 用户管理mapper接口 * @author 丁国华 * @date2016年8月7日 11:51:06 * */ public interface UserMapper { // 用户信息综合查询 public List<UserCustom> findUserList(UserQueryVo userQueryVo); }

第五步、编写junit单元测试代码

ackage com.mybatis.dao.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.UserCustom; import com.mybatis.entity.UserQueryVo; import com.mybatis.mapper.UserMapper; public class UserMapperTest { private SqlSessionFactory sqlSessionFactory; // 此方法是在执行findUserByIdTest之前执行 @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(); UserCustom userCustom = new UserCustom(); userCustom.setSex("女"); userCustom.setUsername("丁国华"); userQueryVo.setUserCustom(userCustom); // 创建Usermapper对象，mybatis自动生成mapper代理对象 UserMapper mapper = sqlSession.getMapper(UserMapper.class); List<UserCustom>list=mapper.findUserList(userQueryVo); System.out.println(list); sqlSession.commit(); sqlSession.close(); } }

接着，我们来学习输出映射，学习之前小编先来简单的介绍一下resultType以及需求。

a.resultType

使用resultType进行输出映射，只有查询出来的列名和pojo中的属性名一致，该列才可以映射成功。

如果查询出来的列名和pojo中的属性名全部不一致，没有创建pojo对象。

只要查询出来的列名和pojo中的属性有一个一致，就会创建pojo对象。

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接口地址 --> <!-- 用户信息综合查询总数 parameterType:指定输入类型，和findUserList一致。 resultType:输出结果类型. --> <mapper namespace="com.mybatis.mapper.UserMapper"> <select id="findUserCount" parameterType="com.mybatis.entity.UserQueryVo" resultType="int"> select count(*) from t_user where sex=#{userCustom.sex} and username like '%${userCustom.username}%' </select> </mapper> 第二步、编写UserMapper的代码部分，如下所示： public interface UserMapper { //用户信息综合查询总数 public int findUserCount(UserQueryVo userQueryVo); }

第三步、编写Junit单元测试代码，如下所示：

package com.mybatis.dao.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.UserCustom; import com.mybatis.entity.UserQueryVo; import com.mybatis.mapper.UserMapper; public class UserMapperTest { private SqlSessionFactory sqlSessionFactory; // 此方法是在执行findUserByIdTest之前执行 @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(); UserCustom userCustom = new UserCustom(); userCustom.setSex("女"); userCustom.setUsername("丁丁"); userQueryVo.setUserCustom(userCustom); // 创建Usermapper对象，mybatis自动生成mapper代理对象 UserMapper mapper = sqlSession.getMapper(UserMapper.class); int count=mapper.findUserCount(userQueryVo); System.out.println(count); sqlSession.commit(); sqlSession.close(); } }

小结：查询出来的结果集只有一行一列，可以使用简单类型进行输出映射。

2）输出pojo对象和pojo列表　　

  不管是输出的pojo单个对象还是一个列表（list中包括pojo），在mapper.xml中resultType指定的类型是一样的。在mapper.java指定的方法返回值类型不一样。

3）输出单个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(返回集合对象调用)

输出类型resultMap

mybatis中使用resultMap完成高级输出结果映射。

resultMap使用方法

(1).定义resultMap

(2).使用resultMap作为statement的输出映射类型

demo

(1).需求：将下面的sql使用User完成映射

select id id_,usernameusername_ from t_user where id=?

User类中属性名和上边的列名不一致。

(2).定义resultMap　　　

例子

(1).需求：将下面的sql使用User完成映射

select id id_,usernameusername_ from t_user where id=?

User类中属性名和上边的列名不一致。

(2).定义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接口地址 --> <!-- 用户信息综合查询总数 parameterType:指定输入类型，和findUserList一致。 resultType:输出结果类型. --> <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>

(3).使用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> UserMapper.java代码 public interface UserMapper { /** 根据ID查询用户信息,使用resultMap进行输出 */ public User findUserByIdResultMap(int id); }

Junit测试代码:

package com.mybatis.dao.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.UserCustom; import com.mybatis.entity.UserQueryVo; import com.mybatis.mapper.UserMapper; public class UserMapperTest { private SqlSessionFactory sqlSessionFactory; // 此方法是在执行findUserByIdTest之前执行 @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(); } }

小编寄语：用resultType进行输出映射，只有查询出来的列名和pojo中的属性名一致，该列才可以映射成功。如果查询出来的列名和pojo的属性名不一致，通过定义一个resultMap对列名和pojo属性名之间作一个映射关系。该博文，小编主要简单介绍了mybatis中的输出映射和输入映射，通过demo简单的介绍了输入映射和输出映射，希望对有需要的小伙伴有帮助，不足之处，还请小伙伴多多指教，下篇博文中，小编将介绍mybatis中的动态sql，敬请关注。