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屬性名之間作一個對映關係。