前言
最近开始了SpringBoot相关知识的学习，作为为目前比较流行、用的比较广的Spring框架，是每一个Java学习者及从业者都会接触到一个知识点。作为Spring框架项目，肯定少不了与数据库持久层的整合。我们在学习Java初始就被灌输SSM框架(Spring、SpringMVC、Mybatis)，我们大概也只是知道Mybatis是与数据库打交道的，但这也只是名词上的理解。
Mybatis具体是什么？
MyBatis 是一款优秀的持久层框架，它支持自定义 SQL、存储过程以及高级映射。MyBatis 免除了几乎所有的 JDBC 代码以及设置参数和获取结果集的工作。MyBatis 可以通过简单的 XML 或注解来配置和映射原始类型、接口和 Java POJO（Plain Old Java Objects，普通老式 Java 对象）为数据库中的记录。
。。。。。。
这里我就不废话介绍了，详细的看官方文档地址：https://mybatis.org/mybatis-3/zh/index.html
到后来开始完整的学习Mybatis、到Spring、SpringMVC、再到SpringBoot都有它的身影，它的使用及配置越来越简单方便，可能出现这种情况，学到SpringBoot整合Mybatis发现，为什么要这么操作？为什么要写这个注解？为什么要添加扫描包配置？那么这篇文章就是将开始学习Mybatis到现在SpringBoot整合Mybatis的知识串起来，加深印象增加理解。
下面是我往期关于Mybatis知识点的博客，有兴趣的可以看一下。
首先我也是作为Java的一名初学者，下面文章也是按照从JDBC、Mybatis、Spring、SpringMVC、再到SpringBoot的思路编写，也是我自己的学习路线中Mybatis由繁到简的过程。大致分为五个阶段，可能后面几个阶段内容可以合并为一个阶段，我为了体现Mybatis使用的方便简化，从而作为一个阶段。也可以帮助那些直接学习SpringBoot的同学理解整合Mybatis的递进过程。如果其中有错误之处，也烦请各位大佬给予指正！感谢！
阶段一：JDBC
我们在学习Mybatis之前，我们使用JDBC即数据库连接驱动进行数据库连接操作。
其大致操作步骤：
- 加载驱动
com.mysql.cj.jdbc.Driver - 设置数据库用户名、密码及URL
- 使用
DriverManager.getConnection(url, userName, passWord)创建数据库对象 - 创建执行Sql对象
connection.createStatement() - 通过statement对象执行具体的Sql
statement.executeQuery(sql) - 最后关闭释放连接
public static void main(String[] args) throws ClassNotFoundException, SQLException {
// 1.加载驱动(固定写法)
Class.forName("com.mysql.cj.jdbc.Driver");// 注意加载新的驱动，旧的弃用了
// 2.用户信息和url
String url = "jdbc:mysql://localhost:3306/school?serverTimezone=UTC&useUnicode=true&characterEncoding=utf-8&useSSl=true";// 注意添加时区参数
String userName = "root";
String passWord = "970628";
// 3.连接成功，数据库对象
Connection connection = DriverManager.getConnection(url, userName, passWord);
// 4.执行sql的对象
Statement statement = connection.createStatement();
// 5.执行sql
String sql= "SELECT * FROM student";
ResultSet resultSet = statement.executeQuery(sql);
while (resultSet.next()){
System.out.println("name="+resultSet.getObject("name"));
}
// 6.释放链接
resultSet.close();
statement.close();
connection.close();
}
JDBC的一些问题：
- 数据库链接创建、释放频繁造成系统资源浪费从而影响系统性能
- Sql语句变动比较大，每次变动都需要改动Java代码
- 每个一业务需要编写大量重复的JDBC代码，不宜维护
阶段二：Mybatis入门
Mybatis对jdbc的操作数据库的过程进行封装，使开发者只需要关注 SQL 本身，而不需要花费精力去处理例如注册驱动、创建connection、创建statement、手动设置参数、结果集检索等jdbc繁杂的过程代码。
其大致步骤：
- 首先导入MyBatis jar包
- 建立 mybatis-config.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>
<environments default="development">
<environment id="development">
<transactionManager type="JDBC"/>
<dataSource type="POOLED">
<property name="driver" value="com.mysql.cj.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/school?serverTimezone=UTC&useUnicode=true&characterEncoding=utf-8&useSSL=True"/>
<property name="username" value="root"/>
<property name="password" value="970628"/>
</dataSource>
</environment>
</environments>
</configuration>
- 通过mybatis环境等配置信息构造SqlSessionFactory即会话工厂，阶段一中创建数据库连接等操作都交给sqlSessionFactory来操作
- 由会话工厂创建sqlSession即会话，操作数据库需要通过sqlSession进行，类似于我们阶段一中statement对象
public class MybatisUtils {
private static SqlSessionFactory sqlSessionFactory;
static {
try {
// 获取sqlSessionFactory对象
String resource="mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
} catch (IOException e) {
e.printStackTrace();
}
}
// 既然有了 SqlSessionFactory，顾名思义，我们可以从中获得 SqlSession 的实例。
// SqlSession 提供了在数据库执行 SQL 命令所需的所有方法。你可以通过 SqlSession 实例来直接执行已映射的 SQL 语句
public static SqlSession getSqlSession(){
return sqlSessionFactory.openSession();
}
}
- 创建POJO对应的Mapper接口及对应的Mapper.xml文件。我们在阶段一需要写Mapper的实现类，需要大量的JDBC操作代码，这里我们通过Mapper.xml文件实现，满足SqlSession的调用。
public interface StudentMapper {
// 查询全部学生
List<Student> getStudentList();
// 根据id查询学生
Student getStudentById(int id);
// 插入一个学生
int addUser(Student student);
}
<?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">
<!--这里的namespace要与dao下的Mapper名称一一对应-->
<mapper namespace="com.tioxy.dao.StudentMapper">
<!--id对应的是Mapper接口中对应的方法-->
<!--resultType是SQL语句的返回值-->
<!--parameterType参数类型-->
<select id="getStudentList" resultType="com.tioxy.pojo.Student">
select * from school.student
</select>
<select id="getStudentById" resultType="com.tioxy.pojo.Student" parameterType="int">
select * from school.student where id = #{id}
</select>
<insert id="addUser" parameterType="com.tioxy.pojo.Student" >
insert into school.student (id,name,password,sex,birthd,address,email) values (#{id},#{name},#{password},#{sex},#{birthd},#{address},#{email});
</insert>
</mapper>
- 在核心配置文件中注册Mapper,目的需要告诉 MyBatis 到哪里去找到这些执行Sql语句
<!--每一个Mapper.xml文件都需要在mybatis核心配置文件中注册-->
<mappers>
<mapper resource="com/tioxy/dao/StudentMapper.xml"/>
</mappers>
- 通过
sqlSession.getMapper()获取接口对应的执行方法及结果 - 关闭连接
public void test(){
// 第一步，获取sqlSession对象
SqlSession sqlSession= MybatisUtils.getSqlSession();
try {
// 方式一，getMapper
StudentMapper mapper = sqlSession.getMapper(StudentMapper.class);
List<Student> studentList = mapper.getStudentList();
for (Student student : studentList) {
System.out.println(student);
}
}catch (Exception e){
e.printStackTrace();
}finally {
// 关闭sqlSession
sqlSession.close();
}
}
阶段三：Spring中整合MyBatis
MyBatis-Spring 会帮助你将 MyBatis 代码无缝地整合到 Spring 中。它将允许 MyBatis 参与到 Spring 的事务管理之中，创建映射器 mapper 和 SqlSession 并注入到 bean 中，以及将 Mybatis 的异常转换为 Spring 的 DataAccessException。最终，可以做到应用代码不依赖于 MyBatis，Spring 或 MyBatis-Spring。
大致步骤如下:
- 导入
mybatis-spring依赖包 - 在Spring xml文件中通过Spring的数据源
DriverManagerDataSource替换阶段二中Mybatis的数据源
<!--DataSources:使用Spring的数据源替换Mybatis的配置
这里使用Spring提供的JDBC
-->
<bean id="dataSource" class="org.springframework.jdbc.datasource.DriverManagerDataSource">
<property name="driverClassName" value="com.mysql.cj.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/school?serverTimezone=UTC&useUnicode=true&characterEncoding=utf-8&useSSL=True"/>
<property name="username" value="root"/>
<property name="password" value="970628"/>
</bean>
- 构建
SqlSessionFactoryBean,在第二阶段Mybatis入门的学习中，需要构建 SqlSessionFactory 通过 SqlSessionFactory 构建 SqlSession 进行数据库的操作CURD。我们这里使用SqlSessionFactoryBean来创建 SqlSessionFactory，在Spring 的 XML 配置如下
<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
<property name="dataSource" ref="dataSource" />
</bean>
- 同阶段二编写POJO类及Mapper接口及Mapper.xml文件并在配置文件中注册Mapper
- 与基础的 MyBatis 不同的是，需要创建Mapper接口的实现类，并继承
SqlSessionDaoSupport，目的是不需要管理SqlSession，而且对事务的支持更加友好
import com.tioxy.pojo.User;
import org.mybatis.spring.support.SqlSessionDaoSupport;
import java.util.List;
public class UserMapperImpl2 extends SqlSessionDaoSupport implements UserMapper{
@Override
public List<User> selectUser() {
return getSqlSession().getMapper(UserMapper.class).selectUser();
}
}
- 注册实现类的bean，并关联 sqlSessionFactory
<bean id="userMapper2" class="com.tioxy.mapper.UserMapperImpl2">
<property name="sqlSessionFactory" ref="sqlSessionFactory"/>
</bean>
- 通过
ApplicationContext的 getBean()方法获取接口并执行方法并返回结果。
public void selectUserTest() throws IOException {
ApplicationContext context = new ClassPathXmlApplicationContext("applicationContext.xml");
UserMapper userMapper = context.getBean("userMapper2", UserMapper.class);
for (User user : userMapper.selectUser()) {
System.out.println(user);
}
}
其中第5步，原理是内置使用了 SqlSessionTemplate ,SqlSessionTemplate 是 MyBatis-Spring 的核心。作为 SqlSession 的一个实现，这意味着可以使用它无缝代替你代码中已经在使用的 SqlSession。SqlSessionTemplate 是线程安全的，可以被多个 DAO 或映射器所共享使用。构建 SqlSessionTemplate 是 Spring学习之Spring与Mybatis的两种整合方式 中的第一种整合方式，本文章使用第二种方式。
总的来说，就是 Mybatis 的操作被Spring接管，通过一个个Spring Bean来实现持久层操作。
阶段四：SSM中整合MyBatis
其实有的小伙伴在这一阶段已经开始使用注解方式进行Mybatis操作，我这里为了说明Mybatis的整个演进过程，使用配置方式说明
在这一阶段与第三阶段中使用Mybatis并没有很大的差别,前四步与第三阶段相同，其最大的改进是在Spring注册bean MapperScannerConfigurer,其最大的作用是通过反射的方式自动的帮我们构造Mapper的实现类，省去我们手动编写。
<!--配置dao接口扫描包，动态的实现Dao接口可以注入到Spring容器中-->
<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
<!--注入 sqlSessionFactory-->
<property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"/>
<!--要扫描的包-->
<property name="basePackage" value="com.tioxy.mapper"/>
</bean>
接下来就是通过Service层调用来实现具体的业务。
所以这一阶段与阶段三并没有太大的差别与提升。可能有的小伙伴说，这一阶段使用阶段三也是可以的，的确如此。其实对于我来说，可能这一阶段使用了 MapperScannerConfigurer,算作上一阶段的简化，所以拿出作为阶段四，同理，我将使用注解的方式作为第四阶段的简化，所以放作下一阶段五。
阶段五：SpringBoot整合MyBatis
在这一阶段使用注解进行开发，大大简化了各项配置，使得更加专注于业务及Sql的操作，避免了大量繁琐的配置。
大致步骤：
- 导入mybatis的启动器
mybatis-spring-boot-starter
<dependency>
<groupId>org.mybatis.spring.boot</groupId>
<artifactId>mybatis-spring-boot-starter</artifactId>
<version>2.1.3</version>
</dependency>
- 在 application.yaml 文件中配置数据源,同前几阶段在xml中配置数据源一样
spring:
datasource:
username: root
password: 970628
url: jdbc:mysql://localhost:3306/school?serverTimezone=UTC&useUnicode=true&characterEncoding=utf-8
driver-class-name: com.mysql.cj.jdbc.Driver
- 编写POJO类及Mapper接口及Mapper.xml文件并在配置文件中添加Mapper.xml的扫描配置
# 整合Mybatis
mybatis:
# 别名
type-aliases-package: com.tioxy.pojo
# 原来dao与mapper.xml在同一路径，现在不在同一路径需要设置下面的参数，目的就是告诉*.xml文件的路径
mapper-locations: classpath:mybatis/mapper/*.xml
在前阶段的构建 SqlSessionFactoryBean 以及 SqlSession 全都由Spring帮我们实现，所以这里我们省去了这几项配置，只需在Mapper接口上添加@Mapper 注解，表示了这是一个 mybatis 的mapper 类，由Spring帮我们设置，而且也省去了阶段四种使用 MapperScannerConfigurer 来创建Mapper对应的接口
这里我使用Mapper.xml编写SQL语句，也可以使用注解方式，两种方式都可以，看个人喜好。我选择xml文件的原因是编写SQL语句灵活、扩展性好
如果使用注解方式编写Sql，则不需要Mapper.xml文件，也不要设置Mapper.xml的扫描配置，直接在接口的方法中使用 @Select、@Insert等注解
@Mapper
@Repository
public interface UserMapper {
/**
* 查询所有的用户
* @return
*/
@Select("select * from User")
List<User> queryUserList();
}
这里面 @Repository，是告诉Spring，这是一个Spring组件，类似于 @Controller、@Service一样
如果不想在每个方法中都加上 @Mapper 注解，可以直接在SpringBoot主启动类上添加 @MapperScan注解
@SpringBootApplication
@MapperScan("com.tioxy.mapper")
public class SpringBootMybatisApplication {
public static void main(String[] args) {
SpringApplication.run(SpringBootMybatisApplication.class, args);
}
}
- 最后就是通过
@Autowired自动装配，获取接口的各个业务方法进行持久层操作
总结
通过一个个阶段的演进，从一开始JDBC，手动创建数据库连接，创建 statement 执行Sql，这种方式，频繁打开关闭数据库，且Sql与Java代码耦合度高，修改Sql需要修改Java代码，很不方便，于是通过Mybatis进行封装，在单独的xml文件种统一编写Sql，大大简化了操作。Mybatis在不同阶段随着Spring的演进，也在逐渐简化了各种繁琐的配置，以及到最后的SpringBoot中，不再需要手动创建 SqlSessionFactoryBean、SqlSession 以及Mapper的实现类，通过注解操作，使得更加专注于业务及Sql的编写。当然在Java的体系中，持久化框架不只是Mybatis，还有Hibernate、TopLink、dbutils、Spring Data，其大致原理相似，这就需要根据实际开发及个人习惯进行选择。
编写不易，转载请注明出处
如有不当之处，感谢指正！