第一步，在 pom.xml 文件中引入 starter。

```

<dependency>

<groupId>org.mybatis.spring.boot</groupId>

<artifactId>mybatis-spring-boot-starter</artifactId>

<version>2.2.2</version>

</dependency>

```

第二步，在 application.yml 文件中添加数据库连接配置。

```

spring:

datasource:

driver-class-name: com.mysql.cj.jdbc.Driver

username: root

password: Huicheng123**

url: jdbc:mysql://localhost:3306/codingmore-mybatis?useUnicode=true&characterEncoding=utf-8&serverTimezone=Asia/Shanghai&useSSL=false

```

第三步，导入 SQL 文件。


第四步，新建 User.java 实体类。

```java

public class User {

private Integer id;

private Integer age;

private String name;

private String password;

@Tolerate

User() {}

}

```

这里使用了 lombok 的

* [@Data](/Data ) 注解自动生成 getter/setter

* [@Builder](/Builder ) 生成链式调用

* 由于 @Data和[@Builder](/Builder ) 配合使用的时候会导致无参构造方法丢失，所以我们主动声明了无参构造方法，并使用 `@Tolerate` 注解来告诉 lombok 请允许我们的无参构造方法存在（没有无参构造方法的时候会导致 ORM 映射出错）

第五步，新建 UserMapper.java 接口：

```

public interface UserMapper {

@Select("SELECT * FROM user")

List<User> getAll();

@Select("SELECT * FROM user WHERE id = #{id}")

User getOne(Integer id);

@Insert("INSERT INTO user(name,password,age) VALUES(#{name}, #{password}, #{age})")

void insert(User user);

@Update("UPDATE user SET name=#{name},password=#{password},age=#{age} WHERE id =#{id}")

void update(User user);

@Delete("DELETE FROM user WHERE id =#{id}")

void delete(Integer id);

}

```

* [@Select](/Select ) 注解用来查询

* [@Insert](/Insert ) 注解用来插入

* [@Update](/Update ) 注解用来修改

* [@Delete](/Delete ) 注解用来删除

第六步，在启动类 CodingmoreMybatisApplication 上添加 [@MapperScan](/MapperScan ) 注解来扫描 mapper。

```

public class CodingmoreMybatisApplication {

public static void main(String[] args) {

SpringApplication.run(CodingmoreMybatisApplication.class, args);

}

}

```

如果没有指定 [@MapperScan](/MapperScan ) 的扫描路径，将从声明该注解的类的包开始进行扫描。

第七步，在测试类中对 mapper 进行测试。

```

class CodingmoreMybatisApplicationTests {

@Autowired

private UserMapper userMapper;

@Test

void testInsert() {

userMapper.insert(User.builder().age(18).name("沉默王二").password("123456").build());

userMapper.insert(User.builder().age(18).name("沉默王三").password("123456").build());

userMapper.insert(User.builder().age(18).name("沉默王四").password("123456").build());

log.info("查询所有：{}",userMapper.getAll().stream().toArray());

}

@Test

List<User> testQuery() {

List<User> all = userMapper.getAll();

log.info("查询所有：{}",all.stream().toArray());

return all;

}

@Test

void testUpdate() {

User one = userMapper.getOne(1);

log.info("更新前{}", one);

one.setPassword("654321");

userMapper.update(one);

log.info("更新后{}", userMapper.getOne(1));

}

@Test

void testDelete() {

log.info("删除前{}", userMapper.getAll().toArray());

userMapper.delete(1);

log.info("删除后{}", userMapper.getAll().toArray());

}

}

```

极简 xml 版本比较适合更加复杂的 SQL，接口层只定义空的方法，然后在 xml 中编写对应的 SQL。编程喵🐱实战项目中使用的就是这种方式。

第一步，新建 PostMapper。

```

public interface PostMapper {

List<Posts> getAll();

Posts getOne(Long id);

void insert(Posts post);

void update(Posts post);

void delete(Long id);

}

```

第二步，在 resources 目录下新建 PostMapper.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="top.codingmore.mapper.PostMapper">

<resultMap id="BaseResultMap" type="top.codingmore.entity.Posts">

<id column="posts_id" property="postsId"/>

<result column="post_author" property="postAuthor"/>

<result column="post_content" property="postContent"/>

<result column="post_title" property="postTitle"/>

</resultMap>

<sql id="Base_Column_List">

posts_id, post_author, post_content, post_title

</sql>

<select id="getAll" resultMap="BaseResultMap">

select

<include refid="Base_Column_List" />

from posts;

</select>

<select id="getOne" parameterType="java.lang.Long" resultMap="BaseResultMap" >

SELECT

<include refid="Base_Column_List" />

FROM users

WHERE id = #{id}

</select>

<insert id="insert" parameterType="top.codingmore.entity.Posts">

insert into

posts

(post_author,post_content,post_title)

values

(#{postAuthor},#{postContent},#{postTitle});

</insert>

<update id="update" parameterType="top.codingmore.entity.Posts">

update

posts

set

<if test="postAuthor != null">post_author=#{postAuthor},</if>

<if test="postContent != null">post_content=#{postContent},</if>

post_title=#{postTitle}

where id=#{id}

</update>

<delete id="delete">

delete from

posts

where

id=#{id}

</delete>

</mapper>

```

接口中方法对应的 SQL 直接写在 xml 文件中，具体位置见下图：


也可以看文件放在和 PostMapper.java 接口同级的目录下，但是这样会带来一个问题，就是 Maven 打包的时候默认会忽略 xml 文件，所以为了避免这种情况发生，我们需要在 pom.xml 文件中添加配置：

```

<build>

<resources>

<resource>

<directory>src/main/java</directory>

<includes>

<include>**/*.xml</include>

</includes>

</resource>

<resource>

<directory>src/main/resources</directory>

</resource>

</resources>

</build>

```

如果直接放在 resources 目录下，就不用担心打包时被忽略了，但放在 resources 目录下不会被  MyBatis 自动扫描到，所以需要在 application.yml 配置文件中告诉 MyBatis 具体的扫描路径：

```

mybatis:

mapper-locations: classpath:mapper/*.xml

```

第三步，在测试类中添加测试方法：

```

void testPostInsert() {

postMapper.insert(Posts.builder()

.postAuthor(1L)

.postTitle("沉默王二")

log.info("查询所有：{}",postMapper.getAll().stream().toArray());

log.info("查询所有：{}",all.stream().toArray());

log.info("更新前{}", one);

log.info("更新后{}", postMapper.getOne(1L));

log.info("删除前{}", postMapper.getAll().toArray());

log.info("删除后{}", postMapper.getAll().toArray());

<if test="searchTagId != null">

and a.posts_id in (select post_id from post_tag_relation where post_tag_id=#{searchTagId})

</if>

and ${ew.sqlSegment}

LIMIT #{pageStart}, #{pageSize}

) a

LEFT JOIN post_tag_relation ptr on a.posts_id = ptr.post_id

LEFT JOIN post_tag pt on pt.post_tag_id = ptr.post_tag_id

</select>

```

细心的小伙伴应该可以看到 `${ew.sqlSegment}` 这样的表达式，它属于 MyBatis-Plus 中的内容。

MyBatis 属于半自动的 ORM 框架，实现一些简单的 CRUD 也是需要编写 SQL 语句，那如果想省掉这些步骤的话，可以选择 [JPA](https://javabetter.cn/springboot/jpa.html)，也可以选择国人开源的 MyBatis-Plus（简称 MP）。

MP 提供了诸多优秀的特性，比如说：

* 强大的 CRUD 操作：内置了通用的 mapper、service，可通过少量的配置实现大部分常用的 CRUD，不用再编写 SQL 语句。

* 支持主键自动生成

* 支持 ActiveRecord 模式：实体类只需继承 Model 类即可进行强大的 CRUD 操作

* [强大的代码生成器](https://javabetter.cn/kaiyuan/auto-generator.html)：可快速生成 Mapper 、 Model 、 Service 、 Controller 层代码

* 内置分页插件

* 内置性能分析插件：可输出 SQL 语句以及其执行时间

我们直接进入实战。

第一步，在 pom.xml 文件中添加 MyBatis-Plus 的 starter。

```

<dependency>

<groupId>com.baomidou</groupId>

<artifactId>mybatis-plus-boot-starter</artifactId>

<version>3.4.2</version>

</dependency>

```

第二步，新建 PostTag 实体类。

```

@Data

public class PostTag {

private Long postTagId;

private String description;

}

```

对应的数据库表为 post-tag。


可以看得出，类名 PostTag，字段名 postTagId 和数据库表 post_tag、字段名 post_tag_id 并不一致，但 mp 自动帮我们做了映射关联。

第二步，新建 PostTagMapper 继承 BaseMapper，继承该接口后，无需编写 mapper.xml 文件，即可获得CRUD功能。

```

public interface PostTagMapper extends BaseMapper<PostTag> {}

```

BaseMapper里提供的方法如下：


第三步，在测试类中添加查询方法。

----

更多内容，只针对《二哥的Java进阶之路》星球用户开放，需要的小伙伴可以[戳链接🔗](https://javabetter.cn/zhishixingqiu/)加入我们的星球，一起学习，一起卷。。**编程喵**🐱是一个 Spring Boot+Vue 的前后端分离项目，融合了市面上绝大多数流行的技术要点。通过学习实战项目，你可以将所学的知识通过实践进行检验、你可以拓宽自己的技术边界，你可以掌握一个真正的实战项目是如何从 0 到 1 的。

* 编程喵：[https://github.com/itwanger/coding-more](https://github.com/itwanger/coding-more)

* codingmore-mybatis：[https://github.com/itwanger/codingmore-learning](https://github.com/itwanger/codingmore-learning/tree/main/codingmore-mybatis)

---