通用 Mapper4 是一个可以实现任意 MyBatis 通用方法的框架，项目提供了常规的增删改查操作以及Example 相关的单表操作。通用 Mapper 是为了解决 MyBatis 使用中 90% 的基本操作，使用它可以很方便的进行开发，可以节省开发人员大量的时间。

【官方文档】

https://github.com/abel533/Mapper/wiki

【maven依赖】

http://mvnrepository.com/artifact/tk.mybatis/mapper-spring-boot-starter

<dependency>
    <groupId>tk.mybatis</groupId>
    <artifactId>mapper-spring-boot-starter</artifactId>
    <version>2.1.5</version>
</dependency>

在这里插入图片描述

【本文Demo】

https://github.com/qidasheng2012/springboot2.x_ssm/tree/branch-mapper4

【整合步骤】

1. 引入TkMybatis的Maven依赖
2. 实体类的相关配置,@Id,@Table
3. Mapper继承tkMabatis的Mapper接口
4. 启动类Application或自定义Mybatis配置类上使用@MapperScan注解扫描Mapper接口
5. 在application.properties配置文件中,配置mapper.xml文件指定的位置[可选]
6. 使用TkMybatis提供的sql执行方法

PS : 
    1. TkMybatis默认使用继承Mapper接口中传入的实体类对象去数据库寻找对应的表,因此如果表名与实体类名不满足对应规则时,会报错,这时使用@Table为实体类指定表。(这种对应规则为驼峰命名规则)
    2. 使用TkMybatis可以无xml文件实现数据库操作,只需要继承tkMybatis的Mapper接口即可。
    3. 如果有自定义特殊的需求,可以添加mapper.xml进行自定义sql书写,但路径必须与步骤4对应。
    
6. 如有需要,实现mapper.xml自定义sql语句

【pom.xml】

引入mapper-spring-boot-starter的Maven依赖
因为mapper-spring-boot-starter中包含MyBatis的相关包，所以不需要再引入MyBatis的相关包
在这里插入图片描述

<?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.2.0.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>

    <groupId>com.springboot</groupId>
    <artifactId>springboot2.x_ssm</artifactId>
    <version>1.0.0</version>
    <description>Spring Boot2.x 搭建 SSM 项目</description>

    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
        <java.version>1.8</java.version>
    </properties>

    <dependencies>
        <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>tk.mybatis</groupId>
            <artifactId>mapper-spring-boot-starter</artifactId>
            <version>2.1.5</version>
        </dependency>
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <scope>runtime</scope>
        </dependency>

        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <optional>true</optional>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

</project>

【User】

实体类的相关配置,@Id,@Table

package com.springboot.ssm.domain;

import lombok.Data;

import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;
import javax.persistence.Table;

@Data
// @Table指定该实体类对应的表名,如表名为base_customer,类名为BaseCustomer可以不需要此注解
@Table(name = "user")
public class User {
    // @Id表示该字段对应数据库表的主键id
    // @GeneratedValue中strategy表示使用数据库自带的主键生成策略.
    // @GeneratedValue中generator配置为"JDBC",在数据插入完毕之后,会自动将主键id填充到实体类中.类似普通mapper.xml中配置的selectKey标签
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY, generator = "JDBC")
    private Integer id;
    private String name;
    private Integer age;
}

【MysqlBaseMapper】

package com.springboot.ssm.common.mapper;

import tk.mybatis.mapper.common.IdsMapper;
import tk.mybatis.mapper.common.Mapper;
import tk.mybatis.mapper.common.MySqlMapper;

public interface MysqlBaseMapper<T> extends Mapper<T>, MySqlMapper<T>, IdsMapper<T> {
}

实际开发中我们会自定义一个基础的BaseMapper，继承Mapper, MySqlMapper, IdsMapper，可以根据实际情况进行扩展继承

为何要继承MySqlMapper, IdsMapper接口？各位道友点进去看下源码就一目了然

注意：这个MysqlBaseMapper和业务的Mapper不要在同一个包下，否则会报下面的错

在这里插入图片描述

【UserMapper 】

UserMapper 继承自定义的MysqlBaseMapper接口

package com.springboot.ssm.mapper;

import com.springboot.ssm.common.mapper.MysqlBaseMapper;
import com.springboot.ssm.domain.User;

public interface UserMapper extends MysqlBaseMapper<User> {

}

【SsmApplication】

启动类Application或自定义Mybatis配置类上使用@MapperScan注解扫描Mapper接口

注意包名：tk.mybatis.spring.annotation.MapperScan

package com.springboot.ssm;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import tk.mybatis.spring.annotation.MapperScan;

@SpringBootApplication
@MapperScan(basePackages = "com.springboot.ssm.mapper")
public class SsmApplication {

    public static void main(String[] args) {
        SpringApplication.run(SsmApplication.class, args);
    }

}

【application.yml】

在application.yml配置文件中,配置mapper.xml文件指定的位置[可选]

spring:
  #数据源
  datasource:
    url: jdbc:mysql://localhost:3306/ssm?serverTimezone=Asia/Shanghai&characterEncoding=utf8
    username: root
    password: 123456

mybatis:
  # 定义mapper.xml的路径
  mapper-locations: classpath*:mapper/*.xml
  #起别名。可省略写mybatis的xml中的resultType的全路径
  type-aliases-package: com.springboot.ssm.domain
mapper:
  # 配置后会自动处理关键字，可以配的值和数据库有关。
  wrap-keyword: '`{0}`'
  # insertSelective 和 updateByPrimaryKeySelective 中，是否判断字符串类型 !=''。
  notEmpty: true

# 日志
logging:
  level:
    com.springboot.ssm.mapper: debug # 显示执行sql

使用TkMybatis提供的sql执行方法

【UserController】

package com.springboot.ssm.controller;

import com.springboot.ssm.domain.User;
import com.springboot.ssm.service.UserService;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;

import java.util.List;

@Slf4j
@RestController
@RequestMapping("/user")
public class UserController {

    @Autowired
    private UserService userService;

    @GetMapping("/selectAll")
    public List<User> selectAll() {
        return userService.selectAll();
    }

    @GetMapping("/selectByIds/{ids}")
    public List<User> selectByIds(@PathVariable String ids) {
        return userService.selectByIds(ids);
    }

    @PostMapping("/addOne")
    public int addOne(@RequestBody User user) {
        return userService.addOne(user);
    }
}

【UserService 】

package com.springboot.ssm.service;

import com.springboot.ssm.domain.User;

import java.util.List;

public interface UserService {
    // 查询所有用户信息
    List<User> selectAll();

    // 根据ids查询用户信息
    List<User> selectByIds(String ids);

    // 新增一个用户
    int addOne(User user);
}

【UserServiceImpl 】

package com.springboot.ssm.service.impl;

import com.springboot.ssm.domain.User;
import com.springboot.ssm.mapper.UserMapper;
import com.springboot.ssm.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

import java.util.List;

@Service
public class UserServiceImpl implements UserService {

    @Autowired
    private UserMapper userMapper;

    @Override
    public List<User> selectAll() {
        return userMapper.selectAll();
    }

    @Override
    public List<User> selectByIds(String ids) {
        return userMapper.selectByIds(ids);
    }

    @Override
    public int addOne(User user) {
        return userMapper.insertUseGeneratedKeys(user);
    }

}

【测试】

访问：http://127.0.0.1:8080/user/selectAll

在这里插入图片描述
访问：http://localhost:8080/user/selectByIds/1,2,3

访问：http://localhost:8080/user/addOne

在这里插入图片描述

【通用Mapper提供的方法】

【Select】
方法：List select(T record);
说明：根据实体中的属性值进行查询，查询条件使用等号

方法：T selectByPrimaryKey(Object key);
说明：根据主键字段进行查询，方法参数必须包含完整的主键属性，查询条件使用等号

方法：List selectAll();
说明：查询全部结果，select(null)方法能达到同样的效果

方法：T selectOne(T record);
说明：根据实体中的属性进行查询，只能有一个返回值，有多个结果是抛出异常，查询条件使用等号

方法：int selectCount(T record);
说明：根据实体中的属性查询总数，查询条件使用等号

【Insert】
方法：int insert(T record);
说明：保存一个实体，null的属性也会保存，不会使用数据库默认值

方法：int insertSelective(T record);
说明：保存一个实体，null的属性不会保存，会使用数据库默认值

【Update】
方法：int updateByPrimaryKey(T record);
说明：根据主键更新实体全部字段，null值会被更新

方法：int updateByPrimaryKeySelective(T record);
说明：根据主键更新属性不为null的值

【Delete】
方法：int delete(T record);
说明：根据实体属性作为条件进行删除，查询条件使用等号

方法：int deleteByPrimaryKey(Object key);
说明：根据主键字段进行删除，方法参数必须包含完整的主键属性

【Example方法】
方法：List selectByExample(Object example);
说明：根据Example条件进行查询
重点：这个查询支持通过Example类指定查询列，通过selectProperties方法指定查询列

方法：int selectCountByExample(Object example);
说明：根据Example条件进行查询总数

方法：int updateByExample(@Param(“record”) T record, @Param(“example”) Object example);
说明：根据Example条件更新实体record包含的全部属性，null值会被更新

方法：int updateByExampleSelective(@Param(“record”) T record, @Param(“example”) Object example);
说明：根据Example条件更新实体record包含的不是null的属性值

方法：int deleteByExample(Object example);
说明：根据Example条件删除数据

【代码生成器篇】

上面我们已经看到了Mapper4的强大了，实际开发中我们不用再写基本的CRUD了，直接调用提供方法即可。如果提供的方法不满足业务需求，再按照MyBatis方式添加即可。

下面介绍使用代码生成器生成代码，进一步简化开发量

【官方文档】

https://github.com/abel533/Mapper/wiki/4.1.mappergenerator

【pom.xml 添加插件】

这里只展示添加的插件部分，整个pom.xml请自行clone项目查看

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
        </plugin>
        <plugin>
            <groupId>org.mybatis.generator</groupId>
            <artifactId>mybatis-generator-maven-plugin</artifactId>
            <version>1.3.7</version>
            <configuration>
                <configurationFile>
                    ${basedir}/src/main/resources/generatorConfig.xml
                </configurationFile>
                <overwrite>true</overwrite>
                <verbose>true</verbose>
            </configuration>
            <dependencies>
                <dependency>
                    <groupId>mysql</groupId>
                    <artifactId>mysql-connector-java</artifactId>
                    <version>5.1.29</version>
                </dependency>
                <dependency>
                    <groupId>tk.mybatis</groupId>
                    <artifactId>mapper</artifactId>
                    <version>4.1.5</version>
                </dependency>
            </dependencies>
        </plugin>
    </plugins>
</build>

在/src/main/resources下添加generatorConfig.xml文件，文件内容如下（道友可根据注释提示，配置自己的项目）

<!DOCTYPE generatorConfiguration
        PUBLIC "-//mybatis.org//DTD MyBatis Generator Configuration 1.0//EN"
        "http://mybatis.org/dtd/mybatis-generator-config_1_0.dtd">

<generatorConfiguration>

    <context id="Mysql" targetRuntime="MyBatis3Simple" defaultModelType="flat">
        <!--beginningDelimiter 和 endingDelimiter 开始和结束分隔符，对于有关键字的情况下适用。-->
        <property name="beginningDelimiter" value="`"/>
        <property name="endingDelimiter" value="`"/>

        <plugin type="tk.mybatis.mapper.generator.MapperPlugin">
            <!--业务Mapper继承自定义MysqlBaseMapper-->
            <property name="mappers" value="com.springboot.ssm.common.mapper.MysqlBaseMapper"/>
            <!--caseSensitive 是否区分大小写，默认值 false。如果数据库区分大小写，这里就需要配置为 true，这样当表名为 USER 时，会生成 @Table(name = "USER") 注解，否则使用小写 user 时会找不到表-->
            <property name="caseSensitive" value="true"/>
            <!--forceAnnotation 是否强制生成注解，默认 false，如果设置为 true，不管数据库名和字段名是否一致，都会生成注解（包含 @Table 和 @Column）-->
            <property name="forceAnnotation" value="true"/>
            <!--lombok 增加 model 代码生成时，可以直接生成 lombok 的注解-->
            <property name="lombok" value="Data,Accessors"/>
        </plugin>

        <!--配置数据库-->
        <jdbcConnection driverClass="com.mysql.jdbc.Driver"
                        connectionURL="jdbc:mysql://localhost:3306/ssm?serverTimezone=Asia/Shanghai"
                        userId="root"
                        password="123456">
        </jdbcConnection>

        <!--生成的model配置-->
        <javaModelGenerator targetPackage="com.springboot.ssm.domain"
                            targetProject="src/main/java"/>

        <!--生成的xxMapper.xml配置-->
        <sqlMapGenerator targetPackage="mapper"
                         targetProject="src/main/resources"/>

        <!--生成的xxMapper接口配置-->
        <javaClientGenerator targetPackage="com.springboot.ssm.mapper"
                             targetProject="src/main/java"
                             type="XMLMAPPER"/>

        <!--设置表名-->
        <table tableName="teacher">
            <generatedKey column="id" sqlStatement="JDBC"/>
        </table>
    </context>
</generatorConfiguration>

根据下图操作，即可生成代码
在这里插入图片描述
查看下生成的代码：

【Teacher】

package com.springboot.ssm.domain;

import lombok.Data;
import lombok.experimental.Accessors;

import javax.persistence.Column;
import javax.persistence.GeneratedValue;
import javax.persistence.Id;
import javax.persistence.Table;

@Data
@Accessors(chain = true)
@Table(name = "teacher")
public class Teacher {
    /**
     * 主键
     */
    @Id
    @Column(name = "id")
    @GeneratedValue(generator = "JDBC")
    private Integer id;

    /**
     * 姓名
     */
    @Column(name = "name")
    private String name;
}

【TeacherMapper】

package com.springboot.ssm.mapper;

import com.springboot.ssm.common.mapper.MysqlBaseMapper;
import com.springboot.ssm.domain.Teacher;

public interface TeacherMapper extends MysqlBaseMapper<Teacher> {
}

【TeacherMapper.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.springboot.ssm.mapper.TeacherMapper">
  <resultMap id="BaseResultMap" type="com.springboot.ssm.domain.Teacher">
    <id column="id" jdbcType="INTEGER" property="id" />
    <result column="name" jdbcType="VARCHAR" property="name" />
  </resultMap>
</mapper>

大功告成！

齐大圣2012

发布了138 篇原创文章 · 获赞 69 · 访问量 13万+

私信关注

SpringBoot2.x整合MyBatis通用Mapper4

【官方文档】

【maven依赖】

【本文Demo】

【整合步骤】

【pom.xml】

【User】

【MysqlBaseMapper】

【UserMapper 】

【SsmApplication】

【application.yml】

【UserController】

【UserService 】

【UserServiceImpl 】

【测试】

【通用Mapper提供的方法】

【代码生成器篇】

【官方文档】

【pom.xml 添加插件】

【Teacher】

【TeacherMapper】

【TeacherMapper.xml】

猜你喜欢

SpringBoot2.x整合MyBatis通用Mapper4

【官方文档】

【maven依赖】

【本文Demo】

【整合步骤】

【pom.xml】

【User】

【MysqlBaseMapper】

【UserMapper 】

【SsmApplication】

【application.yml】

【UserController】

【UserService 】

【UserServiceImpl 】

【测试】

【通用Mapper提供的方法】

【代码生成器 篇】

【官方文档】

【pom.xml 添加插件】

【Teacher】

【TeacherMapper】

【TeacherMapper.xml】

猜你喜欢

【代码生成器篇】