Mybatis学习（2）原始dao开发和使用mapper接口代理开发

基础知识：

1).SqlSessionFactoryBuilder:

 通过SqlSessionFactoryBuilder创建会话工厂SqlSessionFactory。将SqlSessionFactoryBuilder当成一个工具类使用即可，不需要使用单例管理SqlSessionFactoryBuilder。

在需要创建SqlSessionFactory时候，只需要new一次SqlSessionFactoryBuilder即可。

2).SqlSessionFactory:

通过SqlSessionFactory创建SqlSession，使用单例模式管理sqlSessionFactory（工厂一旦创建，使用一个实例）。将来mybatis和spring整合后，使用单例模式管理sqlSessionFactory。

3).SqlSession:

SqlSession是一个面向用户（程序员）的接口。

SqlSession中提供了很多操作数据库的方法：如：selectOne(返回单个对象)、selectList（返回单个或多个对象）、。

SqlSession是线程不安全的，在SqlSesion实现类中除了有接口中的方法（操作数据库的方法）还有数据域属性。

SqlSession最佳应用场合在方法体内，定义成局部变量使用。

一、原始dao开发方法（）

需要编写dao接口和实现类；

dao接口：

package com.cy.Dao;

import java.util.List;

import com.cy.po.User;

/**
 * dao接口，用户管理
 * @author chengyu
 *
 */
public interface UserDao {
        //根据id查询用户信息
        public User findUserById(int id) throws Exception;
        
        //根据用户名列查询用户列表
        public List<User> findUserByName(String name) throws Exception;
        
        //添加用户信息
        public void insertUser(User user) throws Exception;
        
        //删除用户信息
        public void deleteUser(int id) throws Exception;
}

dao接口实现类：

package com.cy.Dao;

import java.util.List;

import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;

import com.cy.po.User;

/**
 * dao接口实现类
 * @author chengyu
 *
 */
public class UserDaoImpl implements UserDao {
    // 需要向dao实现类中注入SqlSessionFactory
    // 这里通过构造方法注入
    private SqlSessionFactory sqlSessionFactory;

    public UserDaoImpl(SqlSessionFactory sqlSessionFactory) {
        this.sqlSessionFactory = sqlSessionFactory;
    }

    @Override
    public User findUserById(int id) throws Exception {
        SqlSession sqlSession = sqlSessionFactory.openSession();
        User user = sqlSession.selectOne("test.findUserById", id);
        
        // 释放资源
        sqlSession.close();
        return user;
    }

    @Override
    public List<User> findUserByName(String name) throws Exception {
        SqlSession sqlSession = sqlSessionFactory.openSession();
        List<User> list = sqlSession.selectList("test.findUserByName", name);
        sqlSession.close();
        return list;
    }

    @Override
    public void insertUser(User user) throws Exception {
        SqlSession sqlSession = sqlSessionFactory.openSession();
        sqlSession.insert("test.insertUser", user);
        sqlSession.commit();
        sqlSession.close();

    }

    @Override
    public void deleteUser(int id) throws Exception {
        SqlSession sqlSession = sqlSessionFactory.openSession();
        sqlSession.delete("test.deleteUser", id);
        sqlSession.commit();
        sqlSession.close();
    }

}

测试程序：

package com.cy.Dao;

import static org.junit.Assert.*;

import java.io.InputStream;

import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
import org.junit.Before;
import org.junit.Test;

import com.cy.po.User;

public class UserDaoImplTest {
    private SqlSessionFactory sqlSessionFactory;
    
    // 此方法是在执行testFindUserById之前执行
    @Before
    public void setUp() throws Exception {
        // mybatis配置文件
        String resource = "SqlMapConfig.xml";
        // 得到配置文件流
        InputStream inputStream = Resources.getResourceAsStream(resource);

        // 创建会话工厂，传入mybatis的配置文件信息
        sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
    }
        
    @Test
    public void testFindUserById() throws Exception {
        // 创建UserDao的对象
        UserDao userDao = new UserDaoImpl(sqlSessionFactory);

        // 调用UserDao的方法
        User user = userDao.findUserById(1);
        
        System.out.println(user);
    }

}

原始的dao开发方法问题总结：

1）dao接口实现类方法中存在大量模板方法。

2）调用sqlsession方法时将statement的id硬编码了

3）调用sqlsession方法时传入的变量，由于sqlsession方法使用泛型，即使变量类型传入错误，在编译阶段也不报错，不利于开发。

二、使用mapper接口（相当于dao接口)代理开发方法：

开发规范：遵循这些开发规范，mybatis可以自动生成mapper接口实现类代理对象。

1）在mapper.xml中namespace等于mapper接口地址

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

3）mapper.java接口中的方法输入参数类型和mapper.xml中statement的parameterType指定的类型一致

4）mapper.java接口中的方法返回值类型和mapper.xml中statement的resultType指定的类型一致

UserMapper接口：

package com.cy.mapper;

import java.util.List;

import com.cy.po.User;

/**
 * mapper接口，用户管理
 * @author chengyu
 *
 */
public interface UserMapper {
    //根据id查询用户信息
    public User findUserById(int id) throws Exception;
        
    //根据用户名列查询用户列表
    public List<User> findUserByName(String name)throws Exception;
        
    //插入用户
    public void insertUser(User user)throws Exception;
        
    //删除用户
    public void deleteUser(int id)throws Exception;
}

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">

<!--使用mapper代理方法开发，namespace有特殊重要的作用,namespace等于mapper接口地址-->
<mapper namespace="com.cy.mapper.UserMapper">
    <!--通过id查询用户 -->
    <select id="findUserById" parameterType="int" resultType="com.cy.po.User">
        SELECT * FROM USER WHERE id=#{value}
    </select>
    
    <!-- 根据用户名称模糊查询用户信息，可能返回多条-->
    <select id="findUserByName" parameterType="java.lang.String" resultType="com.cy.po.User">
        SELECT * FROM USER WHERE username LIKE '%${value}%'
    </select>
    
    <!-- 添加用户 -->
    <insert id="insertUser" parameterType="com.cy.po.User">
        <selectKey keyProperty="id" order="AFTER" resultType="java.lang.Integer">
            SELECT LAST_INSERT_ID()
        </selectKey>
        insert into user(username,birthday,sex,address) value(#{username},#{birthday},#{sex},#{address})
    </insert>
    
    <!-- 根据id删除 用户-->
    <delete id="deleteUser" parameterType="java.lang.Integer">
        delete from user where id=#{id}
    </delete>
    
    <!-- 根据id更新用户 -->
    <update id="updateUser" parameterType="com.cy.po.User">
        update user set username=#{username},birthday=#{birthday},sex=#{sex},address=#{address} 
            where id=#{id}
    </update>
</mapper>

将UserMapper.xml映射文件加入：

<!-- 加载 映射文件 -->
    <mappers>
        <mapper resource="mapper/UserMapper.xml"/>
    </mappers>

UserMapper接口的测试方法：

package com.cy.mapper;

import static org.junit.Assert.*;

import java.io.InputStream;
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.cy.po.User;

public class UserMapperTest {

    private SqlSessionFactory sqlSessionFactory;

    @Before
    public void setUp() throws Exception {

        String resource = "SqlMapConfig.xml";
        InputStream inputStream = Resources.getResourceAsStream(resource);
        sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
    }
    
    @Test
    public void testFindUserById() throws Exception {
        SqlSession sqlSession = sqlSessionFactory.openSession();
        
        //创建UserMapper对象，mybatis自动生成mapper代理对象
        UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
        
        User user = userMapper.findUserById(1);
        System.out.println(user);
    }
    @Test
    public void testFindUserByName() throws Exception {
        SqlSession sqlSession = sqlSessionFactory.openSession();
        
        //创建UserMapper对象，mybatis自动生成mapper代理对象
        UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
        
        List<User> list = userMapper.findUserByName("小明");
        sqlSession.close();
        System.out.println(list);
    }
}

关于mapper接口代理开发的一些问题：

1.代理对象内部是调用selectOne还是selectList？

如果mapper方法返回单个pojo对象（非集合对象），代理对象内部通过selectOne查询数据库。

如果mapper方法返回集合对象，代理对象内部通过selectList查询数据库。

2、mapper接口方法参数只有一个是否影响开发？

系统框架中，dao层的代码是被业务层公用的。即使mapper接口只有一个参数，可以使用包装类型的pojo满足不同的业务方法的需求。

注意：持久层方法的参数可以包装类型、map。。。，service方法中建议不要使用包装类型（不利于业务层的可扩展）。