mapper4与springboot的简单整合

最近自己在网上搜索一些关于 mapper4 的教程，一直都没有找到简单明了的，所以就只能自己写一篇初级入门的 mapper4 与当下最火的 springboot 的整合。

1. 首先我们需要用 IDEA 工具新建一个 springboot 的项目。

Group 和 Artfact 需要自己进行填写，否则就是默认的。

选择 Web 和 MySQL

然后点击下一步完成就好了。

项目建好之后的结构如下所示，需要将 application.properties 改名为 application.yml。

2. 需要在 maven 里面添加相关的依赖。

<!-- 添加通用 Mapper 提供的 starter -->
<dependency>
    <groupId>tk.mybatis</groupId>
    <artifactId>mapper-spring-boot-starter</artifactId>
    <version>2.1.5</version>
</dependency>
<!-- 添加 lombok 插件 -->
<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <version>1.18.6</version>
    <scope>provided</scope>
</dependency>

3.application 配置文件进行相关设置。

# 端口号
server:
  port: 8088
spring:
  #数据库连接数据配置
  datasource:
    url: jdbc:mysql://localhost:3306/mapper-test
    username: root
    password: 123456
mybatis:
  #驼峰命名法
  configuration:
    map-underscore-to-camel-case: true
  #配置 mybatis 的全局配置文件
  mapper-locations: classpath:mapping/*.xml
#sql 语句的打印
logging:
  level:
    com:
      mapper4:
        www:
          debug

4. 需要在 Spring Boot 的启动类上用 @MapperScan 注解进行配置。

@tk.mybatis.spring.annotation.MapperScan(basePackages = "扫描包")

5. 新建一个 Girl 的实体类，并将其放到 entity 包中。

用 lombok 的 @Data 注解，这样就可以省略掉 get/set 等方法。

6. 新建一个 GirlMapper 接口类，并将其放入到 mapper 包中。

继承 BaseMapper< 实体类 > 类。

7. 新建一个 GirlController 类，将其放到 controller 中。

写一个根据 id 查询数据的方法。

8. 用 postman 进行接口的调用你就会发现可以成功的查询出相关的数据了。

拓展

如果你想要自己写一些 sql 语句进行查询，不想使用 mapper4 自带的方法的话，那你就需要自己写一个 *mapper.xml。
这里我们简单的写一个 *mapper.xml 进行查询。
其实我们在 application.yml 里面已经进行了相关的配置了。

这样程序就会自动的去这个目录下面去扫描相关的 xml 进行关联了。

我们需要在 resources 里面新建一个 mapping 文件夹，里面来存放我们写的 *mapper.xml 文件

需要在 GirlMapper.xml 里面添加一个新的查询 SQL。

在 GirlMapper 类中添加这个方法，然后就可以在 GirlController 里面进行调用了。

在 GirlController 里面添加相关的方法。

进行测试就可以了，发现也是可以的，至此我们就完成了 springboot 与 mapper4 的简单集成。