【Mybatis从0到1-008】MyBatis之映射文件（输入映射、输出映射）

Dear 丶 2022-06-10 12:53 168阅读 0赞

在上一章中，介绍了mybatis的配置文件，在本章中，我们将介绍mybatis的映射文件，MyBatis之所以强大，真正原因在于它的映射语句。

这里主要介绍**输入映射**和**输出映射**。

【1】输入映射

通过parameterType指定输入参数的类型，类型可以是简单类型、hashmap、pojo的包装类型。这里以传递pojo的包装对象为例，还是通过用户表的查询来完成。

需求：完成用户信息的综合查询，需要传入查询条件很复杂（可能包括用户信息、其它信息，比如商品、订单的）

操作：

1.定义包装类型。针对上边需求，建议使用自定义的包装类型的pojo。在包装类型的pojo中将复杂的查询条件包装进去。新建UserQUeryVo.java文件（路径：src\\main\\java\\po\\UserQueryVo.java），代码如下：

public class UserQueryVo { //用户查询条件 private UserCustom userCustom; public UserCustom getUserCustom() { return userCustom; } public void setUserCustom(UserCustom userCustom) { this.userCustom = userCustom; } //可以包装其它的查询条件，订单、商品 //.... }

在上面代码中，private UserCustom userCustom；表示定义一个用户查询的属性，UserCustom是自定义类，是User的扩展。UserCustom.java文件路径：src\\main\\java\\po\\User.java。代码如下：

public class UserCustom extends User { }

2.修改配置文件UserMapper.xml。在UserMapper.xml中定义用户信息综合查询（查询条件复杂，通过高级查询进行复杂关联查询）。代码：

<select id="findUserList" parameterType="po.UserQueryVo" resultType="po.UserCustom"> SELECT *FROM user WHERE user.sex = #{userCustom.sex} AND user.username LIKE '%${userCustom.username}%'
       </select>

3.在接口文件UserMapper中，加入如下代码：

List<UserCustom> findUserList(UserQueryVo userQueryVo) throws Exception;

4.在之前测试文件中，路径为：src\\test\\java\\mapper\\UserMapperTest.java加入如下代码：

//用户信息的综合 查询 @Test public void testFindUserList() throws Exception { SqlSession sqlSession = sqlSessionFactory.openSession(); //创建UserMapper对象，mybatis自动生成mapper代理对象 UserMapper userMapper = sqlSession.getMapper(UserMapper.class); //创建包装对象，设置查询条件 UserQueryVo userQueryVo = new UserQueryVo(); UserCustom userCustom = new UserCustom(); userCustom.setSex("1"); userCustom.setUsername("小明"); userQueryVo.setUserCustom(userCustom); //调用userMapper的方法 List<UserCustom> list = userMapper.findUserList(userQueryVo); System.out.println(list); }

5.运行测试文件，显示如下结果集：

![20170819173923763][]

【2】输出映射（resultType和resultMap）

**resultType：**

使用resultType进行输出映射，只有查询出来的列名和pojo中的属性名一致，该列才可以映射成功。  
如果查询出来的**列名**和pojo中的属性名**全部**不一致，没有创建pojo对象。  
只要查询出来的**列名**和pojo中的属性**有一个**一致，就会创建pojo对象。

2.1 输出简单类型

Demo：对综合**查询的**用户信息的列表，进行计算**总记录数**，通过查询总数和用户综合查询列表可**实现分页**。

\[1\]修改映射文件UserMapper.xml

<select id="findUserCount" parameterType="po.UserQueryVo" resultType="int"> SELECT count(*) FROM USER WHERE user.sex = #{userCustom.sex} AND user.username LIKE '%${userCustom.username}%'
       </select>

\[2\]修改UserMapper.java接口文件，添加代码：

//用户信息综合查询的记录总数 int findUserCount(UserQueryVo userQueryVo) throws Exception;

\[3\]测试代码：(结果为：1条记录)

//用户信息查询记录的总数 @Test public void findUserCount() throws Exception { SqlSession sqlSession = sqlSessionFactory.openSession(); //创建UserMapper对象，mybatis自动生成mapper代理对象 UserMapper userMapper = sqlSession.getMapper(UserMapper.class); //创建包装对象，设置查询条件 UserQueryVo userQueryVo = new UserQueryVo(); UserCustom userCustom = new UserCustom(); userCustom.setSex("1"); userCustom.setUsername("张三丰"); userQueryVo.setUserCustom(userCustom); //调用userMapper的方法 int count = userMapper.findUserCount(userQueryVo); System.out.println(count); }

**resultMap：**

2.2 输出pojo对象和pojo列表

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

1、输出单个pojo对象，方法返回值是单个对象类型

//根据id查询用户基本信息 User findUserById(int id) throws Exception;

2、输出pojo对象list，方法返回值是List<Pojo>

//根据用户名查用户基本信息 List<User> findUserByName(int id) throws Exception;

生成的动态代理对象中是根据mapper方法的**返回值类型**确定是调用selectOne(返回单个对象调用)还是selectList （返回集合对象调用 ）。

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

使用方法：

如果查询出来的列名和pojo的属性名不一致，通过定义一个resultMap对列名和pojo属性名之间作一个映射关系。  
1、定义resultMap  
2、使用resultMap作为statement的输出映射类型

Demo：

SELECT id id\_,username username\_ FROM USERWHERE id=\#\{value\}，User类中属性名和上边查询列名不一致。

操作流程：

\[1\]定义reusltMap,在映射文件UserMapper.xml定义。

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

\[2\]使用resultMap作为statement的输出映射类型，修改映射文件UserMapper.xml

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

\[3\]修改接口文件UserMapper.java

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

\[4\]测试结果

![20170819182950419][]

**【小结】**

使用resultType进行输出映射，只有查询出来的列名和pojo中的属性名一致，该列才可以映射成功。  
如果查询出来的列名和pojo的属性名不一致，通过定义一个resultMap对列名和pojo属性名之间作一个映射关系。

[20170819173923763]: /images/20220610/db951ca1d3234f1693be7e8a2545d450.png
[20170819182950419]: /images/20220610/6831f2beca124ba6890ebe0f87a5cf13.png