文章项目工程结构见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方法中建议不要使用包装类型（不利于业务层的可扩展）。
