【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，敬请关注。