【MyBatis框架】Mybatis開發dao方法第二部分

下面來繼續討論mybatis開發Dao的方法

咱們前面使用原始的Dao開發方法，發現了許多弊端，咱們下面使用mapper代理來寫Dao方法。

1.mapper代理方法（程序員只須要mapper接口（至關 於dao接口））
開發人員須要先編寫Mapper接口(至關 於dao接口)，須要遵循一些開發規範，mybatis能夠自動生成mapper接口實現類代理對象。

package cn.edu.hpu.mybatis.mapper;

import cn.edu.hpu.mybatis.PO.User;

//用戶管理的Dao接口
public interface UserMapper {
    
    //根據Id查詢用戶信息
    public User findUserById(int id) throws Exception;
    
    //添加用戶信息
    public void insertUser(User user) throws Exception;
    
    //刪除用戶信息
    public void deleteUser(int id) throws Exception;
    
    //修改用戶信息
    public void updateUser(User user) throws Exception;


    //根據姓名查找用戶
    public List<User> findUserByUserName(String username) throws Exception;
}

開發人員還要編寫mapper.xml映射文件

咱們在src同文件夾下的config文件夾下建立mapper包，在包下建立UserMapper.xml文件，內容同以前寫過的User.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有特殊重要的做用，就是對應的mapper接口地址 -->
<mapper namespace="cn.edu.hpu.mybatis.mapper.UserMapper">
    <!-- 在映射文件中配置不少sql語句 -->
    
    <!-- 需求:經過id查詢用戶表的記錄 -->
    <!-- 經過select執行數據庫查詢，
         id:標示映射文件中的sql，成爲Statement的id 
         將sql語句封裝到mappedStatement對象中，因此將id稱爲statement的id,
         
         parameterType:指定輸入參數的類型，
         
         #{}標示一個佔位符,
         
         #{id}其中id表示接收輸入參數的名稱，若是輸入參數是簡單類型，那麼#{}中的值能夠任意(如value)。
         
         resultType：指定sql輸出結果的映射的java對象類型，
         select指定resultType表示將單條記錄映射成java對象-->    
    <select id="findUserById" parameterType="int" resultType="cn.edu.hpu.mybatis.PO.User">
      SELECT * FROM USER WHERE id=#{id}
    </select>
    
    <!-- ${}:表示拼接sql串，將接收到的參數內容不加任何修飾拼接在sql中。
         使用${}拼接sql，引發sql注入。
         ${}中只能使用value-->
    <select id="findUserByUserName" parameterType="java.lang.String" 
            resultType="cn.edu.hpu.mybatis.PO.User">
       select * from user where username like '%${value}%' 
    </select>
    
    <!-- 添加用戶
    parameterType：指定輸入參數類型是pojo(包括用戶信息) 
    #{}中指定POJO的屬性名，接收到POJO對象的屬性值，mybatis經過OGNL獲取對象的屬性
    -->
    <insert id="insertUser" parameterType="cn.edu.hpu.mybatis.PO.User">
        <!-- 將插入數據的主鍵返回，返回到user對象中。
        SELECT_INSERT_ID():獲得剛insert進去的主鍵值，只適用於自增主鍵 
        KeyProperty:將查詢到主鍵值設置到parameterType指定對象的哪一個屬性。
        order:SELECT LAST_INSERT_ID()執行順序，相對於insert語句來講它的執行順序
        -->
        <selectKey keyProperty="id" order="AFTER" resultType="java.lang.Integer">
            SELECT LAST_INSERT_ID()
        </selectKey>
        
        <!-- 使用MySql的UUID來生成主鍵
        執行過程:
        首先經過uuid()獲得主鍵，將主鍵設置到user對象的id屬性中
        其次在insert執行時，從user對象中取出id屬性值 
        <selectKey keyProperty="id" order="BEFORE" resultType="java.lang.String">
            SELECT uuid()
        </selectKey>
        insert into user(id,birthday,sex,address) value(#{id},#{birthday,jdbcType=DATE},#{sex},#{address})-->
        
        insert into user(username,birthday,sex,address) value(#{username},#{birthday,jdbcType=DATE},#{sex},#{address})
    </insert>
    
    <!-- 刪除用戶 -->
    <delete id="deleteUser" parameterType="java.lang.Integer">
        delete from user where id=#{id}
    </delete>
    
    <!-- 更新用戶 
    分析:
    須要傳入用戶的id，須要傳入用戶的更新信息.
    parameterType指定user對象，包括id和更新信息(注意:id必須存在)
    #{id}:從輸入user對象中獲取id屬性值-->
    <update id="updateUser" parameterType="cn.edu.hpu.mybatis.PO.User">
        update user set username=#{username},birthday=#{birthday,jdbcType=DATE},sex=#{sex},address=#{address} 
        where id=#{id}
    </update>
</mapper>

別忘記在SqlMapConfig.xml中加載映射文件
<!-- 加載映射文件 -->

<mappers>
    <mapper resource="mapper/UserMapper.xml"/>
</mappers>

開發規範:
A、在mapper.xml中namespace等於mapper接口地址
!-- namespace命名空間，做用就是對sql進行分類化管理，理解sql隔離
注意:使用mapper代理方法開發，namespace有特殊重要的做用，就是對應的mapper接口地址 -->

<mapper namespace="cn.edu.hpu.mybatis.mapper.UserMapper">
......
</mapper>

B、mapper.java接口中的方法名和mapper.xml中statement的id一致

public findUserById()
對應
<select id="findUserByUsername" ...

C、mapper.java接口中的方法輸入參數類型和mapper.xml中statement的parameterType指定的類型一致。
public findUserById(int id)
對應
<select id="findUserById" parameterType="int" 

D、mapper.java接口中的方法返回值類型和mapper.xml中statement的resultType指定的類型一致。
public User findUserById(int id)
對應
<select id="findUserById" parameterType="int" resultType="cn.edu.hpu.mybatis.PO.User">

遵循這些開發規範，mybatis能夠自動生成mapper接口實現類代理對象。

總結：
以上開發規範主要是對下邊的代碼進行統一輩子成：

User user=sqlSession.selectOne("test.findUserById",id);
sqlSession.insert("test.insertUser",user);
mapper.java與mapper.xml互聯互助
接下來咱們直接根據接口來測試:

package cn.edu.hpu.mybatis.test;

import java.io.InputStream;

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 cn.edu.hpu.mybatis.PO.User;
import cn.edu.hpu.mybatis.mapper.UserMapper;


public class UserMapperTest {


    private SqlSessionFactory sqlSessionFactory;
    
    //註解Before是在執行本類全部測試方法以前先調用這個方法
    @Before 
    public void setup() throws Exception{
        //建立SqlSessionFactory
        String resource="SqlMapConfig.xml";
        
        //將配置文件加載成流
        InputStream inputStream = Resources.getResourceAsStream(resource);
        //建立會話工廠，傳入mybatis配置文件的信息
        sqlSessionFactory=new SqlSessionFactoryBuilder().build(inputStream);
    }
    
    @Test 
    public void testFindUserById() throws Exception{
        
        SqlSession sqlSession=sqlSessionFactory.openSession();
        
        //建立UserMapper代理對象
        UserMapper userMapper=sqlSession.getMapper(UserMapper.class);
        
        //調用userMapper的方法
        User user=userMapper.findUserById(1);
        
        System.out.println(user.getUsername());
    }
}

這裏咱們使用mapper代理的方法，不須要方法的實現體就完成了查找方法，是否是很輕鬆?
其餘增刪改寫的方法與上面差很少，可是，當咱們實現利用姓名模糊查詢的時候，返回的是List集合的數據，咱們要注意:

2.一些問題總結
2.1代理對象內部調用selectOne或selectList
若是mapper方法返回單個pojo對象（非集合對象），代理對象內部經過selectOne查詢數據庫。
若是mapper方法返回集合對象，代理對象內部經過selectList查詢數據庫。
這些是MyBatis內部自動執行的，是否是很方便？咱們能夠測試一下是否是這樣:
測試方法:

@Test 
    public void testFindUserByUserName() throws Exception{
        
        SqlSession sqlSession=sqlSessionFactory.openSession();
        
        //建立UserMapper代理對象
        UserMapper userMapper=sqlSession.getMapper(UserMapper.class);
        
        //調用userMapper的方法
        List<User> users=userMapper.findUserByName("張三");
        
        for (int i = 0; i < users.size(); i++) {
            User user=(User)users.get(i);
            System.out.println(user.getId()+":"+user.getUsername());
        }
    }

測試成功，說明MyBatis內部確實是這麼作的
咱們發現，mapper接口中的參數好像只有一個，Mybatis內部好像也只能自動處理一個參數的mapper方法，那麼mapper接口方法參數只能有一個是否影響系統開發？
問:mapper接口方法參數只能有一個，系統是否不利於擴展維護。

答：
系統 框架中，dao層的代碼是被業務層公用的。
即便mapper接口只有一個參數，可使用包裝類型的pojo知足不一樣的業務方法的需求。

注意：持久層方法的參數能夠包裝類型、map。。。，service方法中建議不要使用包裝類型（不利於業務層的可擴展）。