作者丨TIOXY
https://www.cnblogs.com/tioxy/p/13417711.html
前言
最近开始了SpringBoot相关知识的学习,作为为目前比较流行、用的比较广的Spring框架,是每一个Java学习者及从业者都会接触到一个知识点。作为Spring框架项目,肯定少不了与数据库持久层的整合。我们在学习Java初始就被灌输SSM框架(Spring、SpringMVC、Mybatis),我们大概也只是知道Mybatis是与数据库打交道的,但这也只是名词上的理解。
Mybatis具体是什么?
MyBatis 是一款优秀的持久层框架,它支持自定义 SQL、存储过程以及高级映射。MyBatis 免除了几乎所有的 JDBC 代码以及设置参数和获取结果集的工作。MyBatis 可以通过简单的 XML 或注解来配置和映射原始类型、接口和 Java POJO(Plain Old Java Objects,普通老式 Java 对象)为数据库中的记录。
。。。。。。
到后来开始完整的学习Mybatis、到Spring、SpringMVC、再到SpringBoot都有它的身影,它的使用及配置越来越简单方便,可能出现这种情况,学到SpringBoot整合Mybatis发现,为什么要这么操作?为什么要写这个注解?为什么要添加扫描包配置?那么这篇文章就是将开始学习Mybatis到现在SpringBoot整合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" ?>
- 通过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 getStudentList(); // 根据id查询学生 Student getStudentById(int id); // 插入一个学生 int addUser(Student student);}
<?xml version="1.0" encoding="UTF-8" ?> select * from school.student select * from school.student where id = #{id} insert into school.student (id,name,password,sex,birthd,address,email) values (#{id},#{name},#{password},#{sex},#{birthd},#{address},#{email});
- 在核心配置文件中注册Mapper,目的需要告诉 MyBatis 到哪里去找到这些执行Sql语句
- 通过 sqlSession.getMapper()获取接口对应的执行方法及结果
- 关闭连接
public void test(){ // 第一步,获取sqlSession对象 SqlSession sqlSession= MybatisUtils.getSqlSession(); try { // 方式一,getMapper StudentMapper mapper = sqlSession.getMapper(StudentMapper.class); List 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的数据源
- 构建 SqlSessionFactoryBean ,在第二阶段Mybatis入门的学习中,需要构建 SqlSessionFactory 通过 SqlSessionFactory 构建 SqlSession 进行数据库的操作CURD。我们这里使用SqlSessionFactoryBean来创建 SqlSessionFactory,在Spring 的 XML 配置如下
- 同阶段二编写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 selectUser() { return getSqlSession().getMapper(UserMapper.class).selectUser(); }}
- 注册实现类的bean,并关联 sqlSessionFactory
- 通过 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 或映射器所共享使用。
总的来说,就是 Mybatis 的操作被Spring接管,通过一个个Spring Bean来实现持久层操作。
阶段四:SSM中整合MyBatis
其实有的小伙伴在这一阶段已经开始使用注解方式进行Mybatis操作,我这里为了说明Mybatis的整个演进过程,使用配置方式说明
在这一阶段与第三阶段中使用Mybatis并没有很大的差别,前四步与第三阶段相同,其最大的改进是在Spring注册bean MapperScannerConfigurer,其最大的作用是通过反射的方式自动的帮我们构造Mapper的实现类,省去我们手动编写。
接下来就是通过Service层调用来实现具体的业务。
所以这一阶段与阶段三并没有太大的差别与提升。可能有的小伙伴说,这一阶段使用阶段三也是可以的,的确如此。其实对于我来说,可能这一阶段使用了 MapperScannerConfigurer,算作上一阶段的简化,所以拿出作为阶段四,同理,我将使用注解的方式作为第四阶段的简化,所以放作下一阶段五。
阶段五:SpringBoot整合MyBatis
在这一阶段使用注解进行开发,大大简化了各项配置,使得更加专注于业务及Sql的操作,避免了大量繁琐的配置。
大致步骤:
- 导入mybatis的启动器 mybatis-spring-boot-starter
org.mybatis.spring.boot mybatis-spring-boot-starter 2.1.3
- 在 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的扫描配置
# 整合Mybatismybatis: # 别名 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@Repositorypublic interface UserMapper { /** * 查询所有的用户 * @return */ @Select("select * from User") List 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,其大致原理相似,这就需要根据实际开发及个人习惯进行选择。