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;
 }

UserDao接口

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

 }

UserDaoImpl

测试程序：

 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);
     }

 }

测试UserDao方法

原始的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方法中建议不要使用包装类型（不利于业务层的可扩展）。