spring boot 2以上版本整合mybatis_org.mybatis.spring.boot版本

一、背景

       最近想复习一下spring boot和mybatis的知识，就搞了一个spring boot项目，也是通过查找网上的资料做的，但是发现大部分整合都是spring boot 1.5版本的，我使用的是2.5.4版本，就出现了许多错误。现在就来记录一下这次实现吧，同时也会实现mybatis自动生成mapper文件。希望对大家有帮助，可以通过git下载进行参考，地址：GitHub - xujiankang6/spring-boot-research

二、实现

1、通过idea创建一个spring boot项目。

 2、添加下面的依赖。

<dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
 
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
 
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-configuration-processor</artifactId>
            <optional>true</optional>
        </dependency>
 
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-devtools</artifactId>
            <optional>true</optional>
        </dependency>
        <dependency>
            <groupId>org.mybatis.spring.boot</groupId>
            <artifactId>mybatis-spring-boot-starter</artifactId>
            <version>2.0.1</version>
        </dependency>
        <dependency>
            <groupId>org.mybatis.spring.boot</groupId>
            <artifactId>mybatis-spring-boot</artifactId>
            <version>2.0.1</version>
        </dependency>
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.35</version>
        </dependency>
 
        <!--mybatis pagerhelper分页-->
        <dependency>
            <groupId>com.github.pagehelper</groupId>
            <artifactId>pagehelper-spring-boot-starter</artifactId>
            <version>1.2.5</version>
        </dependency>
        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>druid-spring-boot-starter</artifactId>
            <version>1.2.5</version>
        </dependency>

 3、同时pom文件里面</plugins>标签下面添加自动生成mybatis插件。

（1）后面需要在resources目录下新建这个目录和文件结构。/generator/generatorConfig.xml

 <!-- mybatis generator 自动生成代码插件 -->
            <plugin>
                <groupId>org.mybatis.generator</groupId>
                <artifactId>mybatis-generator-maven-plugin</artifactId>
                <version>1.3.2</version>
                <configuration>
                    <configurationFile>${basedir}/src/main/resources/generator/generatorConfig.xml</configurationFile>
                    <overwrite>true</overwrite>
                    <verbose>true</verbose>
                </configuration>
            </plugin>

4、将application.properties删除，新建application.yml文件，配置端口，mysql数据库，mybatis等。

（1）修改自己的本地数据库名，账户密码。

（2）修改自己实体类要存放的路径。

 
server:
  port: 8080
 
spring:
  datasource:
    name: test
    url: jdbc:mysql://127.0.0.1:3306/test
    username: root
    password: 123456
    # 使用druid数据源
    type: com.alibaba.druid.pool.DruidDataSource
    driver-class-name: com.mysql.jdbc.Driver
    filters: stat
    maxActive: 20
    initialSize: 1
    maxWait: 60000
    minIdle: 1
    timeBetweenEvictionRunsMillis: 60000
    minEvictableIdleTimeMillis: 300000
    validationQuery: select 'x'
    testWhileIdle: true
    testOnBorrow: false
    testOnReturn: false
    poolPreparedStatements: true
    maxOpenPreparedStatements: 20
 
## 该配置节点为独立的节点，有很多同学容易将这个配置放在spring的节点下，导致配置无法被识别
mybatis:
  mapper-locations: classpath:mapping/*.xml  #注意：一定要对应mapper映射xml文件的所在路径
  type-aliases-package: com.example.demo.model  # 注意：对应实体类的路径

5、在启动类同级目录和resources目录下新建一些文件目录。

（1）在启动类同级新建controller，mapper，model，service四个目录。

（2）在 resources目录下新建一个mapping目录，用来存放后面自动生成的mapper.xml文件。

（3）新建一个generator目录，同时新建一个generatorConfig.xml文件，跟第三步的配置的自动生成mybatis插件目录一致。文件目录如下，需要修改成自己需要自动创建的表。

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE generatorConfiguration
        PUBLIC "-//mybatis.org//DTD MyBatis Generator Configuration 1.0//EN"
        "http://mybatis.org/dtd/mybatis-generator-config_1_0.dtd">
<generatorConfiguration>
    <!-- 数据库驱动:选择你的本地硬盘上面的数据库驱动包-->
    <classPathEntry  location="D:\spring20210828\jar\mysql-connector-java-5.1.25.jar"/>
    <context id="DB2Tables"  targetRuntime="MyBatis3">
        <commentGenerator>
            <property name="suppressDate" value="true"/>
            <!-- 是否去除自动生成的注释 true：是 ： false:否 -->
            <property name="suppressAllComments" value="true"/>
        </commentGenerator>
        <!--数据库链接URL，用户名、密码 -->
        <jdbcConnection driverClass="com.mysql.jdbc.Driver" connectionURL="jdbc:mysql://127.0.0.1/test" userId="root" password="123456">
        </jdbcConnection>
        <javaTypeResolver>
            <property name="forceBigDecimals" value="false"/>
        </javaTypeResolver>
        <!-- 生成模型的包名和位置-->
        <javaModelGenerator targetPackage="com.example.demo.model" targetProject="src/main/java">
            <property name="enableSubPackages" value="true"/>
            <property name="trimStrings" value="true"/>
        </javaModelGenerator>
        <!-- 生成映射文件的包名和位置-->
        <sqlMapGenerator targetPackage="mapping" targetProject="src/main/resources">
            <property name="enableSubPackages" value="true"/>
        </sqlMapGenerator>
        <!-- 生成DAO的包名和位置-->
        <javaClientGenerator type="XMLMAPPER" targetPackage="com.example.demo.mapper" targetProject="src/main/java">
            <property name="enableSubPackages" value="true"/>
        </javaClientGenerator>
        <!-- 要生成的表 tableName是数据库中的表名或视图名 domainObjectName是实体类名-->
        <table tableName="user" domainObjectName="User" enableCountByExample="false" enableUpdateByExample="false" enableDeleteByExample="false" enableSelectByExample="false" selectByExampleQueryId="false"></table>
    </context>
</generatorConfiguration>
 
 

6、点击Edit  Configurations，新建一个maven项。

（1）命名为generator。

（2）Command line配置为下面的内容。

mybatis-generator:generate -e

 7、执行generator，只需要执行一次就会生成mapper文件和bean类。

（1）注意，只执行一次即可，多次执行generator，UserMapper文件里面会生成重复的方法，启动项目可能会报错。

 8、新建一个service接口

（1）这个接口里面的方法是复制的自动生成的UserMapper接口里面的方法。

public interface UserService {
 
    int deleteByPrimaryKey(Integer uid);
 
    int insert(User record);
 
    int insertSelective(User record);
 
    User selectByPrimaryKey(Integer uid);
 
    int updateByPrimaryKeySelective(User record);
 
    int updateByPrimaryKey(User record);
}

 9、新建service实现类

（1）引入的userMapper类，可能会爆红警告，不过不影响启动。

package com.example.demo.service.impl;
 
import com.example.demo.mapper.UserMapper;
import com.example.demo.model.User;
import com.example.demo.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
 
/**
 * UserServiceImpl
 *
 * @author jiankang.xu
 * @date 2021/8/29
 */
@Service
public class UserServiceImpl implements UserService {
 
    @Autowired
    private UserMapper userMapper;
 
    @Override
    public int deleteByPrimaryKey(Integer uid) {
        return userMapper.deleteByPrimaryKey(uid);
    }
 
    @Override
    public int insert(User record) {
        return userMapper.insert(record);
    }
 
    @Override
    public int insertSelective(User record) {
        return userMapper.insertSelective(record);
    }
 
    @Override
    public User selectByPrimaryKey(Integer uid) {
        return userMapper.selectByPrimaryKey(uid);
    }
 
    @Override
    public int updateByPrimaryKeySelective(User record) {
        return userMapper.updateByPrimaryKeySelective(record);
    }
 
    @Override
    public int updateByPrimaryKey(User record) {
        return userMapper.updateByPrimaryKey(record);
    }
}

10、新建一个controller类

package com.example.demo.controller;
 
import com.example.demo.model.User;
import com.example.demo.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;
 
/**
 * UserMapperController
 *
 * @author jiankang.xu
 * @date 2021/8/29
 */
@Controller
@RequestMapping("/mapper")
public class UserMapperController {
 
    @Autowired
    private UserService userService;
 
 
    @RequestMapping("/getuser/{uid}")
    @ResponseBody
    public User getUser(@PathVariable String uid){
        return userService.selectByPrimaryKey(Integer.valueOf(uid));
    }
}

11、启动spring boot项目，访问这个端口，就可以查询到数据库里的数据了。

三、问题

1、NoClassDefFoundError: org/springframework/boot/bind/RelaxedDataBinder

（1）这个错误是alibaba的druid数据库连接池的版本过低，原来我的版本是低于1.2.5的，spring boot 1x版本使用不会报错，我的版本是2x以上，所以改为1.2.5就不会报错了。

<!-- alibaba的druid数据库连接池 -->
<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>druid-spring-boot-starter</artifactId>
    <version>1.2.5</version>
</dependency>

2、Error creating bean with name 'com.github.pagehelper.autoconfigure.PageHelperAutoConfiguration'

（1）这个错误是mybatis pagerhelper分页依赖版本太低，不支持spring boot 2x版本，改为下面的就好了。

<!--mybatis pagerhelper分页-->
 <dependency>
     <groupId>com.github.pagehelper</groupId>
     <artifactId>pagehelper-spring-boot-starter</artifactId>
     <version>1.2.5</version>
 </dependency>

3、Error creating bean with name 'userMapper' defined in file

（1）这个在引入userMapper时，需要添加@Autowired。

四、总结

       以上就是关于spring boot 2以上版本整合mybatis的全部内容，希望能够帮到大家，这篇文章可以收获学会spring boot整合mybatis，自动生成mapper文件等等，觉得不错的话，欢迎微信搜索关注java基础笔记，后面会不断更新相关知识，大家一起进步。