SpringBoot : ch05 整合Mybatis

2023-11-23 10:20

本文主要是介绍SpringBoot : ch05 整合Mybatis,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

前言

随着Java Web应用程序的快速发展,开发人员需要越来越多地关注如何高效地构建可靠的应用程序。Spring Boot作为一种快速开发框架,旨在简化基于Spring的应用程序的初始搭建和开发过程。而MyBatis作为一种优秀的持久层框架,提供了对数据库操作的便捷支持。本系列博客将带领大家深入了解如何将这两者结合起来,以构建强大的企业级应用程序。

在本篇博客中,我们将首先介绍Spring Boot和MyBatis的基本概念,然后重点讨论它们的整合方式及实际应用场景。通过本系列博客的学习,读者将能够掌握Spring Boot整合MyBatis的最佳实践,并能够将其应用于自己的项目中。

希望本系列博客能够帮助读者更加深入地理解Spring Boot和MyBatis,并为实际项目开发提供有力支持。让我们一起开始这段充满挑战和乐趣的学习之旅吧!

本次案例通过实现城市列表的查询和分页来介绍整合 Mybatis!

一、前期准备

1、新建项目,结构如下

2、导入依赖
 <dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-jdbc</artifactId></dependency><!-- mybatis 整合 springboot 的 starter --><dependency><groupId>org.mybatis.spring.boot</groupId><artifactId>mybatis-spring-boot-starter</artifactId><version>2.3.1</version></dependency><!-- pagehelper 分页插件的 starter --><!-- https://mvnrepository.com/artifact/com.github.pagehelper/pagehelper-spring-boot-starter --><dependency><groupId>com.github.pagehelper</groupId><artifactId>pagehelper-spring-boot-starter</artifactId><version>1.4.6</version></dependency><dependency><groupId>com.mysql</groupId><artifactId>mysql-connector-j</artifactId><scope>runtime</scope></dependency><dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId><optional>true</optional></dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-test</artifactId><scope>test</scope></dependency><dependency><groupId>org.mybatis.spring.boot</groupId><artifactId>mybatis-spring-boot-starter-test</artifactId><version>2.3.1</version><scope>test</scope></dependency>

 这段代码是关于Spring Boot整合MyBatis所需要的依赖项。通过这些依赖项,我们可以轻松地将Spring Boot和MyBatis集成在一起,实现数据库操作的快速开发。以下是每个依赖项的作用简介:

  1. spring-boot-starter-jdbc:Spring Boot提供的JDBC Starter,用于配置和管理数据库连接。

  2. mybatis-spring-boot-starter:MyBatis与Spring Boot整合的Starter,提供了MyBatis的核心功能和配置。

  3. pagehelper-spring-boot-starter:PageHelper分页插件的Starter,用于在MyBatis中实现分页查询。

  4. mysql-connector-j:MySQL数据库驱动程序。

  5. lombok:Java库,简化代码的编写,提供各种注解和工具。

  6. spring-boot-starter-test:Spring Boot的测试模块,用于编写单元测试。

  7. mybatis-spring-boot-starter-test:MyBatis与Spring Boot整合的测试模块,用于编写对MyBatis功能进行测试的单元测试。

这些依赖项可以通过Maven或Gradle等构建工具进行引入,并在项目中配置相关的属性和文件,以实现Spring Boot与MyBatis的整合。通过使用这些依赖项,我们可以简化开发过程,提高开发效率,同时保持良好的代码结构和可维护性

 3、建一个 city_info 表
create table city_info(city_id int primary key ,city_name varchar(100),city_code varchar(100),province varchar(50)
)
4、新建一个 City 实体类
@Data
public class City {private Integer cityId;private String cityName;private String cityCode;private String province;}

二、配置 application.yml

# 配置数据源
spring:datasource:driver-class-name: com.mysql.cj.jdbc.Driverurl: jdbc:mysql://localhost:3306/psmusername: rootpassword: 123456hikari:maximum-pool-size: 200minimum-idle: 10connection-timeout: 3000idle-timeout: 600000connection-test-query: select 1
# mybatis 配置
mybatis:# 实体的别名type-aliases-package: edu.nf.ch05.entity# mapper 映射配置文件的路径mapper-locations: classpath:/mappers/*.xml# 输出 sql 语句configuration:log-impl: org.apache.ibatis.logging.stdout.StdOutImpl
# 分页插件配置
pagehelper:# 设置数据库的方言helper-dialect: mysql# 启用注解分页参数support-methods-arguments: true# 启用分页合理化reasonable: true

当配置Spring Boot中的数据源时,针对每个属性进行详细介绍:

  1. spring.datasource.driver-class-name:

    • 用于指定数据库驱动程序的类名。
    • 在示例中,使用的是MySQL数据库,因此指定了com.mysql.cj.jdbc.Driver
  2. spring.datasource.url:

    • 指定数据库的连接地址。
    • 在示例中,使用的是本地的MySQL数据库,连接地址为jdbc:mysql://localhost:3306/psm,其中localhost代表数据库所在的主机名,3306代表数据库的端口号,psm是数据库的名称。
  3. spring.datasource.usernamespring.datasource.password:

    • 分别指定数据库的用户名和密码。
    • 在示例中,用户名为root,密码为123456
  4. spring.datasource.hikari.maximum-pool-size:

    • 指定Hikari连接池的最大连接数。
    • 在示例中,最大连接数被设置为200。
  5. spring.datasource.hikari.minimum-idle:

    • 指定Hikari连接池的最小空闲连接数。
    • 在示例中,最小空闲连接数被设置为10。
  6. spring.datasource.hikari.connection-timeout:

    • 指定连接超时时间,单位为毫秒。
    • 在示例中,连接超时时间被设置为3000毫秒。
  7. spring.datasource.hikari.idle-timeout:

    • 指定连接在连接池中空闲的最长时间,单位为毫秒。
    • 在示例中,空闲连接的最长时间被设置为600000毫秒(10分钟)。
  8. spring.datasource.hikari.connection-test-query:

    • 指定用于测试连接是否可用的查询语句。
    • 在示例中,使用了select 1作为测试查询语句。
  9. mybatis.type-aliases-package:

    • 指定实体类的别名包路径。
    • 在示例中,实体类别名被设置为edu.nf.ch05.entity,即该包下的实体类可以直接使用类名作为别名。
  10. mybatis.mapper-locations:

    • 指定Mapper映射文件的位置。
    • 在示例中,Mapper映射文件被设置在classpath:/mappers/*.xml路径下,表示在类路径下的mappers目录中寻找XML格式的Mapper文件。
  11. mybatis.configuration.log-impl:

    • 指定MyBatis的日志输出方式。
    • 在示例中,日志输出方式被设置为org.apache.ibatis.logging.stdout.StdOutImpl,即将日志输出到控制台。
  12. pagehelper.helper-dialect:

    • 指定PageHelper分页插件支持的数据库方言。
    • 在示例中,使用的是MySQL数据库,因此数据库方言被设置为mysql
  13. pagehelper.support-methods-arguments:

    • 启用或禁用PageHelper分页插件的注解分页参数功能。
    • 在示例中,该属性被设置为true,表示启用注解分页参数。
  14. pagehelper.reasonable:

    • 启用或禁用PageHelper分页插件的分页合理化功能。
    • 在示例中,该属性被设置为true,表示启用分页合理化。

以上是示例配置中各个属性的详细介绍。根据实际需求,可以根据数据库类型、连接池配置以及MyBatis和PageHelper的功能需求进行相应的调整和配置。

配置完数据源和mybatis以及分页插件后,我们就可以去完成dao的编写以及serviced的代码了。 

 

三、编写 dao

public interface CityDao {List<City> listCity(@Param("pageNum") Integer pageNum,@Param("pageSize") Integer pageSize);}

编写 Mybatis 配置类,映射sql语句:

<?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="edu.nf.ch05.dao.CityDao"><resultMap id="cityMap" type="city"><id property="cityId" column="city_id"/><result property="cityName" column="city_name"/><result property="cityCode" column="city_code"/><result property="province" column="province"/></resultMap><select id="listCity" resultMap="cityMap">select city_id, city_name, city_code, province from psm.city_info</select></mapper>

 

四、编写 service

public interface CityService {/*** 查询城市列表* @param pageNum* @param pageSize* @return*/PageInfo<City> listCity(Integer pageNum,Integer pageSize);}

实现类

@Service
@Transactional(rollbackFor = RuntimeException.class)
@RequiredArgsConstructor
public class CityServiceImpl implements CityService {private final CityDao dao;@Overridepublic PageInfo<City> listCity(Integer pageNum, Integer pageSize) {List<City> cities = dao.listCity(pageNum, pageSize);return new PageInfo<>(cities);}
}

让我解释一下其中的一些关键点:

  1. @Service注解:

    • 用于将该类标识为Spring的Service组件,通常用于业务逻辑的处理。
  2. @Transactional(rollbackFor = RuntimeException.class)注解:

    • 用于声明事务行为,指定在发生RuntimeException时进行事务回滚。
    • 这意味着当方法中抛出RuntimeException异常时,事务会回滚到方法执行前的状态。
  3. @RequiredArgsConstructor注解:

    • Lombok提供的注解,用于生成一个包含必需参数的构造函数。
    • 在这里,它会为CityServiceImpl类生成一个包含final字段dao的构造函数。
  4. private final CityDao dao;

    • 使用@RequiredArgsConstructor注解后,Lombok会自动生成带有CityDao类型参数的构造函数,并且会将CityDao对象注入到dao字段中。
    • 这也意味着CityDaoCityServiceImpl的一个依赖项,在构造函数中通过依赖注入的方式进行初始化。
  5. @Override注解:

    • 用于标识该方法是对接口中的方法的重写实现。
  6. public PageInfo<City> listCity(Integer pageNum, Integer pageSize)方法:

    • 该方法是CityService接口中定义的方法的实现。
    • 通过调用CityDaolistCity方法获取城市列表数据,然后通过PageInfo类对其进行封装并返回。

 

五、在 Ch05Application 添加扫描注解

@SpringBootApplication
@MapperScan("edu.nf.ch05.dao")
public class Ch05Application {public static void main(String[] args) {SpringApplication.run(Ch05Application.class, args);}}

注意:这是重点,就算写完了之前的所有代码,没有使用这个注解去扫描,前面的都是白写,如果不使用扫描,会报错。

@MapperScan("edu.nf.ch05.dao") 是一个注解,用于扫描指定包下的Mapper接口,并将其注册为Spring的Bean。在整合Spring Boot和MyBatis时,我们需要告诉Spring Boot去扫描哪些包下的Mapper接口,并将其注入到容器中。

在这个例子中,注解@MapperScan("edu.nf.ch05.dao")表示对包edu.nf.ch05.dao进行扫描,该包下的所有Mapper接口将被注册为Spring的Bean,以便在其他地方可以通过自动注入的方式使用它们。

这是个类就相当于我们之前所写的配置类一样。

六、测试

@Slf4j
@SpringBootTest
class Ch05ApplicationTests {@Autowiredprivate CityService cityService;@Testvoid contextLoads() {PageInfo<City> cityPageInfo = cityService.listCity(0, 10);cityPageInfo.getList().forEach(list -> log.info(list.toString()));}}

 把 cityService 通过字段注入进来,就可以从容器中获取我们的listCity方法。

运行结果:

 

七、总结

大家对比一下和之前使用 springMvc 整合 Mybatis 是不是有很大的区别,区别是什么,就是不用再配置类中编写大量的配置代码了,springboot帮我们简化了这个配置过程,我们只需要在properties或者yml中使用简单的配置即可以配置好Mybatis来使用。 

 

这篇关于SpringBoot : ch05 整合Mybatis的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/417244

相关文章

将Mybatis升级为Mybatis-Plus的详细过程

《将Mybatis升级为Mybatis-Plus的详细过程》本文详细介绍了在若依管理系统(v3.8.8)中将MyBatis升级为MyBatis-Plus的过程,旨在提升开发效率,通过本文,开发者可实现... 目录说明流程增加依赖修改配置文件注释掉MyBATisConfig里面的Bean代码生成使用IDEA生

Java编译生成多个.class文件的原理和作用

《Java编译生成多个.class文件的原理和作用》作为一名经验丰富的开发者,在Java项目中执行编译后,可能会发现一个.java源文件有时会产生多个.class文件,从技术实现层面详细剖析这一现象... 目录一、内部类机制与.class文件生成成员内部类(常规内部类)局部内部类(方法内部类)匿名内部类二、

SpringBoot实现数据库读写分离的3种方法小结

《SpringBoot实现数据库读写分离的3种方法小结》为了提高系统的读写性能和可用性,读写分离是一种经典的数据库架构模式,在SpringBoot应用中,有多种方式可以实现数据库读写分离,本文将介绍三... 目录一、数据库读写分离概述二、方案一:基于AbstractRoutingDataSource实现动态

Springboot @Autowired和@Resource的区别解析

《Springboot@Autowired和@Resource的区别解析》@Resource是JDK提供的注解,只是Spring在实现上提供了这个注解的功能支持,本文给大家介绍Springboot@... 目录【一】定义【1】@Autowired【2】@Resource【二】区别【1】包含的属性不同【2】@

springboot循环依赖问题案例代码及解决办法

《springboot循环依赖问题案例代码及解决办法》在SpringBoot中,如果两个或多个Bean之间存在循环依赖(即BeanA依赖BeanB,而BeanB又依赖BeanA),会导致Spring的... 目录1. 什么是循环依赖?2. 循环依赖的场景案例3. 解决循环依赖的常见方法方法 1:使用 @La

Java枚举类实现Key-Value映射的多种实现方式

《Java枚举类实现Key-Value映射的多种实现方式》在Java开发中,枚举(Enum)是一种特殊的类,本文将详细介绍Java枚举类实现key-value映射的多种方式,有需要的小伙伴可以根据需要... 目录前言一、基础实现方式1.1 为枚举添加属性和构造方法二、http://www.cppcns.co

Elasticsearch 在 Java 中的使用教程

《Elasticsearch在Java中的使用教程》Elasticsearch是一个分布式搜索和分析引擎,基于ApacheLucene构建,能够实现实时数据的存储、搜索、和分析,它广泛应用于全文... 目录1. Elasticsearch 简介2. 环境准备2.1 安装 Elasticsearch2.2 J

Java中的String.valueOf()和toString()方法区别小结

《Java中的String.valueOf()和toString()方法区别小结》字符串操作是开发者日常编程任务中不可或缺的一部分,转换为字符串是一种常见需求,其中最常见的就是String.value... 目录String.valueOf()方法方法定义方法实现使用示例使用场景toString()方法方法

Java中List的contains()方法的使用小结

《Java中List的contains()方法的使用小结》List的contains()方法用于检查列表中是否包含指定的元素,借助equals()方法进行判断,下面就来介绍Java中List的c... 目录详细展开1. 方法签名2. 工作原理3. 使用示例4. 注意事项总结结论:List 的 contain

Java实现文件图片的预览和下载功能

《Java实现文件图片的预览和下载功能》这篇文章主要为大家详细介绍了如何使用Java实现文件图片的预览和下载功能,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... Java实现文件(图片)的预览和下载 @ApiOperation("访问文件") @GetMapping("