文章项目工程结构见mybatis入门之增删改查

一 、SqlSession使用范围

1.1 SqlSessionFactoryBuilder

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

1.2 SqlSessionFactory

通过SqlSessionFactory创建SqlSession，使用单例模式管理sqlSessionFactory（工厂一旦创建，使用一个实例）。

将来mybatis和spring整合后，使用单例模式管理sqlSessionFactory。

1.3 SqlSession

SqlSession是一个面向用户（程序员）的接口,可以直接调用方法执行对应的sql
SqlSession中提供了很多操作数据库的方法：如：selectOne(返回单个对象)、selectList（返回单个或多个对象）、。

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

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

二 、原始dao开发方法（程序员需要写dao接口和dao实现类）

2.1 思路

程序员需要写dao接口和dao实现类。
需要向dao实现类中注入SqlSessionFactory，在方法体内通过SqlSessionFactory创建SqlSession

2.2 dao接口

在项目下新建package cn.euegene.dao,并且在该包下新建UserDao接口

package cn.eugene.dao;

import cn.eugene.po.User;

public interface UserDao {
    
    public User selectUserById(int id);
    public void insertUser(User user);
    public void deleteUser(int id);

}

2.3 dao接口实现类

在package—— cn.euegene.dao下新建UserDao实现类UserDaoImpl

package cn.eugene.dao;

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

import cn.eugene.po.User;

public class UserDaoImpl implements UserDao {

   //通过dao向实现类中注入SqlSessionFactory
   private SqlSessionFactory sqlSessionFactory;
   public UserDaoImpl(SqlSessionFactory sqlSessionFactory){
       this.sqlSessionFactory =sqlSessionFactory;
   }
   @Override
   public User selectUserById(int id) {
       // TODO Auto-generated method stub
       SqlSession sqlSession = sqlSessionFactory.openSession();
       //执行查询操作
       User user = sqlSession.selectOne("test.findUserById",id);
       //释放资源
       sqlSession.close();
       return user;
   }

   @Override
   public void insertUser(User user) {
       // TODO Auto-generated method stub
       SqlSession sqlSession = sqlSessionFactory.openSession();
       //执行插入操作
       sqlSession.insert("test.insertUser",user);
       //提交代码
       sqlSession.commit();
       //释放资源
       sqlSession.close();
       
   }

   @Override
   public void deleteUser(int id) {
       // TODO Auto-generated method stub
       SqlSession sqlSession = sqlSessionFactory.openSession();
       //执行删除操作
       sqlSession.delete("test.updateUser",id);
       //提交代码
       sqlSession.commit();
       //释放资源
       sqlSession.close();
   }

}

2.4 测试代码

项目要引入Junit测试，测试dao接口的 实现类

package cn.eugene.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 cn.eugene.po.User;

public class UserDaoImplTest {
    private SqlSessionFactory sqlSessionFactory;
    @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 testSelectUserById() {
        
        UserDao userDao = new UserDaoImpl(sqlSessionFactory);
        User user = userDao.selectUserById(1);
        System.out.println(user);
        
    }

}

2.5 总结原始 dao开发问题

1、dao接口实现类方法中存在大量模板方法，设想能否将这些代码提取出来，大大减轻程序员的工作量。

2、调用sqlsession方法时将statement的id硬编码了，如sqlSession.selectOne("test.findUserById",id)

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

三、mapper代理方法（程序员只需要编写mapper接口，想当于dao接口）

3.1 思路（mapper代理开发规范）

程序员还需要编写mapper.xml映射文件

程序员编写mapper接口需要遵循一些开发规范，mybatis可以自动生成mapper接口实现类代理对象。

开发规范：

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

<mapper namespace="cn.eugene.mapper.UserMapper">

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

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

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

    <select id="findUserById" parameterType="int" resultType="cn.eugene.po.User">
        select * from user where id = #{id}
    </select>

总结：
以上开发规范主要是对下边的代码进行统一生成：

User user = sqlSession.selectOne("test.findUserById", id);
sqlSession.insert("test.insertUser", user);
。。。。

3.2 mapper接口

在项目下新建包cn.enugene.mapper，新建接口UserMapper

package cn.eugene.mapper;

import cn.eugene.po.User;

public interface UserMapper {
    
    public  User findUserById(int id) throws Exception;
    
    public void deleteUser(int id) throws Exception;
    
    public void updateUser(User user) throws Exception;

}

3.3 mapper.xml （sql映射文件)

在config下新建file floder ——mapper，新建userMapper2.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="cn.eugene.mapper.UserMapper">
    <!-- 根据id查询用户信息 -->
    <select id="findUserById" parameterType="int" resultType="cn.eugene.po.User">
        select * from user where id = #{id}
    </select>
    
     <!-- 根据用户名查询用户信息 -->
     <select id="findUserByName" parameterType="java.lang.String" resultType="cn.eugene.po.User">
        select * from user where userName like '%${value}%'
    </select>
    <insert id="insertUser" parameterType="cn.eugene.po.User">
        insert into user(userName,userAge,userAddress)VALUES(#{userName},#{userAge},#{userAddress})
    </insert>

    <!-- 根据id删除用户 -->
    <delete id="deleteUser" parameterType="int">
        delete from user where id = #{id}
    </delete>
    
    <update id="updateUser" parameterType="cn.eugene.po.User">
        update user set userName=#{userName},userAge=#{userAge},userAddress=#{userAddress} where id= #{id}
    </update>
</mapper>

3.4 在配置文件中加载sql映射文件

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

3.5 测试

同样使用junit对mapper接口进行测试

package cn.eugene.mapper;

import static org.junit.Assert.*;

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.eugene.po.User;

public class UserMapperTest {
    private SqlSessionFactory sqlSessionFactory;
    @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();
        //mybatis自动生成接口实现类代理对象
        UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
        User user = userMapper.findUserById(1);
        System.out.println(user);
    }

}

四 、一些问题总结

4.1 代理对象内部调用selectOne或selectList

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

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

4.2 mapper接口方法参数只能有一个是否影响系统 开发

mapper接口方法参数只能有一个，系统是否不利于扩展维护。

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

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