MyBatis学习笔记
一、JDBC编程
1.JDBC编程过程
public void func() throws Exception {
Class.forName("com.mysql.jdbc.Driver");
String url = "jdbc:mysql://localhost:3306/test";
String username = "root";
Connection connection = DriverManager.getConnection(url, username, null);
PreparedStatement ps = connection.prepareStatement("SELECT * FROM tb_name LIMIT 1");
ResultSet rs = ps.executeQuery();
while (rs.next()) {
System.out.println("Id = " + rs.getString("id") + " Name = " + rs.getString("name"));
}
rs.close();
ps.close();
connection.close();
}
- 使用JDBC编程需要连接数据库,注册驱动和数据库信息。
- 操作Connection，打开Statement对象。
- 通过Statement执行SQL，返回结果到ResultSet对象。
- 使用ResultSet读取数据。
- 关闭数据库相关资源。
传统JDBC的弊端
- 工作量相对较大，我们需要先连接、处理JDBC底层事务、处理数据类型；还要操作Connection对象、Statement对象、Resultset对象去拿到数据，并准确关闭它们。
- 我们要对JDBC编程可能产生的异常进行捕捉处理并正确关闭资源。
2 .什么是ORM
ORM（Object Relational Mapping，对象关系映射）模型就是数据库的表和简单Java对象(POJO)的映射关系模型，它主要解决数据库数据和POJO对象的相互映射。通过这层映射关系就可以简单迅速地把数据库表的数据转化为POJO，以便程序员更加容易理解和应用Java程序
二、MyBatis
- MyBatis之所以是半自动的，是因为它需要手工匹配提供POJO、SQL和映射关系
- MyBatis所需要提供的映射文件包含以下三个部分：SQL、映射规则、POJO。
三、MyBatis的结构
- SqlSessionFactoryBuilder（构造器）：它会根据配置信息或者代码来生成SqISessionFactory。
- SqISessionFactory（工厂接口）：依靠工厂来生成SqlSession
- SqlSession（会话）：是一个既可以发送SQL去执行并返回结果，也可以获取 Mapper的接口。
- SQL Mapper：它是MyBatis新设计的组件，它是由一个Java接口和XML文件（或注解）构成的，需要给出对应的SQL和映射规则。它负责发送SQL去执行，并返回结果。
四、构建SqISessionFactory
- 每个MyBatis应用都是以SqlSessionFactory的实例为中心的。
- SqlSessionFactory的实例可以通过SqlSessionFactoryBuilder获得。
- MyBatis提供了两种模式去创建SqlSessionFactory：基于XML配置的方式和基于代码的方式。
Configuration类
Configuration类对象保存着我们配置在MyBatis的信息，这个对象将存在于整个MyBatis应用的生命期中，以便重复读取和运用。我们可以解析一次配置的XML文件保存到Configuration类对象中，方便我们从这个对象中读取配置信息。
两个SqlSessionFactory的实现类
在MyBatis中提供了两个SqlSessionFactory的实现类，DefaultSqlSessionFactory和SqlSessionManager。不过SqlSessionManager目前还没有使用，MyBatis中目前使用的是DefaultSqlSessionFactory。
4.1 通过XML方式配置
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN" "http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
<!-- 配置每个DO的别名 -->
<typeAliases>
<typeAlias type="com.ankeetc.spring.domain.UserDomain" alias="user"/>
</typeAliases>
<!-- 配置环境内容 -->
<environments default="dev">
<environment id="dev">
<!-- 采用JDBC的事务管理模式 -->
<transactionManager type="JDBC"/>
<!-- 数据库的连接信息 -->=
<dataSource type="POOLED">
<property name="driver" value="com.mysql.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/test"/>
<property name="username" value="root"/>
</dataSource>
</environment>
</environments>
<!-- 配置映射器 -->
<mappers>
<mapper resource="mappers/TbNameMapper.xml"/>
</mappers>
</configuration>
public SqlSessionFactory getSqlSessionFactory() throws Exception {
// 获取config源文件
InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
// 通过SqlSessionFactoryBuilder构造
return new SqlSessionFactoryBuilder().build(is);
}
4.2 通过编码方式
public SqlSessionFactory getSqlSessionFactory() throws Exception {
// 构建数据库连接池
PooledDataSource dataSource = new PooledDataSource();
dataSource.setDriver("com.mysql.jdbc.Driver");
dataSource.setUrl("jdbc:mysql://localhost:3306/test");
dataSource.setUsername("root");
// 构建数据库事务模式
TransactionFactory transactionFactory = new JdbcTransactionFactory();
// 创建数据库运行环境
Environment environment = new Environment("dev", transactionFactory, dataSource);
// 创建 Configuration 对象
Configuration configuration = new Configuration(environment);
// 配置MyBatis上下文别名
configuration.getTypeAliasRegistry().registerAlias("user", UserDomain.class);
// 配置映射器
configuration.addMapper(TbNameMapper.class);
// 使用SqlSessionFactoryBuilderg构建SqlSessionFactory
return new SqlSessionFactoryBuilder().build(configuration);
}
五、创建SqlSession
SqlSession是一个接口类，扮演着门面的作用，而真正干活的是Executor接口。只需要SqlSession参数信息和执行的方法，然后等待返回的结果，而不需要关心Executor是怎么工作的。
SqlSession的两个实现类
- DefaultSqlSession
- SqlSession
SqlSession的用法
SqlSession接口类似于一个JDBC中的Connection接囗对象，我们需要保证每次用完正常关闭它。
正确的做法是把关闭SqlSession接口的代码写在finally句中保证每次都会 关闭SqlSession，让连接资源归还给数据库。
public void func(SqlSessionFactory sqlSessionFactory) {
// 打开SqlSession会话
try (SqlSession sqlSession = sqlSessionFactory.openSession()){
// doSomething()
sqlSession.commit();
} catch (Exception e) {
// handle Exception
}
}
SqlSession的用途
- 获取映射器，让映射器通过命名空间和方法名称找到对应的SQL，发送给数据库执行后返回结果。
- 直接通过命名信息去执行SQL返回结果，这是 iBatis版本留下的方式。在SqlSession层我们可以通过update、insert、select、delete等方法，带上SQL的id来操作在XML中配置好的SQL，从而完成我们的工作；与此同时它也支持事务，通过 commit、rollback方法提交或者回滚事务。
六、 映射器
映射器的作用
映射器是由Java接口和XML文件（或注解）共同组成的，作用如下：
- 定义参数类型。
- 描述缓存。
- 描述SQL语句。
- 定义查询结果和POJO的映射关系
映射器的两种实现方式有两种
- 通过XML文件方式实现，
- 通过代码方式实现，在Configuration里面注册Mapper接口
6.1 XML方式实现Mapper
- 定义了一个XML Mapper文件，而且在配置文件mybatis-config.xml中配置了的该文件，所以 MyBatis会读取这个配置文件，生成映射器。
- 定义了一个命名空间为 com.ankeetc.spring.mapper.TbNameMapper 的SQL Mapper，这个命名空间和我们定义的接口的全限定名是一致的。
- 定义了一个select元素，id和接口方法名
UserDomain select(Long id)是一致的，parameterType则表示我们传递给这条SQL的是一个Long型参数，resultType则定义我们需要返回的数据类型。
<?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="com.ankeetc.spring.mapper.TbNameMapper">
<select id="select" resultType="com.ankeetc.spring.domain.UserDomain" parameterType="java.lang.Long">
SELECT * FROM tb_name WHERE id = #{id}
</select>
</mapper>
public interface TbNameMapper {
UserDomain select(Long id);
}
public static void func(SqlSessionFactory sqlSessionFactory) {
// 打开SqlSession会话
try (SqlSession sqlSession = sqlSessionFactory.openSession()){
// 获取映射器Mapper
TbNameMapper tbNameMapper = sqlSession.getMapper(TbNameMapper.class);
// 执行查询
UserDomain userDomain = tbNameMapper.select(18L);
System.out.println(userDomain.getName());
sqlSession.commit();
} catch (Exception e) {
// handle Exception
}
}
6.2 注解方式实现Mapper
public interface TbNameMapper2 {
@Select("SELECT * FROM tb_name WHERE id = #{id}")
UserDomain select(Long id);
}
在使用注解时，要向SqlSessionFactory中手动添加Mapper
public SqlSessionFactory getSqlSessionFactory() throws Exception {
// 在使用注解时，要向SqlSessionFactory中手动添加Mapper
configuration.addMapper(TbNameMapper.class);
//
}
6.3 Mapper实现方式简述
我们使用的仅仅是Java接口和一个XML文件（或者注解）去实现 Mapper，一个没有实现类的接口怎么能够运行呢？
这里其实是运用到Java语言的动态代理去实现，而实现Java语言的动态代理的方式有多种。这里我们还是集中于它的用法，所以可以这样理解：我们会在 MyBatis 上下文中描述这个接口，而MyBatis会为这个接口生成代理类对象，代理对象会根据“接口全路径+方法名”去匹配,找到对应的XML文件(或注解)去完成它所需要的任务，返回我们需要的结果。
七、生命周期
SqlSessionFactoryBuilder
SqlSessionFactoryBuilder是利用XML或者Java编码获得资源来构建SqlSessionFactory的，一旦我们构建了SqlSessionFactory，它的作用就已经完结，所以它的生命周期只存在于方法的局部。
SqlSessionFactory
SqlSessionFactory的作用是创建SqlSession，而SqlSession就是一个会话，每次访问数据库都需要通过SqlSessionFactory创建SqlSession，所以SqlSessionFactory应该在 MyBatis应用的整个生命周期中。
而且SqlSessionFactory我们只是用它来创建SqlSession，只需要一个示例，所以需要用采用单例模式。
public synchronized SqlSessionFactory initSqlSessionFactory() {
try {
if (sqlSessionFactory == null) {
InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
sqlSessionFactory = new SqlSessionFactoryBuilder().build(is);
}
return sqlSessionFactory;
} catch (Exception e) {
throw new RuntimeException(e);
}
}
SqlSession
SqlSession是一个会话，它的生命周期应该是在请求数据库处理事务的过程中。它是一个线程不安全的对象，在涉及多线程的时候我们需要特别的当心，操作数据库需要注意其隔离级别，数据库锁等高级特性。每次创建的SqlSession都必须及时关闭它。
Mapper
Mapper是一个接口，它的作用是发送SQL然后返回我们需要的结果；或者执行SQL从而修改数据库的数据。因此它应该在一个SqlSession事务方法之内，是一个方法级别的东西。