基于SpringBoot整合SSMP的詳細(xì)教程

更新時(shí)間：2022年08月09日 15:15:42 作者：十八歲討厭編程

這篇文章主要介紹了SpringBoot整合SSMP的詳細(xì)教程,通過本文學(xué)習(xí)基于SpringBoot實(shí)現(xiàn)SSMP整合的詳細(xì)代碼，需要的朋友可以參考下

基于SpringBoot實(shí)現(xiàn)SSMP整合

SpringBoot之所以好用，就是它能方便快捷的整合其他技術(shù)，這里我們先介紹四種技術(shù)的整合：

整合JUnit
整合MyBatis
整合MyBatis-Plus
整合Druid

整合JUnit

? SpringBoot技術(shù)的定位用于簡(jiǎn)化開發(fā)，再具體點(diǎn)是簡(jiǎn)化Spring程序的開發(fā)。所以在整合任意技術(shù)的時(shí)候，如果你想直觀感觸到簡(jiǎn)化的效果，你必須先知道使用非SpringBoot技術(shù)時(shí)對(duì)應(yīng)的整合是如何做的，然后再看基于SpringBoot的整合是如何做的，才能比對(duì)出來簡(jiǎn)化在了哪里。

? 我們先來看一下不使用SpringBoot技術(shù)時(shí)，Spring整合JUnit的制作方式

//加載spring整合junit專用的類運(yùn)行器
@RunWith(SpringJUnit4ClassRunner.class)
//指定對(duì)應(yīng)的配置信息
@ContextConfiguration(classes = SpringConfig.class)
public class AccountServiceTestCase {
    //注入你要測(cè)試的對(duì)象
    @Autowired
    private AccountService accountService;
    @Test
    public void testGetById(){
        //執(zhí)行要測(cè)試的對(duì)象對(duì)應(yīng)的方法
        System.out.println(accountService.findById(2));
    }
}

?其中核心代碼是前兩個(gè)注解：

第一個(gè)注解@RunWith是設(shè)置Spring專用的測(cè)試類運(yùn)行器，簡(jiǎn)單說就是Spring程序執(zhí)行程序有自己的一套獨(dú)立的運(yùn)行程序的方式，不能使用JUnit提供的類運(yùn)行方式了，必須指定一下，但是格式是固定的，琢磨一下，每次都指定一樣的東西，這個(gè)東西寫起來沒有技術(shù)含量啊

第二個(gè)注解@ContextConfiguration是用來設(shè)置Spring核心配置文件或配置類的，簡(jiǎn)單說就是加載Spring的環(huán)境你要告訴Spring具體的環(huán)境配置是在哪里寫的，雖然每次加載的文件都有可能不同，但是仔細(xì)想想，如果文件名是固定的，這個(gè)貌似也是一個(gè)固定格式。既然有可能是固定格式，那就有可能每次都寫一樣的東西，也是一個(gè)沒有技術(shù)含量的內(nèi)容書寫

SpringBoot就抓住上述兩條沒有技術(shù)含量的內(nèi)容書寫進(jìn)行開發(fā)簡(jiǎn)化，能走默認(rèn)值的走默認(rèn)值，能不寫的就不寫，具體格式如下：

@SpringBootTest
class Springboot04JunitApplicationTests {
    //注入你要測(cè)試的對(duì)象
    @Autowired
    private BookDao bookDao;
    @Test
    void contextLoads() {
        //執(zhí)行要測(cè)試的對(duì)象對(duì)應(yīng)的方法
        bookDao.save();
        System.out.println("two...");
    }
}

? 看看這次簡(jiǎn)化成什么樣了，一個(gè)注解就搞定了，而且還沒有參數(shù)，再體會(huì)SpringBoot整合其他技術(shù)的優(yōu)勢(shì)在哪里，就兩個(gè)字——簡(jiǎn)化。使用一個(gè)注解@SpringBootTest替換了前面兩個(gè)注解。至于內(nèi)部是怎么回事？和之前一樣，只不過都走默認(rèn)值。

? 這個(gè)時(shí)候有人就問了，你加載的配置類或者配置文件是哪一個(gè)？就是我們前面啟動(dòng)程序使用的引導(dǎo)類。如果想手工指定引導(dǎo)類有兩種方式，第一種方式使用屬性的形式進(jìn)行，在注解@SpringBootTest中添加classes屬性指定配置類：

@SpringBootTest(classes = 引導(dǎo)類的名字.class)
class Springboot04JunitApplicationTests {
    //注入你要測(cè)試的對(duì)象
    @Autowired
    private BookDao bookDao;
    @Test
    void contextLoads() {
        //執(zhí)行要測(cè)試的對(duì)象對(duì)應(yīng)的方法
        bookDao.save();
        System.out.println("two...");
    }
}

第二種方式回歸原始配置方式，仍然使用@ContextConfiguration注解進(jìn)行，效果是一樣的：

@SpringBootTest
@ContextConfiguration(classes = Springboot04JunitApplication.class)
class Springboot04JunitApplicationTests {
    //注入你要測(cè)試的對(duì)象
    @Autowired
    private BookDao bookDao;
    @Test
    void contextLoads() {
        //執(zhí)行要測(cè)試的對(duì)象對(duì)應(yīng)的方法
        bookDao.save();
        System.out.println("two...");
    }
}

溫馨提示
使用SpringBoot整合JUnit需要保障導(dǎo)入test對(duì)應(yīng)的starter，由于初始化項(xiàng)目時(shí)此項(xiàng)是默認(rèn)導(dǎo)入的，所以此處沒有提及

總結(jié)

導(dǎo)入測(cè)試對(duì)應(yīng)的starter
測(cè)試類使用@SpringBootTest修飾
使用自動(dòng)裝配的形式添加要測(cè)試的對(duì)象
測(cè)試類如果存在于引導(dǎo)類所在包或子包中無需指定引導(dǎo)類
測(cè)試類如果不存在于引導(dǎo)類所在的包或子包中需要通過classes屬性指定引導(dǎo)類

整合MyBatis

老規(guī)矩我們還是先寫一下原始整合方案：

導(dǎo)入坐標(biāo)，MyBatis坐標(biāo)不能少，Spring整合MyBatis還有自己專用的坐標(biāo)，此外Spring進(jìn)行數(shù)據(jù)庫(kù)操作的jdbc坐標(biāo)是必須的，剩下還有mysql驅(qū)動(dòng)坐標(biāo)，本例中使用了Druid數(shù)據(jù)源，這個(gè)倒是可以不要

<dependencies>
    <dependency>
        <groupId>com.alibaba</groupId>
        <artifactId>druid</artifactId>
        <version>1.1.16</version>
    </dependency>
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.5.6</version>
    </dependency>
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>5.1.47</version>
    </dependency>
    <!--1.導(dǎo)入mybatis與spring整合的jar包-->
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis-spring</artifactId>
        <version>1.3.0</version>
    </dependency>
    <!--導(dǎo)入spring操作數(shù)據(jù)庫(kù)必選的包-->
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-jdbc</artifactId>
        <version>5.2.10.RELEASE</version>
    </dependency>
</dependencies>

Spring核心配置

@Configuration
@ComponentScan("com.nefu")
@PropertySource("jdbc.properties")
public class SpringConfig {
}

MyBatis要交給Spring接管的bean

//定義mybatis專用的配置類
@Configuration
public class MyBatisConfig {
//    定義創(chuàng)建SqlSessionFactory對(duì)應(yīng)的bean
    @Bean
    public SqlSessionFactoryBean sqlSessionFactory(DataSource dataSource){
        //SqlSessionFactoryBean是由mybatis-spring包提供的，專用于整合用的對(duì)象
        SqlSessionFactoryBean sfb = new SqlSessionFactoryBean();
        //設(shè)置數(shù)據(jù)源替代原始配置中的environments的配置
        sfb.setDataSource(dataSource);
        //設(shè)置類型別名替代原始配置中的typeAliases的配置
        sfb.setTypeAliasesPackage("com.nefu.domain");
        return sfb;
    }
//    定義加載所有的映射配置
    @Bean
    public MapperScannerConfigurer mapperScannerConfigurer(){
        MapperScannerConfigurer msc = new MapperScannerConfigurer();
        msc.setBasePackage("com.nefu.dao");
        return msc;
    }

}

數(shù)據(jù)源對(duì)應(yīng)的bean，此處使用Druid數(shù)據(jù)源

@Configuration
public class JdbcConfig {
    @Value("${jdbc.driver}")
    private String driver;
    @Value("${jdbc.url}")
    private String url;
    @Value("${jdbc.username}")
    private String userName;
    @Value("${jdbc.password}")
    private String password;

    @Bean("dataSource")
    public DataSource dataSource(){
        DruidDataSource ds = new DruidDataSource();
        ds.setDriverClassName(driver);
        ds.setUrl(url);
        ds.setUsername(userName);
        ds.setPassword(password);
        return ds;
    }
}

數(shù)據(jù)庫(kù)連接信息（properties格式）

jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/spring_db?useSSL=false
jdbc.username=root
jdbc.password=*********

上述格式基本上是最簡(jiǎn)格式了，要寫的東西還真不少。

這里是最簡(jiǎn)格式，所以我們沒有寫業(yè)務(wù)層，我們測(cè)試的時(shí)候直接通過dao的自動(dòng)生成對(duì)象去操作數(shù)據(jù)庫(kù)

下面看看SpringBoot整合MyBaits格式：
步驟①：創(chuàng)建模塊

步驟②：勾選要使用的技術(shù)，MyBatis，由于要操作數(shù)據(jù)庫(kù)，還要勾選對(duì)應(yīng)數(shù)據(jù)庫(kù)

? 或者手工導(dǎo)入對(duì)應(yīng)技術(shù)的starter，和對(duì)應(yīng)數(shù)據(jù)庫(kù)的坐標(biāo)

<dependencies>
    <!--1.導(dǎo)入對(duì)應(yīng)的starter-->
    <dependency>
        <groupId>org.mybatis.spring.boot</groupId>
        <artifactId>mybatis-spring-boot-starter</artifactId>
        <version>2.2.0</version>
    </dependency>

    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <scope>runtime</scope>
    </dependency>
</dependencies>

步驟③：配置數(shù)據(jù)源相關(guān)信息，沒有這個(gè)信息你連接哪個(gè)數(shù)據(jù)庫(kù)都不知道

#2.配置相關(guān)信息
spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://localhost:3306/ssm_db
    username: root
    password: ****************

? 結(jié)束了，對(duì)，這就結(jié)束了，SpringBoot把配置中所有可能出現(xiàn)的通用配置都簡(jiǎn)化了。下面寫一個(gè)MyBatis程序運(yùn)行需要的Dao（或者M(jìn)apper）就可以運(yùn)行了

實(shí)體類

public class Book {
    private Integer id;
    private String type;
    private String name;
    private String description;

	······
}

映射接口（Dao）

@Mapper
public interface BookDao {
    @Select("select * from tbl_book where id = #{id}")
    public Book getById(Integer id);
}

測(cè)試類

@SpringBootTest
class Springboot05MybatisApplicationTests {
    @Autowired
    private BookDao bookDao;
    @Test
    void contextLoads() {
        System.out.println(bookDao.getById(1));
    }
}

結(jié)果：

? 注意：當(dāng)前使用的SpringBoot版本是2.5.4，對(duì)應(yīng)的坐標(biāo)設(shè)置中Mysql驅(qū)動(dòng)使用的是8x版本。使用SpringBoot2.4.3（不含）之前版本會(huì)出現(xiàn)一個(gè)小BUG，就是MySQL驅(qū)動(dòng)升級(jí)到8以后要求強(qiáng)制配置時(shí)區(qū)，如果不設(shè)置會(huì)出問題。解決方案很簡(jiǎn)單，驅(qū)動(dòng)url上面添加上對(duì)應(yīng)設(shè)置就行了

#2.配置相關(guān)信息
spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://localhost:3306/ssm_db?serverTimezone=UTC
    username: root
    password: ********

? 這里設(shè)置的UTC是全球標(biāo)準(zhǔn)時(shí)間，你也可以理解為是英國(guó)時(shí)間，中國(guó)處在東八區(qū)，需要在這個(gè)基礎(chǔ)上加上8小時(shí)，這樣才能和中國(guó)地區(qū)的時(shí)間對(duì)應(yīng)的，也可以修改配置為Asia/Shanghai，同樣可以解決這個(gè)問題。

#2.配置相關(guān)信息
spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://localhost:3306/ssm_db?serverTimezone=Asia/Shanghai
    username: root
    password: *********

? 如果不想每次都設(shè)置這個(gè)東西，也可以去修改mysql中的配置文件mysql.ini，在mysqld項(xiàng)中添加default-time-zone=+8:00也可以解決這個(gè)問題。其實(shí)方式方法很多，這里就說這么多吧。

? 此外在運(yùn)行程序時(shí)還會(huì)給出一個(gè)提示，說數(shù)據(jù)庫(kù)驅(qū)動(dòng)過時(shí)的警告，根據(jù)提示修改配置即可，棄用com.mysql.jdbc.Driver，換用com.mysql.cj.jdbc.Driver。前面的例子中已經(jīng)更換了驅(qū)動(dòng)了，在此說明一下。

Loading class `com.mysql.jdbc.Driver'. This is deprecated. The new driver class is `com.mysql.cj.jdbc.Driver'. The driver is automatically registered via the SPI and manual loading of the driver class is generally unnecessary.

總結(jié)

整合操作需要勾選MyBatis技術(shù)，也就是導(dǎo)入MyBatis對(duì)應(yīng)的starter
數(shù)據(jù)庫(kù)連接相關(guān)信息轉(zhuǎn)換成配置
數(shù)據(jù)庫(kù)SQL映射需要添加@Mapper被容器識(shí)別到
MySQL 8.X驅(qū)動(dòng)強(qiáng)制要求設(shè)置時(shí)區(qū)
修改url，添加serverTimezone設(shè)定
修改MySQL數(shù)據(jù)庫(kù)配置
驅(qū)動(dòng)類過時(shí)，提醒更換為com.mysql.cj.jdbc.Driver

整合MyBatis-Plus

經(jīng)過前面兩種技術(shù)的整合，我們發(fā)現(xiàn)第三方技術(shù)的整合無非就是兩步：

導(dǎo)入對(duì)應(yīng)技術(shù)的starter坐標(biāo)
根據(jù)對(duì)應(yīng)技術(shù)的要求做配置

接下來在MyBatis的基礎(chǔ)上再升級(jí)一下，整合MyBaitsPlus（簡(jiǎn)稱MP）

步驟①：導(dǎo)入對(duì)應(yīng)的starter

<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-boot-starter</artifactId>
    <version>3.4.3</version>
</dependency>

? 關(guān)于這個(gè)坐標(biāo)，此處要說明一點(diǎn)，之前我們看的starter都是spring-boot-starter-？？？，也就是說都是下面的格式

Spring-boot-start-***

? 而MyBatis與MyBatisPlus這兩個(gè)坐標(biāo)的名字書寫比較特殊，是第三方技術(shù)名稱在前，boot和starter在后。此處簡(jiǎn)單提一下命名規(guī)范，后期原理篇會(huì)再詳細(xì)講解

starter所屬	命名規(guī)則	示例
官方提供	spring-boot-starter-技術(shù)名稱	spring-boot-starter-web spring-boot-starter-test
第三方提供	第三方技術(shù)名稱-spring-boot-starter	mybatis-spring-boot-starter druid-spring-boot-starter
第三方提供	第三方技術(shù)名稱-boot-starter（第三方技術(shù)名稱過長(zhǎng)，簡(jiǎn)化命名）	mybatis-plus-boot-starter

溫馨提示

? 有些小伙伴在創(chuàng)建項(xiàng)目時(shí)想通過勾選的形式找到這個(gè)名字，別翻了，沒有。截止目前，SpringBoot官網(wǎng)還未收錄此坐標(biāo)，而我們Idea創(chuàng)建模塊時(shí)讀取的是SpringBoot官網(wǎng)的Spring Initializr，所以也沒有。如果換用阿里云的url創(chuàng)建項(xiàng)目可以找到對(duì)應(yīng)的坐標(biāo)。

步驟②：配置數(shù)據(jù)源相關(guān)信息

#2.配置相關(guān)信息
spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://localhost:3306/ssm_db
    username: root
    password: root

? 沒了，就這么多，剩下的就是寫MyBaitsPlus的程序了

映射接口（Dao）

@Mapper
public interface BookDao extends BaseMapper<Book> {
}

? 核心在于Dao接口繼承了一個(gè)BaseMapper的接口，這個(gè)接口中幫助開發(fā)者預(yù)定了若干個(gè)常用的API接口，簡(jiǎn)化了通用API接口的開發(fā)工作。

溫馨提示

目前數(shù)據(jù)庫(kù)的表名定義規(guī)則是tbl_模塊名稱，為了能和實(shí)體類相對(duì)應(yīng)，需要做一個(gè)配置，相關(guān)知識(shí)我前面mybatis-plus的文章中已經(jīng)有詳細(xì)解釋，此處僅給出解決方案。配置application.yml文件，添加如下配置即可，設(shè)置所有表名的通用前綴名

mybatis-plus:
  global-config:
    db-config:
      table-prefix: tbl_		#設(shè)置所有表的通用前綴名稱為tbl_

總結(jié)

手工添加MyBatis-Plus對(duì)應(yīng)的starter
數(shù)據(jù)層接口使用BaseMapper簡(jiǎn)化開發(fā)
需要使用的第三方技術(shù)無法通過勾選確定時(shí)，需要手工添加坐標(biāo) 整合Druid

前面整合MyBatis和MyBatisPlus的時(shí)候，使用的數(shù)據(jù)源對(duì)象都是SpringBoot默認(rèn)的數(shù)據(jù)源對(duì)象，下面我們手工控制一下，自己指定了一個(gè)數(shù)據(jù)源對(duì)象，Druid。

? 在沒有指定數(shù)據(jù)源時(shí)，我們的配置如下：

#2.配置相關(guān)信息
spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://localhost:3306/ssm_db?serverTimezone=Asia/Shanghai
    username: root
    password: root

? 此時(shí)雖然沒有指定數(shù)據(jù)源，但是根據(jù)SpringBoot的德行，肯定幫我們選了一個(gè)它認(rèn)為最好的數(shù)據(jù)源對(duì)象，這就是HiKari。通過啟動(dòng)日志可以查看到對(duì)應(yīng)的身影。

2021-11-29 09:39:15.202 INFO 12260 --- [ main] com.zaxxer.hikari.HikariDataSource : HikariPool-1 - Starting...
2021-11-29 09:39:15.208 WARN 12260 --- [ main] com.zaxxer.hikari.util.DriverDataSource : Registered driver with driverClassName=com.mysql.jdbc.Driver was not found, trying direct instantiation.
2021-11-29 09:39:15.551 INFO 12260 --- [ main] com.zaxxer.hikari.HikariDataSource : HikariPool-1 - Start completed.

? 上述信息中每一行都有HiKari的身影，如果需要更換數(shù)據(jù)源，其實(shí)只需要兩步即可。

導(dǎo)入對(duì)應(yīng)的技術(shù)坐標(biāo)
配置使用指定的數(shù)據(jù)源類型

下面就切換一下數(shù)據(jù)源對(duì)象

步驟①：導(dǎo)入對(duì)應(yīng)的坐標(biāo)（注意，是坐標(biāo)，此處不是starter）

<dependencies>
    <dependency>
        <groupId>com.alibaba</groupId>
        <artifactId>druid</artifactId>
        <version>1.1.16</version>
    </dependency>
</dependencies>

步驟②：修改配置，在數(shù)據(jù)源配置中有一個(gè)type屬性，專用于指定數(shù)據(jù)源類型

spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://localhost:3306/ssm_db?serverTimezone=UTC
    username: root
    password: *********
    type: com.alibaba.druid.pool.DruidDataSource

? 這里其實(shí)要提出一個(gè)問題的，目前的數(shù)據(jù)源配置格式是一個(gè)通用格式，不管你換什么數(shù)據(jù)源都可以用這種形式進(jìn)行配置。但是新的問題又來了，如果對(duì)數(shù)據(jù)源進(jìn)行個(gè)性化的配置，例如配置數(shù)據(jù)源對(duì)應(yīng)的連接數(shù)量，這個(gè)時(shí)候就有新的問題了。每個(gè)數(shù)據(jù)源技術(shù)對(duì)應(yīng)的配置名稱都一樣嗎？肯定不是啊，各個(gè)廠商不可能提前商量好都寫一樣的名字啊，怎么辦？就要使用專用的配置格式了。這個(gè)時(shí)候上面這種通用格式就不能使用了，怎么辦？還能怎么辦？按照SpringBoot整合其他技術(shù)的通用規(guī)則來套啊，導(dǎo)入對(duì)應(yīng)的starter，進(jìn)行相應(yīng)的配置即可。

步驟①：導(dǎo)入對(duì)應(yīng)的starter

<dependencies>
    <dependency>
        <groupId>com.alibaba</groupId>
        <artifactId>druid-spring-boot-starter</artifactId>
        <version>1.2.6</version>
    </dependency>
</dependencies>

步驟②：修改配置

spring:
  datasource:
    druid:
      driver-class-name: com.mysql.cj.jdbc.Driver
      url: jdbc:mysql://localhost:3306/ssm_db?serverTimezone=UTC
      username: root
      password: *************

? 注意觀察，配置項(xiàng)中，在datasource下面并不是直接配置url這些屬性的，而是先配置了一個(gè)druid節(jié)點(diǎn)，然后再配置的url這些東西。言外之意，url這個(gè)屬性是druid下面的屬性，那你能想到什么？除了這4個(gè)常規(guī)配置外，還有druid專用的其他配置。通過提示功能可以打開druid相關(guān)的配置查閱