Mybatis——项目引入

这是我参与更文挑战的第28天，活动详情查看：更文挑战

mybatis Dao开发方法

一、概念

1. SqlSessionFactoryBuilder
   • SqlSessionFactoryBuilder用于创建SqlSessionFacoty
   • SqlSessionFacoty一旦创建完成就不需要SqlSessionFactoryBuilder了
2. SqlSessionFactory
   • SqlSessionFactory是一个接口，接口中定义了openSession的不同重载方法
   • SqlSessionFactory的最佳使用范围是整个应用运行期间，一旦创建后可以重复使用，通常以单例模式管理SqlSessionFactory。
3. SqlSession
   1. 概念
      • SqlSession是一个面向用户的接口， sqlSession中定义了数据库操作，默认使用DefaultSqlSession实现类。
   2. 执行过程
      • 1、 加载数据源等配置信息
      • 2、 创建数据库链接
      • 3、 创建事务对象
      • 4、 创建Executor，SqlSession所有操作都是通过Executor完成
   3. 结论
      • 每个线程都应该有它自己的SqlSession实例
      • SqlSession的实例不能共享使用，它也是线程不安全的。因此最佳的范围是请求或方法范围。
      • 打开一个 SqlSession；使用完毕就要关闭它。通常把这个关闭操作放到 finally 块中以确保每次都能执行关闭

二、原始Dao开发

1. 映射文件同上
2. Dao接口

public interface UserDao {
	
	//根据id查询用户信息
	public User findUserById(int id) throws Exception;
	
	//添加用户信息
	public void insertUser(User user) throws Exception;
	
	//删除用户信息
	public void deleteUser(int id) throws Exception;
	
}
复制代码

3. Dao接口实现类

public class UserDaoImpl implements UserDao{
	
	//需要向实现类中注入工厂
	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 void insertUser(User user) throws Exception {
	}

	@Override
	public void deleteUser(int id) throws Exception {
	}

}
复制代码

4. 测试类

public class UserDaoImplTest {

	private SqlSessionFactory sqlSessionFactory;

	// 此方法是在执行testFindUserById之前执行
	@Before
	public void setUp() throws Exception {
		// 创建sqlSessionFactory

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

}

复制代码

5. Dao中存在的问题
   • Dao方法体存在重复代码：通过SqlSessionFactory创建SqlSession，调用SqlSession的数据库操作方法
   • 调用sqlSession的数据库操作方法需要指定statement的id，这里存在硬编码，不得于开发维护

Mapper动态代理方式

一、实现原理

1. 原理
   • Mapper接口开发方法只需要程序员编写Mapper接口（相当于Dao接口），由Mybatis框架根据接口定义创建接口的动态代理对象，代理对象的方法体同上边Dao接口实现类方法。
2. Mapper接口开发需要遵循以下规范
   • 1、 Mapper.xml文件中的namespace与mapper接口的类路径相同。
   • 2、 Mapper接口方法名和Mapper.xml中定义的每个statement的id相同
   • 3、 Mapper接口方法的输入参数类型和mapper.xml中定义的每个sql 的parameterType的类型相同
   • 4、 Mapper接口方法的输出参数类型和mapper.xml中定义的每个sql的resultType的类型相同

二、具体实现

1. Mapper.xml（映射文件）
   • 内容同上，但是namespace要改成UserMapper的接口路径
2. Mapper.java（接口文件）
   • 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) throws Exception;
	
	//根据用户名查询用户
	public List<User> findUserByName(String name) throws Exception;
	
	//插入用户
	public void insertUser(User user) throws Exception;
	
	//删除用户
	public void deleteUser(int id) throws Exception;
}

复制代码

3. 加载UserMapper.xml文件

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

复制代码

4. 测试

public class UserMapperTest01 {
	private SqlSessionFactory sqlSessionFactory;
	// 此方法是在执行testFindUserById之前执行
	@Before
	public void setUp() throws Exception {
		// 创建sqlSessionFactory

		// mybatis配置文件
		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();

		UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
		User user = userMapper.findUserById(1);
		
		sqlSession.close();
		System.out.println(user);
	}
	
	@Test
	public void testFindUserByName() throws Exception {
		SqlSession sqlSession = sqlSessionFactory.openSession();

		UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
		List<User> list = userMapper.findUserByName("%小%");
		
		sqlSession.close();
		System.out.println(list);
	}
}
复制代码

三、总结

1. selectOne和selectList
   • 动态代理对象调用sqlSession.selectOne()和sqlSession.selectList()是根据mapper接口方法的返回值决定
   • 如果返回list则调用selectList方法
   • 如果返回单个对象则调用selectOne方法
2. namespace
   • mybatis官方推荐使用mapper代理方法开发mapper接口，程序员不用编写mapper接口实现类
   • 使用mapper代理方法时，输入参数可以使用pojo包装对象或map对象，保证dao的通用性，即通过传入一个参数实现传入多个参数