SpringBoot学习总结（4）之整合Mybatis

柔情只为你懂 2022-02-24 13:20 214阅读 0赞

# 一、介绍 #

上一篇中我已经介绍了SpringBoot整合MVC框架，在这节中我主要是介绍SpringBoot整合Mybatis，在这里我会讲解在整合中可能会遇到的各种错误以及对应的解决方法。

## 二、环境 ##

*  IntelliJ IDEA 2017.2.6 x64
 *  springboot1.5.4.RELEASE
 *  jdk1.8
 *  maven 3.6.0

# 三、开发步骤 #

1.打开Idea，点击File->然后右键 new project

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2pva2VNcWM_size_16_color_FFFFFF_t_70][]

选择对应的JDK版本，我这里选择的是JDK8，然后点击next。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2pva2VNcWM_size_16_color_FFFFFF_t_70 1][]

这里是对应的项目配置，按照自己的需求填写，然后点击Next。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2pva2VNcWM_size_16_color_FFFFFF_t_70 2][]

这里是勾选我们项目中要依赖的jar包，这里我们只需要对应mysql的jar跟mybatis的jar就可以了。然后点击next。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2pva2VNcWM_size_16_color_FFFFFF_t_70 3][]

填写项目名称以及项目的保存路径，然后点击finish，完成之后需要等待一下，因为需要下载对应的依赖jar包。然后下载完之后，我们的项目架构就出来了，springboot为我们自动封装了数据源，我们只要resources目录下新建一个application.yml（官方推荐使用，因为更加的简介）或者是application.**properties。**

在此我贴上对应pom的配置解释：

<?xml version="1.0" encoding="UTF-8"?>
    <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    	<modelVersion>4.0.0</modelVersion>
    	<parent>
    		<groupId>org.springframework.boot</groupId>
    		<artifactId>spring-boot-starter-parent</artifactId>
    		<version>2.1.3.RELEASE</version>
    		<relativePath/> 
    	</parent>
    	<groupId>com.mqc</groupId>
    	<artifactId>springboot-mybatis</artifactId>
    	<version>0.0.1-SNAPSHOT</version>
    	<name>springboot-mybatis</name>
    	<description>Demo project for Spring Boot</description>
    
    	<properties>
    		<java.version>1.8</java.version>
    	</properties>
    
    	<dependencies>
    		
    		<dependency>
    			<groupId>org.springframework.boot</groupId>
    			<artifactId>spring-boot-starter-web</artifactId>
    		</dependency>
    		
    		<dependency>
    			<groupId>org.mybatis.spring.boot</groupId>
    			<artifactId>mybatis-spring-boot-starter</artifactId>
    			<version>2.0.0</version>
    		</dependency>
    		
    		<dependency>
    			<groupId>org.springframework.boot</groupId>
    			<artifactId>spring-boot-devtools</artifactId>
    			<scope>runtime</scope>
    		</dependency>
    		
    		<dependency>
    			<groupId>mysql</groupId>
    			<artifactId>mysql-connector-java</artifactId>
    			<scope>runtime</scope>
    		</dependency>
    		
    		<dependency>
    			<groupId>com.alibaba</groupId>
    			<artifactId>druid</artifactId>
    			<version>1.0.9</version>
    		</dependency>
    		<dependency>
    			<groupId>org.springframework.boot</groupId>
    			<artifactId>spring-boot-starter-test</artifactId>
    			<scope>test</scope>
    		</dependency>
    	</dependencies>
    
    	<build>
    		<plugins>
    			<plugin>
    				<groupId>org.springframework.boot</groupId>
    				<artifactId>spring-boot-maven-plugin</artifactId>
    			</plugin>
    		</plugins>
    	</build>
    
    </project>

如下图，我已经新建了我们最常见的web项目目录结构，但是可以看到，springboot默认新建的项目跟我们新建的包是在不同的层级的包，需要注意的，springboot启动类会默认扫描同层级下所有的包的类上的注解，我们这样子的项目结构springboot启动是扫描不到对应的注解，这个时候我们就有两种解决方法：

1.  把springboot的启动类移到我们同一层级上
2.  在springboot启动上加上扫描注解，扫描我们对应的包即可

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2pva2VNcWM_size_16_color_FFFFFF_t_70 4][]

这里我们到启动类移到对应的层级上，然后添加对应的数据库配置。

mybatis:
    #xml配置开发，对应mapper.xml配置文件路径
      mapper-locations: classpath:mapper/*.xml
    
    #数据库配置
    spring:
      datasource:
        driver-class-name: com.mysql.jdbc.Driver
        url: jdbc:mysql://localhost/joker_mqc?useUnicode=true&characterEncoding=utf8&useSSL=false
        username: root
        password: 199507
        druid:
              validationQuery: SELECT 1
              initialSize: 10
              minIdle: 10
              maxActive: 200
              minEvictableIdleTimeMillis: 180000
              testOnBorrow: false
              testWhileIdle: true
              removeAbandoned: true
              removeAbandonedTimeout: 1800
              logAbandoned: true
              poolPreparedStatements: true
              maxOpenPreparedStatements: 100

其实，到这里，SpringBoot整合简单的mybatis就已经搭建好了，不得不说springboot是真的强大，接下来我们就测试我们的整合结果吧。

首先我们新建一张表用于测试，这里我就提前新建好了一个user\_info表：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2pva2VNcWM_size_16_color_FFFFFF_t_70 5][]

创建我们的实体类：

package com.mqc.entrty;
    
    import javax.print.DocFlavor;
    
    /**
     * @author maoqichuan
     * @ClassName: UserInfo
     * @description: TODO
     * @date 2019-04-0315:14
     **/
    public class UserInfo {
        private Integer id;
        private String userName;
        private String password;
    
        public Integer getId() {
            return id;
        }
    
        public void setId(Integer id) {
            this.id = id;
        }
    
        public String getUserName() {
            return userName;
        }
    
        public void setUserName(String userName) {
            this.userName = userName;
        }
    
        public String getPassword() {
            return password;
        }
    
        public void setPassword(String password) {
            this.password = password;
        }
    }

创建对应的mapper类，注意我们给这个类加上了@mapper，标记着这是一个mapper类

package com.mqc.mapper;
    
    import org.apache.ibatis.annotations.Mapper;
    import org.apache.ibatis.annotations.Param;
    
    @Mapper
    public interface UserMapper {
        void save(@Param("username") String username,@Param("password") String password);
    }

然后在resources/mapper下新建对应UserMapper.xml文件

<?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.mqc.mapper.UserMapper">
    
    
        <insert id="save">
            INSERT INTO user_info(username,password) VALUES (#{username},#{password})
        </insert>
    </mapper>

我们再新建一个service接口

package com.mqc.service;
    
    /**
    * @description: 用户业务逻辑类
    * @author maoqichuan
    * @date 2019-04-03 15:17
    */
    public interface IUserService {
        void save(String username,String password) throws Exception;
    }

然后在新建对应的实现类，@Transactional标记这个类具有事务处理能力。

package com.mqc.service.impl;
    
    import com.mqc.mapper.UserMapper;
    import com.mqc.service.IUserService;
    import org.springframework.beans.factory.annotation.Autowired;
    import org.springframework.stereotype.Service;
    import org.springframework.transaction.annotation.Transactional;
    
    /**
     * @author maoqichuan
     * @ClassName: UserServiceImpl
     * @description: TODO
     * @date 2019-04-0315:18
     **/
    @Service
    @Transactional
    public class UserServiceImpl implements IUserService {
        @Autowired
        private UserMapper userMapper;
    
        @Override
        public void save(String username, String password) throws Exception {
            userMapper.save(username,password);
        }
    }

然后在新建对应的controller

package com.mqc.web.controller;
    
    import com.mqc.service.IUserService;
    import org.springframework.beans.factory.annotation.Autowired;
    import org.springframework.stereotype.Controller;
    import org.springframework.web.bind.annotation.RequestMapping;
    import org.springframework.web.bind.annotation.RestController;
    
    /**
     * @author maoqichuan
     * @ClassName: UserController
     * @description: 用户逻辑控制类
     * @date 2019-04-0315:19
     **/
    @RestController
    @RequestMapping("/user")
    public class UserController {
    
        @Autowired
        private IUserService userService;
    
        @RequestMapping("/save")
        public String save(String username,String password) throws Exception{
            userService.save(username,password);
            return "save success";
        }
    }

然后在我们的启动类上加上：@EnableTransactionManagement 开启事务处理能力

package com.mqc;
    
    import org.mybatis.spring.annotation.MapperScan;
    import org.springframework.boot.SpringApplication;
    import org.springframework.boot.autoconfigure.SpringBootApplication;
    import org.springframework.transaction.annotation.EnableTransactionManagement;
    
    @SpringBootApplication
    @EnableTransactionManagement // 开启事务管理
    //在对应的mapper类加上@mapper注解就不用去扫
    public class SpringbootMybatisApplication {
    
    	public static void main(String[] args) {
    		SpringApplication.run(SpringbootMybatisApplication.class, args);
    	}
    
    }

到这里，整个测试代码已经写完了，让我们来启动一下验证一下我们的结果吧。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2pva2VNcWM_size_16_color_FFFFFF_t_70 6][]

然后细心的朋友可能会发现，控制器中打印了那么一句话，到最后测试还不成功！！！到底是啥原因，让我们来看看。

![20190404114606432.png][]

其实整个原因我们要来看我们的pom文件，细心的朋友有没有发现我们的pom文件的每一个依赖都是没有对应的版本号的，那到底是引用哪一个版本呢？

<parent>
    		<groupId>org.springframework.boot</groupId>
    		<artifactId>spring-boot-starter-parent</artifactId>
    		<version>2.1.3.RELEASE</version>
    		<relativePath/> 
    	</parent>

看到这，我想大家已经知道原因了，这个相当于是我们继承的父项目，他的版本是2.1.3的，这对应我们mysql来说太高，解决方案只要把springboot的版本降低就可以了。

<parent>
    		<groupId>org.springframework.boot</groupId>
    		<artifactId>spring-boot-starter-parent</artifactId>
    		<version>1.5.4.RELEASE</version>
    		<relativePath/> 
    	</parent>

这时候我们再启动就一直正常了。

![20190404115205836.png][]

然后返回成功，这时候我们再去看看我们的数据库到底有没有插入成功。

![20190404115243722.png][]

到这里，springboot整合mybatis已经介绍完了，本篇介绍的还是比较简单的应用，下篇将会介绍springboot配置多数据源配置，希望哪里写的不好或者不对的请纠正，让我们在技术路上一路修行，一起进步！！加油。

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2pva2VNcWM_size_16_color_FFFFFF_t_70]: /images/20220224/68427cd0061a4b44b005dfe42d66e35b.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2pva2VNcWM_size_16_color_FFFFFF_t_70 1]: /images/20220224/e199a5713cd5464d8d7a9eb8dcd7c57e.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2pva2VNcWM_size_16_color_FFFFFF_t_70 2]: /images/20220224/b4752180d0cc49659c51d3fb30a7c078.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2pva2VNcWM_size_16_color_FFFFFF_t_70 3]: /images/20220224/ad2b5fbac0ea4d9694a37f3c51dc28fc.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2pva2VNcWM_size_16_color_FFFFFF_t_70 4]: /images/20220224/d3b1adcf69c1458ebf5e0b75d3fdf8c3.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2pva2VNcWM_size_16_color_FFFFFF_t_70 5]: /images/20220224/45adc140e07d44228e0421c526aac02f.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2pva2VNcWM_size_16_color_FFFFFF_t_70 6]: /images/20220224/1e64d8236fc44c7b96abe2e75bd51192.png
[20190404114606432.png]: /images/20220224/2cd94e6fe61e4a40a75ceaa4316e9e13.png
[20190404115205836.png]: /images/20220224/b63538dd473f4db0bb0a00c9ad27d32e.png
[20190404115243722.png]: /images/20220224/024cda8d1adb483d972ad7efc246e4ba.png