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

  1. 使用JDBC编程需要连接数据库,注册驱动和数据库信息。
  2. 操作Connection,打开Statement对象。
  3. 通过Statement执行SQL,返回结果到ResultSet对象。
  4. 使用ResultSet读取数据。
  5. 关闭数据库相关资源。

传统JDBC的弊端


  1. 工作量相对较大,我们需要先连接、处理JDBC底层事务、处理数据类型;还要操作Connection对象、Statement对象、Resultset对象去拿到数据,并准确关闭它们。
  2. 我们要对JDBC编程可能产生的异常进行捕捉处理并正确关闭资源。

2 .什么是ORM

ORM(Object Relational Mapping,对象关系映射)模型就是数据库的表简单Java对象(POJO)的映射关系模型,它主要解决数据库数据和POJO对象的相互映射。通过这层映射关系就可以简单迅速地把数据库表的数据转化为POJO,以便程序员更加容易理解和应用Java程序

MyBatis学习笔记_xml

二、MyBatis


  1. MyBatis之所以是半自动的,是因为它需要手工匹配提供POJO、SQL和映射关系
  2. MyBatis所需要提供的映射文件包含以下三个部分:SQL、映射规则、POJO。

MyBatis学习笔记_xml_02

三、MyBatis的结构


  • SqlSessionFactoryBuilder(构造器):它会根据配置信息或者代码来生成SqISessionFactory。
  • SqISessionFactory(工厂接口):依靠工厂来生成SqlSession
  • SqlSession(会话):是一个既可以发送SQL去执行并返回结果,也可以获取 Mapper的接口。
  • SQL Mapper:它是MyBatis新设计的组件,它是由一个Java接口和XML文件(或注解)构成的,需要给出对应的SQL和映射规则。它负责发送SQL去执行,并返回结果。

MyBatis学习笔记_sql_03

四、构建SqISessionFactory


  • 每个MyBatis应用都是以SqlSessionFactory的实例为中心的。
  • SqlSessionFactory的实例可以通过SqlSessionFactoryBuilder获得。
  • MyBatis提供了两种模式去创建SqlSessionFactory:基于XML配置的方式和基于代码的方式。

MyBatis学习笔记_数据库_04

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的用途


  1. 获取映射器,让映射器通过命名空间和方法名称找到对应的SQL,发送给数据库执行后返回结果。
  2. 直接通过命名信息去执行SQL返回结果,这是 iBatis版本留下的方式。在SqlSession层我们可以通过update、insert、select、delete等方法,带上SQL的id来操作在XML中配置好的SQL,从而完成我们的工作;与此同时它也支持事务,通过 commit、rollback方法提交或者回滚事务。

六、 映射器

映射器的作用

映射器是由Java接口和XML文件(或注解)共同组成的,作用如下:


  • 定义参数类型。
  • 描述缓存。
  • 描述SQL语句。
  • 定义查询结果和POJO的映射关系

映射器的两种实现方式有两种


  • 通过XML文件方式实现,
  • 通过代码方式实现,在Configuration里面注册Mapper接口

6.1 XML方式实现Mapper


  1. 定义了一个XML Mapper文件,而且在配置文件mybatis-config.xml中配置了的该文件,所以 MyBatis会读取这个配置文件,生成映射器。
  2. 定义了一个命名空间为 com.ankeetc.spring.mapper.TbNameMapper 的SQL Mapper,这个命名空间和我们定义的接口的全限定名是一致的。
  3. 定义了一个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事务方法之内,是一个方法级别的东西。