mybatis开发dao的方法通常用两种,一种是传统DAO的方法,一种是基于mapper代理的方法,下面学习这两种开发模式.
写dao之前应该要对SqlSession有一个更加细致的了解
一.mybatis的SqlSession使用范围
- SqlSessionFactoryBuilder用于创建SqlSessionFacoty,SqlSessionFacoty一旦创建完成就不需要SqlSessionFactoryBuilder了,因为SqlSession是通过SqlSessionFactory生产,所以可以将SqlSessionFactoryBuilder当成一个工具类使用,最佳使用范围是方法范围即方法体内局部变量。
- SqlSessionFactory是一个接口,接口中定义了openSession的不同重载方法,SqlSessionFactory的最佳使用范围是整个应用运行期间,一旦创建后可以重复使用,通常以单例模式管理SqlSessionFactory。
- SqlSession中封装了对数据库的操作,如:查询、插入、更新、删除等。通过SqlSessionFactory创建SqlSession,而SqlSessionFactory是通过SqlSessionFactoryBuilder进行创建。
- SqlSession是一个面向用户的接口,sqlSession中定义了数据库操作,默认使用DefaultSqlSession实现类。
具体执行过程如下:
- 加载数据源等配置信息Environment environment = configuration.getEnvironment();
- 创建数据库链接
- 创建事务对象创建Executor,SqlSession所有操作都是通过Executor完成
对应源码:
if (ExecutorType.BATCH == executorType) {
executor = newBatchExecutor(this, transaction);
} elseif (ExecutorType.REUSE == executorType) {
executor = new ReuseExecutor(this, transaction);
} else {
executor = new SimpleExecutor(this, transaction);
}
if (cacheEnabled) {
executor = new CachingExecutor(executor, autoCommit);
}
结论得出
每个线程都应该有它自己的SqlSession实例。SqlSession的实例不能共享使用,它也是线程不安全的。因此最佳的范围是请求或方法范围。绝对不能将SqlSession实例的引用放在一个类的静态字段或实例字段中。
打开一个 SqlSession;使用完毕就要关闭它。通常把这个关闭操作放到 finally 块中以确保每次都能执行关闭。
二.传统DAO开发方法
传统的方法是建立dao接口定义方法,然后创建其实现类,实现dao中的方法.下面代码用的还是第一篇的例子
无论是哪种开发方法,mapper.xml都要写的,mapper映射也都需要在SqlMapperConfig.xml中配置的
1.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">
<!--命名空间,用于隔离sql语句,后面会讲另一层非常重要的作用。-->
<mapper namespace="test">
<!--根据id查询出用户信息(查询一条数据)-->
<select id="findUserById" parameterType="int" resultType="com.aust.model.User">
SELECT * FROM user WHERE id=#{id}
</select>
<!--根据名称进行模糊查询(查询出多条数据)-->
<select id="findUserByName" parameterType="java.lang.String" resultType="com.aust.model.User">
SELECT * from user WHERE nickname LIKE ‘%${value}%‘
</select>
<!--插入一个用户-->
<insert id="insertUser" parameterType="com.aust.model.User">
<selectKey keyProperty="id" resultType="java.lang.Integer" order="AFTER" >
SELECT last_insert_id()
</selectKey>
INSERT INTO user(username,password,nickname,status) VALUE (#{username},#{password},#{nickname},#{status})
</insert>
<!--删除一个用户-->
<delete id="deleteUser" parameterType="int">
DELETE FROM user WHERE id =#{id}
</delete>
<!--更新用户-->
<update id="updateUser" parameterType="com.aust.model.User">
UPDATE user SET username=#{username},password=#{password},nickname=#{nickname} WHERE id = #{id}
</update>
</mapper>
2.配置mapper映射
在SqlMapperConfig,xml中配置即可
<!--配置mappeer映射-->
<mappers>
<mapper resource="mapper/User.xml"/>
</mappers>
3.实现dao接口
public interface UserDao {
//根据id查询用户
public User findUserById(int id);
//根据姓名模糊查询用户
public List<User> findUserByName(String name);
//插入一个用户,返回主键
public int insertUser(User user);
//删除一个用户
public boolean deleteUser(int id);
//更新一个用户
public boolean updateUser(User user);
}
4.实现dao接口的实现类
public class UserDaoImp implements UserDao{
private SqlSessionFactory factory;
//通过构造注入SqlSessionFactory,后期整合spring,全部交给spring管理
public UserDaoImp(SqlSessionFactory factory) {
this.factory = factory;
}
@Override
public User findUserById(int id) {
//放在方法体内创建,保证线程安全
SqlSession session = factory.openSession();
User user = session.selectOne("test.findUserById",id);
session.close();
return user;
}
@Override
public List<User> findUserByName(String name) {
//放在方法体内创建,保证线程安全
SqlSession session = factory.openSession();
List<User> users = session.selectList("test.findUserByName",name);
session.close();
return users;
}
@Override
public int insertUser(User user) {
//放在方法体内创建,保证线程安全
SqlSession session = factory.openSession();
session.insert("test.insertUser",user);
//一定要提交,不然是失败
session.commit();
session.close();
return user.getId();
}
@Override
public boolean deleteUser(int id) {
//放在方法体内创建,保证线程安全
SqlSession session = factory.openSession();
int i = session.delete("test.deleteUser",id);
//一定要提交,不然是失败
session.commit();
session.close();
return i>0;
}
@Override
public boolean updateUser(User user) {
//放在方法体内创建,保证线程安全
SqlSession session = factory.openSession();
int i = session.delete("test.updateUser",user);
//一定要提交,不然是失败
session.commit();
session.close();
return i>0;
}
}
5.写junit测试
SqlSessionFactory factory = null;
@Before
public void init(){
InputStream is = null;
try {
is = Resources.getResourceAsStream("SqlMapperConfig.xml");
} catch (IOException e) {
e.printStackTrace();
}
factory = new SqlSessionFactoryBuilder().build(is);
}
//测试取出单个
@Test
public void findUserByIdTest(){
UserDaoImp daoImp = new UserDaoImp(factory);
User user = daoImp.findUserById(2);
System.out.println(user);
}
//测试取出多个
@Test
public void findUserByNameTest(){
UserDaoImp daoImp = new UserDaoImp(factory);
List<User> users = daoImp.findUserByName("张");
System.out.println(users);
}
//测试插入数据
@Test
public void insertUserTest(){
UserDaoImp daoImp = new UserDaoImp(factory);
User u = new User();
u.setUsername("niuli1");
u.setPassword("123456");
u.setNickname("牛李");
u.setStatus(2);
int index = daoImp.insertUser(u);
System.out.println(index);
}
以上五步就是传统DAO开发方法
6.原始DAO开发方法存在的问题
- Dao方法体存在重复代码:通过SqlSessionFactory创建SqlSession,调用SqlSession的数据库操作方法
- 调用sqlSession的数据库操作方法需要指定statement的id,这里存在硬编码,不得于开发维护。
二.基于Mapper代理接口
1.实现原理
Mapper接口开发方法只需要程序员编写Mapper接口(相当于Dao接口),由Mybatis框架根据接口定义创建接口的动态代理对象,代理对象的方法体同上边Dao接口实现类方法。换句话说也就是不用程序员自己编写DAO接口的实现类了
2.UserMapper接口
接口定义有如下特点:
1、Mapper接口方法名和Mapper.xml中定义的statement的id相同
2、Mapper接口方法的输入参数类型和mapper.xml中定义的statement的parameterType的类型相同
3、Mapper接口方法的输出参数类型和mapper.xml中定义的statement的resultType的类型相同
public interface UserMapper {
//根据id查询用户
public User findUserById(int id);
//根据姓名模糊查询用户
public List<User> findUserByName(String name);
//插入一个用户,返回受影响的行数
public int insertUser(User user);
//删除一个用户,返回受影响的行数
public int deleteUser(int id);
//更新一个用户,返回受影响的行数
public int updateUser(User user);
}
3.UserMapper.xml
Mapper接口开发需要遵循以下规范:
1、Mapper.xml文件中的namespace与mapper接口的类路径相同。
<?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代理的话要是Mapper代理类路径。-->
<mapper namespace="com.aust.dao.UserMapper">
<!--其余内容和上面的User.xml一样-->
</mapper>
4.配置Mapper映射
无论哪种方式都需要配置映射
<!--配置mappeer映射-->
<mappers>
<mapper resource="mapper/UserMapper.xml"/>
</mappers>
5.写junit测试
@Before
public void init(){
InputStream is = null;
try {
is = Resources.getResourceAsStream("SqlMapperConfig.xml");
} catch (IOException e) {
e.printStackTrace();
}
factory = new SqlSessionFactoryBuilder().build(is);
}
//测试取出单个
@Test
public void findUserByIdTest(){
//获取sqlsession
SqlSession session = factory.openSession();
//创建mapper代理
UserMapper mapper = session.getMapper(UserMapper.class);
//利用mapper代理查询
User u = mapper.findUserById(2);
session.close();
System.out.println(u);
}
//测试取出多个
@Test
public void findUserByNameTest(){
SqlSession session = factory.openSession();
UserMapper mapper = session.getMapper(UserMapper.class);
List<User> users = mapper.findUserByName("张");
session.close();
System.out.println(users);
}
//测试插入数据
@Test
public void insertUserTest(){
SqlSession session = factory.openSession();
UserMapper mapper = session.getMapper(UserMapper.class);
User u = new User();
u.setUsername("niuli1");
u.setPassword("123456");
u.setNickname("牛李");
u.setStatus(2);
int index = mapper.insertUser(u);
System.out.println(index);//获取受影响的行数
System.out.println(u.getId());//获取返回的自增主键
}
6.总结
- selectOne和selectList动态代理对象调用sqlSession.selectOne()和sqlSession.selectList()是根据mapper接口方法的返回值决定,如果返回list则调用selectList方法,如果返回单个对象则调用selectOne方法。
- mybatis官方推荐使用mapper代理方法开发mapper接口,程序员不用编写mapper接口实现类。
- 可以发现使用Mapper代理的方式,在Mapper接口中输入参数必须只能是一个,但是怎么才能满足多样查询呢?mybatis建议输入参数可以使用pojo包装对象或map对象,保证dao的通用性.