mybatis入门基础(四)----输入映射和输出映射

一:输入映射　

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

1.1.传递pojo的包装对象

　1.1.1.需求描述

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

　1.1.2.定义包装类型的pojo

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

包装查询条件的pojo类UserQueryVo类的代码:

package com.mybatis.entity;

/**
 * 
* @ClassName: UserQueryVo 
* @Description: TODO(包装类型)
* @author warcaft
* @date 2015-6-30 上午12:00:41 
*
 */
public class UserQueryVo {
    //这里包装其它的查询条件
    //用户查询条件
    private UserCustom userCustom;

    public UserCustom getUserCustom() {
        return userCustom;
    }

    public void setUserCustom(UserCustom userCustom) {
        this.userCustom = userCustom;
    }
    //可以包装其它查询条件......

}

 UserCustom类的代码

package com.mybatis.entity;
/**
 * 
* @ClassName: UserCustom 
* @Description: TODO(用户的扩展类) 
* @author warcaft
* @date 2015-6-30 上午12:02:37 
*
 */
public class UserCustom extends User{
    //可以扩展用户的信息
}

 UserMapper.xml的代码

　　在UserMapper.xml中定义用户信息综合查询（假设查询条件很复杂，通过高级查询复杂关联查询）

<!-- 模拟包装类型组合查询 
    #{userCustom.sex}:取出pojo包装对象中性别值
    ${userCustom.username}：取出pojo对象中姓名值
-->
    <select id="findUserList" parameterType="com.mybatis.entity.UserQueryVo" 
   　　　　　 resultType="com.mybatis.entity.UserCustom">
      　　where sex=#{userCustom.sex} and username LIKE '%${userCustom.username}%'
    </select>

UserMapper.java类的代码

/**
 * 
 * @ClassName: UserMapper
 * @Description: TODO(用户管理mapper接口)
 * @author warcaft
 * @date 2015-6-30 上午12:14:56
 * 
 */
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("2");
        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();
    }
}

二:输出映射

1.resultType

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

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

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

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接口地址
 -->
<!-- 用户信息综合查询总数
     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.java的代码

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("2");
        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();
    }
}

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

1.2.输出pojo对象和pojo列表 　　

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

　　在mapper.java指定的方法返回值类型不一样。

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

public interface UserMapper {
    /** 根据ID查询用户信息 */
    public User findUserById(int id);
}

　1.2.2.输出pojo对象list，方法返回值是List<pojo>

public interface UserMapper {
    /** 根据用户名称模糊查询用户信息 */
    public List<User> findUserByName(String username);
}

小结：生成的动态代理对象中是根据mapper.java方法的返回值类型确定是调用selectOne(返回单个对象调用)还是selectList(返回集合对象调用)

1.3.输出类型resultMap

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

　1.3.1.resultMap使用方法

　　　　(1).定义resultMap

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

　1.3.2.demo例子

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

　　　　select id id_,username username_ 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属性名之间作一个映射关系。