【MyBatis学习06】输入映射和输出映射

在前面几篇博文的例子中也可以看到mybatis中输入映射和输出映射的身影，但是没有系统的总结一下，这篇博客主要对这两个东东做一个总结。我们知道mybatis中输入映射和输出映射可以是基本数据类型、hashmap或者pojo的包装类型，这里主要来总结一下pojo包装类型的使用，因为这个在开发中比较常用。

1. 输入映射

输入映射，是在映射文件中通过parameterType指定输入参数的类型，类型可以是简单类型、hashmap、pojo的包装类型。假设现在有个比较复杂的查询需求：完成用户信息的综合查询，需要传入查询条件很复杂（可能包括用户信息、其它信息，比如商品、订单的），那么我们单纯的传入一个User就不行了，所以首先我们得根据查询条件，自定义一个新的pojo，在这个pojo中包含所有的查询条件。

1.1 定义包装类型pojo

　　定义一个UserQueryVo类，将要查询的条件包装进去。这里为了简单起见，就不添加其他的查询条件了，UserQueryVo中就包含一个User，假设复杂的查询条件在User中都已经包含了。

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后，需要在UserMap.xml映射文件中配置查询的statement，如下：

<select id="findUserList" parameterType="mybatis.po.UserQueryVo" resultType="mybatis.po.User">
    select * from user where user.sex = #{user.sex} and user.username like '%${user.username}%'
</select>

我们看到，输入的parameterType的值是我们自己定义的pojo，输出的是User，当然这里的User也可以换成另一个用户自定义的pojo，包含用户所需要的条件，都行，不仅仅局限为User。然后查询条件使用OGNL表达式，取出UserQueryVo中User的相应属性即可。 
　　然后别忘了在SqlMapperConfig.xml中配置好这个UserMapper.xml映射文件。

public interface UserMapper {

    //省去无关代码

    //用户信息综合查询
    public List<User> findUserList(UserQueryVo userQueryVo) throws Exception;
}   

到此为止，我们就做好了自定义的pojo输入映射了，其实并不是很难，下面测试一下这个程序是否正确：

@Test
public void testFindUserList() throws Exception {

    SqlSession sqlSession = sqlSessionFactory.openSession();
    //创建UserMapper对象，mybatis自动生成mapper代理对象
    UserMapper userMapper = sqlSession.getMapper(UserMapper.class);

    //创建包装对象，设置查询条件
    UserQueryVo userQueryVo = new UserQueryVo();
    User user = new User();
    user.setSex("男");
    user.setUsername("山河2016.9.7");
    userQueryVo.setUser(user);

    //调用userMapper的方法
    List<User> list = userMapper.findUserList(userQueryVo);
    System.out.println(list);
}

输入映射比较简单，没有那么多歪门邪道的东东~下面来总结一下输出映射相关的东东。

2.输出映射

输出映射中同样有很多中对象类型，这里也主要总结一下输出pojo对象。mybatis中的与输出映射有关的resultType就不再睡熟了，下面博文都已经提到过了，这里主要总结一下另一个resultMap的使用方法。 
　　我们知道，通过resultType输出映射的时候，查询出来的列名和pojo中对应的属性名要一致才可以做正确的映射，如果不一致就会映射错误。但是如果不一致呢？该如何解决这个问题呢？这就要使用resultMap来映射了。 
　　假设现在映射文件中有个sql语句：SELECT id id_,username username_ FROM USER WHERE id=#{id}，从这个sql语句中可以看出，查询出了id和username两列，但是都起了别名了，也就是说，如果我们现在用resultType去映射到User中的话，肯定会出问题，所以我们现在要定义一个resultMap来做查询结果列与User的属性之间的一个映射。

2.1 定义resultMap

首先我们要定义一个resultMap，如下：

<resultMap type="user" id="userResultMap">
    <id column="id_" property="id"/>
    <result column="username_" property="username"/>
</resultMap>

关于resultMap中的几个属性，简单介绍一下它们的作用：

<resultMap>中的type属性表示 resultMap最终映射的Java对象类型。上面用的是别名，如果没有定义别名，需要使用完全限定名
<resultMap>中的id属性是对这个resultMap的唯一标识。
<resultMap>的子标签<id>表示查询结果集中的唯一标识，因为id是主键。
<resultMap>的子标签<result>表示对查询结果集中普通名映射的定义。
子标签中的column属性：表示查询出来的列名
子标签中的property属性：表示上面type指定的pojo类型中的属性名

2.2 配置UserMapper.xml映射文件

<select id="findUserByIdResultMap" parameterType="int" resultMap="userResultMap">
    SELECT id id_,username username_ from user where id = #{id}
</select>

2.3 定义Mapper接口

public interface UserMapper {

    //省去无关代码

    //根据id查询用户信息，使用resultMap输出
    public User findUserByIdResultMap(int id) throws Exception;
}   

对resultMap的配置和接口处理完之后，我们来写一个测试程序测试一下：

@Test
public void testFindUserByIdResultMap() throws Exception {

    SqlSession sqlSession = sqlSessionFactory.openSession();
    //创建UserMapper对象，mybatis自动生成mapper代理对象
    UserMapper userMapper = sqlSession.getMapper(UserMapper.class);

    User user = userMapper.findUserByIdResultMap(1);
    System.out.println(user);
}

在最后的结果中可以看出，打印出的user中只有sex和username是有值的，其他都是null，因为我们在sql中只要了这两个属性，所以是正常的。 
　　最后总结一下：使用resultType进行输出映射，只有查询出来的列名和pojo中的属性名一致，该列才可以映射成功。如果查询出来的列名和pojo的属性名不一致，通过定义一个resultMap对列名和pojo属性名之间作一个映射关系。