Spring?Boot?集成?MyBatis?全面講解(最新推薦)
Spring Boot 集成 MyBatis 全面講解
MyBatis 是一款優(yōu)秀的持久層框架，與 Spring Boot 集成后可以大大簡(jiǎn)化開(kāi)發(fā)流程。本文將全面講解如何在 Spring Boot 中集成 MyBatis，包括環(huán)境配置、基礎(chǔ)操作、高級(jí)功能和最佳實(shí)踐。
一、MyBatis 簡(jiǎn)介
1. SqlSession
SqlSession 是 MyBatis 的核心接口，負(fù)責(zé)執(zhí)行 SQL 語(yǔ)句、獲取映射器實(shí)例以及管理事務(wù)。
1.1 SqlSession 的創(chuàng)建
SqlSession 通常通過(guò) SqlSessionFactory 獲取。以下是創(chuàng)建 SqlSessionFactory 的典型代碼：
InputStream inputStream = Resources.getResourceAsStream("mybatis-config.xml");
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
try (SqlSession session = sqlSessionFactory.openSession()) {
// 使用 session 進(jìn)行數(shù)據(jù)庫(kù)操作
}注意：在 Spring 集成中，
SqlSessionFactory和SqlSession的創(chuàng)建由框架管理，我們只需要通過(guò)依賴(lài)注入獲取即可。
1.2 SqlSession 的常用方法
SqlSession 提供了多種方法，用于執(zhí)行數(shù)據(jù)庫(kù)操作：
查詢(xún)操作：
// 單條記錄查詢(xún)
User user = session.selectOne("namespace.statementId", parameter);
// 多條記錄查詢(xún)
List<User> users = session.selectList("namespace.statementId", parameter);
插入操作：
int rows = session.insert("namespace.statementId", parameter);更新操作：
int rows = session.update("namespace.statementId", parameter);刪除操作：
int rows = session.delete("namespace.statementId", parameter);事務(wù)控制：
session.commit(); // 提交事務(wù)session.rollback(); // 回滾事務(wù)
2. Mapper 映射器
Mapper 映射器是 MyBatis 的核心功能，用于實(shí)現(xiàn) SQL 和 Java 方法之間的映射。它可以通過(guò)注解或 XML 配置。
2.1 基于注解的 Mapper
注解方式直接將 SQL 寫(xiě)在 Mapper 接口中，簡(jiǎn)單高效，適合簡(jiǎn)單場(chǎng)景。
示例代碼：
@Mapper
public interface UserMapper {
@Select("SELECT * FROM user WHERE id = #{id}")
User selectById(Long id);
@Insert("INSERT INTO user (username, email) VALUES (#{username}, #{email})")
int insertUser(User user);
@Update("UPDATE user SET email = #{email} WHERE id = #{id}")
int updateUser(User user);
@Delete("DELETE FROM user WHERE id = #{id}")
int deleteUser(Long id);
}2.2 基于 XML 的 Mapper
XML 配置更加靈活，適合復(fù)雜查詢(xún)場(chǎng)景。Mapper XML 文件通常位于 resources/mapper 目錄。
Mapper 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.example.mapper.UserMapper">
<!-- 查詢(xún) -->
<select id="selectById" parameterType="long" resultType="com.example.entity.User">
SELECT * FROM user WHERE id = #{id}
</select>
<!-- 插入 -->
<insert id="insertUser" parameterType="com.example.entity.User">
INSERT INTO user (username, email)
VALUES (#{username}, #{email})
</insert>
<!-- 更新 -->
<update id="updateUser" parameterType="com.example.entity.User">
UPDATE user SET email = #{email} WHERE id = #{id}
</update>
<!-- 刪除 -->
<delete id="deleteUser" parameterType="long">
DELETE FROM user WHERE id = #{id}
</delete>
</mapper>2.3 Mapper 映射器的工作機(jī)制
Mapper 接口的方法名和參數(shù)需要與 XML 中的 id 和 parameterType 對(duì)應(yīng)。MyBatis 會(huì)通過(guò)動(dòng)態(tài)代理為 Mapper 接口生成實(shí)現(xiàn)類(lèi)，并調(diào)用對(duì)應(yīng)的 SQL。
3. 配置文件
MyBatis 的配置文件包括全局配置文件（mybatis-config.xml）和映射文件（mapper.xml）。
3.1 全局配置文件
mybatis-config.xml 定義了數(shù)據(jù)庫(kù)連接、日志設(shè)置、別名等全局配置。
典型配置示例：
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN" "http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
<!-- 環(huán)境配置 -->
<environments default="development">
<environment id="development">
<transactionManager type="JDBC"/>
<dataSource type="POOLED">
<property name="driver" value="com.mysql.cj.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/mybatis_demo"/>
<property name="username" value="root"/>
<property name="password" value="root"/>
</dataSource>
</environment>
</environments>
<!-- 別名配置 -->
<typeAliases>
<typeAlias type="com.example.entity.User" alias="User"/>
</typeAliases>
<!-- Mapper 映射文件 -->
<mappers>
<mapper resource="mapper/UserMapper.xml"/>
</mappers>
</configuration>3.2 映射文件配置
映射文件定義了具體的 SQL 和 Java 對(duì)象之間的關(guān)系。以 UserMapper.xml 為例：
<mapper namespace="com.example.mapper.UserMapper">
<select id="selectAll" resultType="User">
SELECT * FROM user
</select>
<resultMap id="UserResultMap" type="User">
<id column="id" property="id"/>
<result column="username" property="username"/>
<result column="email" property="email"/>
</resultMap>
</mapper>4. ResultMap
ResultMap 是 MyBatis 的強(qiáng)大特性之一，用于處理復(fù)雜查詢(xún)結(jié)果與 Java 對(duì)象的映射關(guān)系。
4.1 什么是 ResultMap？
ResultMap 用于自定義數(shù)據(jù)庫(kù)字段與 Java 對(duì)象屬性的映射。它支持嵌套映射、別名和字段處理，適合復(fù)雜的對(duì)象映射場(chǎng)景。
4.2 ResultMap 配置示例
以下是一個(gè)帶嵌套對(duì)象的 ResultMap 配置：
數(shù)據(jù)庫(kù)表：
CREATE TABLE user (
id BIGINT PRIMARY KEY,
username VARCHAR(50),
email VARCHAR(100)
);
CREATE TABLE address (
id BIGINT PRIMARY KEY,
user_id BIGINT,
city VARCHAR(50),
FOREIGN KEY (user_id) REFERENCES user(id)
);Java 對(duì)象：
@Data
public class User {
private Long id;
private String username;
private String email;
private Address address;
}
@Data
public class Address {
private Long id;
private String city;
}ResultMap 配置：
<resultMap id="UserWithAddress" type="User">
<id column="id" property="id"/>
<result column="username" property="username"/>
<result column="email" property="email"/>
<association property="address" javaType="Address">
<id column="address_id" property="id"/>
<result column="city" property="city"/>
</association>
</resultMap>查詢(xún)語(yǔ)句：
<select id="getUserWithAddress" resultMap="UserWithAddress">
SELECT u.id, u.username, u.email, a.id AS address_id, a.city
FROM user u
LEFT JOIN address a ON u.id = a.user_id
WHERE u.id = #{id}
</select>4.3 嵌套集合映射
對(duì)于一對(duì)多的嵌套關(guān)系，可以使用 <collection>：
<resultMap id="UserWithPosts" type="User">
<id column="id" property="id"/>
<result column="username" property="username"/>
<collection property="posts" ofType="Post">
<id column="post_id" property="id"/>
<result column="title" property="title"/>
</collection>
</resultMap>總結(jié)
SqlSession、Mapper、配置文件 和 ResultMap 是 MyBatis 的核心概念。通過(guò)靈活的配置和映射，MyBatis 可以高效地處理各種復(fù)雜的數(shù)據(jù)庫(kù)操作需求。熟練掌握這些特性可以讓開(kāi)發(fā)者在項(xiàng)目中更高效地處理數(shù)據(jù)訪問(wèn)邏輯。
三、Spring Boot 集成 MyBatis
MyBatis 是一種輕量級(jí)的持久層框架，與 Spring Boot 集成后可以極大地提升開(kāi)發(fā)效率。以下是集成的完整步驟，包括項(xiàng)目配置、數(shù)據(jù)庫(kù)設(shè)計(jì)和基本操作。
1. 創(chuàng)建 Spring Boot 項(xiàng)目
在創(chuàng)建項(xiàng)目時(shí)，可以使用 Spring Initializr 快速生成骨架項(xiàng)目。以下依賴(lài)是集成 MyBatis 所必需的：
- Spring Web：用于創(chuàng)建 REST API。
- MyBatis Framework：MyBatis 的核心依賴(lài)。
- MySQL Driver：連接 MySQL 數(shù)據(jù)庫(kù)。
- Lombok：簡(jiǎn)化實(shí)體類(lèi)的開(kāi)發(fā)，減少樣板代碼。
2. 配置 pom.xml
以下是需要在 pom.xml 中添加的 Maven 依賴(lài)：
<dependencies>
<!-- Spring Boot Starter -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter</artifactId>
</dependency>
<!-- MyBatis Starter -->
<dependency>
<groupId>org.mybatis.spring.boot</groupId>
<artifactId>mybatis-spring-boot-starter</artifactId>
<version>3.0.0</version>
</dependency>
<!-- MySQL Driver -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-j</artifactId>
</dependency>
<!-- Lombok -->
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
</dependency>
</dependencies>這些依賴(lài)包括 Spring Boot 核心、MyBatis 框架、MySQL 數(shù)據(jù)庫(kù)驅(qū)動(dòng)和 Lombok。版本號(hào)可以根據(jù)項(xiàng)目需求進(jìn)行調(diào)整。
3. 配置數(shù)據(jù)庫(kù)連接
在 src/main/resources 目錄下創(chuàng)建 application.yml 文件，用于配置項(xiàng)目的數(shù)據(jù)庫(kù)連接。
application.yml 示例
spring:
datasource:
url: jdbc:mysql://localhost:3306/mybatis_demo?useSSL=false&serverTimezone=UTC
username: root
password: root
driver-class-name: com.mysql.cj.jdbc.Driver
mybatis:
mapper-locations: classpath:mapper/*.xml
type-aliases-package: com.example.demo.entity說(shuō)明：
url：數(shù)據(jù)庫(kù)連接地址。username和password：數(shù)據(jù)庫(kù)的用戶(hù)名和密碼。mapper-locations：指定 MyBatis 的 XML 映射文件路徑。type-aliases-package：指定實(shí)體類(lèi)所在的包，用于啟用簡(jiǎn)化的類(lèi)名映射。
4. 創(chuàng)建數(shù)據(jù)庫(kù)表
使用以下 SQL 語(yǔ)句創(chuàng)建一個(gè)簡(jiǎn)單的用戶(hù)表：
SQL 示例
CREATE DATABASE IF NOT EXISTS mybatis_demo;
USE mybatis_demo;
CREATE TABLE user (
id BIGINT PRIMARY KEY AUTO_INCREMENT,
username VARCHAR(50) NOT NULL,
password VARCHAR(50) NOT NULL,
email VARCHAR(100) NOT NULL,
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);此 SQL 創(chuàng)建了一個(gè)名為 user 的表，用于存儲(chǔ)用戶(hù)信息。字段包括用戶(hù) ID、用戶(hù)名、密碼、電子郵件以及創(chuàng)建時(shí)間。
5. 編寫(xiě)實(shí)體類(lèi)
創(chuàng)建與數(shù)據(jù)庫(kù)表對(duì)應(yīng)的 Java 實(shí)體類(lèi)。
User.java
package com.example.demo.entity;
import lombok.Data;
import java.time.LocalDateTime;
@Data
public class User {
private Long id;
private String username;
private String password;
private String email;
private LocalDateTime createdAt;
}說(shuō)明：
- 使用了 Lombok 的
@Data注解，自動(dòng)生成getter、setter、toString等方法。 - 字段名稱(chēng)與數(shù)據(jù)庫(kù)表的列名保持一致，便于自動(dòng)映射。
6. 創(chuàng)建 Mapper 接口
MyBatis 的 Mapper 接口用于定義數(shù)據(jù)庫(kù)操作?？梢赃x擇使用注解方式或者 XML 配置方式編寫(xiě) SQL。
注解方式 Mapper
以下是一個(gè)基于注解的 Mapper 接口示例：
package com.example.demo.mapper;
import com.example.demo.entity.User;
import org.apache.ibatis.annotations.*;
import java.util.List;
@Mapper
public interface UserMapper {
@Insert("INSERT INTO user (username, password, email) VALUES (#{username}, #{password}, #{email})")
int insertUser(User user);
@Select("SELECT * FROM user WHERE id = #{id}")
User selectById(Long id);
@Select("SELECT * FROM user")
List<User> selectAllUsers();
@Update("UPDATE user SET username = #{username}, password = #{password}, email = #{email} WHERE id = #{id}")
int updateUser(User user);
@Delete("DELETE FROM user WHERE id = #{id}")
int deleteUser(Long id);
}XML 配置方式 Mapper
XML 配置方式更靈活，適合復(fù)雜查詢(xún)場(chǎng)景。以下是對(duì)應(yīng)的 XML 映射文件。
文件位置：src/main/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.example.demo.mapper.UserMapper">
<insert id="insertUser" parameterType="com.example.demo.entity.User">
INSERT INTO user (username, password, email)
VALUES (#{username}, #{password}, #{email})
</insert>
<select id="selectById" parameterType="long" resultType="com.example.demo.entity.User">
SELECT * FROM user WHERE id = #{id}
</select>
<select id="selectAllUsers" resultType="com.example.demo.entity.User">
SELECT * FROM user
</select>
<update id="updateUser" parameterType="com.example.demo.entity.User">
UPDATE user SET username = #{username}, password = #{password}, email = #{email} WHERE id = #{id}
</update>
<delete id="deleteUser" parameterType="long">
DELETE FROM user WHERE id = #{id}
</delete>
</mapper>在 Spring Boot 中，MyBatis 會(huì)自動(dòng)掃描 mapper 文件夾下的 XML 文件。
7. 創(chuàng)建 Service 層
為了更好地分離業(yè)務(wù)邏輯，建議將 Mapper 操作封裝到 Service 層中。
UserService.java
package com.example.demo.service;
import com.example.demo.entity.User;
import com.example.demo.mapper.UserMapper;
import org.springframework.stereotype.Service;
import java.util.List;
@Service
public class UserService {
private final UserMapper userMapper;
public UserService(UserMapper userMapper) {
this.userMapper = userMapper;
}
public int createUser(User user) {
return userMapper.insertUser(user);
}
public User getUserById(Long id) {
return userMapper.selectById(id);
}
public List<User> getAllUsers() {
return userMapper.selectAllUsers();
}
public int updateUser(User user) {
return userMapper.updateUser(user);
}
public int deleteUser(Long id) {
return userMapper.deleteUser(id);
}
}8. 創(chuàng)建 Controller 層
最后，為了提供對(duì)外接口，創(chuàng)建 Controller。
UserController.java
package com.example.demo.controller;
import com.example.demo.entity.User;
import com.example.demo.service.UserService;
import org.springframework.web.bind.annotation.*;
import java.util.List;
@RestController
@RequestMapping("/api/users")
public class UserController {
private final UserService userService;
public UserController(UserService userService) {
this.userService = userService;
}
@PostMapping
public String createUser(@RequestBody User user) {
userService.createUser(user);
return "User created successfully!";
}
@GetMapping("/{id}")
public User getUserById(@PathVariable Long id) {
return userService.getUserById(id);
}
@GetMapping
public List<User> getAllUsers() {
return userService.getAllUsers();
}
@PutMapping
public String updateUser(@RequestBody User user) {
userService.updateUser(user);
return "User updated successfully!";
}
@DeleteMapping("/{id}")
public String deleteUser(@PathVariable Long id) {
userService.deleteUser(id);
return "User deleted successfully!";
}
}9. 啟動(dòng)應(yīng)用
創(chuàng)建項(xiàng)目主類(lèi) MyBatisDemoApplication.java：
package com.example.demo;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
@SpringBootApplication
public class MyBatisDemoApplication {
public static void main(String[] args) {
SpringApplication.run(MyBatisDemoApplication.class, args);
}
}啟動(dòng)項(xiàng)目，使用工具（如 Postman 或 CURL）測(cè)試接口。
四、MyBatis 基礎(chǔ)操作詳解
以下將詳細(xì)講解 MyBatis 的基礎(chǔ)操作，包括如何創(chuàng)建實(shí)體類(lèi)、Mapper 接口、XML 映射文件，以及如何通過(guò) Service 和 Controller 層完成基礎(chǔ)的增刪改查功能。
1. 創(chuàng)建實(shí)體類(lèi)
實(shí)體類(lèi)用于表示數(shù)據(jù)庫(kù)中的表記錄，在 MyBatis 中，實(shí)體類(lèi)字段與數(shù)據(jù)庫(kù)表的列進(jìn)行一一對(duì)應(yīng)。
示例代碼：User.java
package com.example.demo.entity;
import lombok.Data;
import java.time.LocalDateTime;
@Data
public class User {
private Long id; // 用戶(hù)ID
private String username; // 用戶(hù)名
private String password; // 密碼
private String email; // 郵箱
private LocalDateTime createdAt; // 創(chuàng)建時(shí)間
}說(shuō)明：
- 使用
@Data注解自動(dòng)生成getter、setter、toString等方法。 - 字段名稱(chēng)與數(shù)據(jù)庫(kù)表的列名保持一致，便于 MyBatis 自動(dòng)映射。
2. 創(chuàng)建 Mapper 接口
Mapper 接口定義了對(duì)數(shù)據(jù)庫(kù)表的操作。MyBatis 支持兩種方式：基于注解和基于 XML 映射文件。
基于注解的 Mapper 接口
以下是使用注解定義的基礎(chǔ)增刪改查操作：
package com.example.demo.mapper;
import com.example.demo.entity.User;
import org.apache.ibatis.annotations.*;
import java.util.List;
@Mapper
public interface UserMapper {
// 插入用戶(hù)
@Insert("INSERT INTO user (username, password, email) VALUES (#{username}, #{password}, #{email})")
int insertUser(User user);
// 查詢(xún)所有用戶(hù)
@Select("SELECT * FROM user")
List<User> getAllUsers();
// 根據(jù) ID 查詢(xún)用戶(hù)
@Select("SELECT * FROM user WHERE id = #{id}")
User getUserById(Long id);
// 更新用戶(hù)
@Update("UPDATE user SET username = #{username}, password = #{password}, email = #{email} WHERE id = #{id}")
int updateUser(User user);
// 刪除用戶(hù)
@Delete("DELETE FROM user WHERE id = #{id}")
int deleteUser(Long id);
}注意：
- 使用
@Mapper注解讓 Spring 容器自動(dòng)掃描 Mapper 接口。 - 注解方式適合簡(jiǎn)單的 SQL 語(yǔ)句，對(duì)于復(fù)雜查詢(xún)建議使用 XML。
3. 配置 XML 映射文件
在復(fù)雜查詢(xún)場(chǎng)景中，XML 配置文件更加靈活。
文件位置
src/main/resources/mapper/UserMapper.xml
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.example.demo.mapper.UserMapper">
<!-- 定義字段與屬性的映射 -->
<resultMap id="UserResultMap" type="com.example.demo.entity.User">
<id column="id" property="id" />
<result column="username" property="username" />
<result column="password" property="password" />
<result column="email" property="email" />
<result column="created_at" property="createdAt" />
</resultMap>
<!-- 查詢(xún)所有用戶(hù) -->
<select id="getAllUsers" resultMap="UserResultMap">
SELECT * FROM user
</select>
<!-- 插入用戶(hù) -->
<insert id="insertUser" parameterType="com.example.demo.entity.User">
INSERT INTO user (username, password, email)
VALUES (#{username}, #{password}, #{email})
</insert>
<!-- 更新用戶(hù) -->
<update id="updateUser" parameterType="com.example.demo.entity.User">
UPDATE user
SET username = #{username}, password = #{password}, email = #{email}
WHERE id = #{id}
</update>
<!-- 刪除用戶(hù) -->
<delete id="deleteUser" parameterType="long">
DELETE FROM user WHERE id = #{id}
</delete>
</mapper>注意：
namespace必須與 Mapper 接口的全路徑名稱(chēng)一致。<resultMap>定義了表字段與實(shí)體類(lèi)屬性之間的映射關(guān)系。#{}用于參數(shù)占位，MyBatis 會(huì)根據(jù)參數(shù)類(lèi)型自動(dòng)替換。
4. 創(chuàng)建 Service 層
為了實(shí)現(xiàn)業(yè)務(wù)邏輯與數(shù)據(jù)訪問(wèn)的分離，建議通過(guò) Service 層封裝 Mapper 的操作。
示例代碼：UserService.java
package com.example.demo.service;
import com.example.demo.entity.User;
import com.example.demo.mapper.UserMapper;
import org.springframework.stereotype.Service;
import java.util.List;
@Service
public class UserService {
private final UserMapper userMapper;
public UserService(UserMapper userMapper) {
this.userMapper = userMapper;
}
// 添加用戶(hù)
public int addUser(User user) {
return userMapper.insertUser(user);
}
// 獲取所有用戶(hù)
public List<User> getAllUsers() {
return userMapper.getAllUsers();
}
// 根據(jù) ID 查詢(xún)用戶(hù)
public User getUserById(Long id) {
return userMapper.getUserById(id);
}
// 更新用戶(hù)
public int updateUser(User user) {
return userMapper.updateUser(user);
}
// 刪除用戶(hù)
public int deleteUser(Long id) {
return userMapper.deleteUser(id);
}
}說(shuō)明：
- 通過(guò)依賴(lài)注入的方式引入
UserMapper。 - 將所有的數(shù)據(jù)庫(kù)操作封裝為獨(dú)立的方法，便于管理和復(fù)用。
5. 創(chuàng)建 Controller 層
Controller 層提供 RESTful API 接口，供外部訪問(wèn) Service 方法。 示例代碼：UserController.java
package com.example.demo.controller;
import com.example.demo.entity.User;
import com.example.demo.service.UserService;
import org.springframework.web.bind.annotation.*;
import java.util.List;
@RestController
@RequestMapping("/api/users")
public class UserController {
private final UserService userService;
public UserController(UserService userService) {
this.userService = userService;
}
// 創(chuàng)建用戶(hù)
@PostMapping
public String createUser(@RequestBody User user) {
userService.addUser(user);
return "User created successfully!";
}
// 獲取所有用戶(hù)
@GetMapping
public List<User> getAllUsers() {
return userService.getAllUsers();
}
// 根據(jù) ID 獲取用戶(hù)
@GetMapping("/{id}")
public User getUserById(@PathVariable Long id) {
return userService.getUserById(id);
}
// 更新用戶(hù)
@PutMapping
public String updateUser(@RequestBody User user) {
userService.updateUser(user);
return "User updated successfully!";
}
// 刪除用戶(hù)
@DeleteMapping("/{id}")
public String deleteUser(@PathVariable Long id) {
userService.deleteUser(id);
return "User deleted successfully!";
}
}說(shuō)明：
- 使用
@RestController標(biāo)注類(lèi)，返回 JSON 數(shù)據(jù)。 - 通過(guò)
@RequestBody接收前端傳遞的 JSON 數(shù)據(jù)。 - 通過(guò)
@PathVariable獲取 URL 中的動(dòng)態(tài)參數(shù)。
五、高級(jí)功能
1. 動(dòng)態(tài) SQL
動(dòng)態(tài) SQL 是 MyBatis 的強(qiáng)大功能之一，可以根據(jù)輸入條件動(dòng)態(tài)生成 SQL 語(yǔ)句。相比手動(dòng)拼接 SQL，這種方式更加安全、高效且可維護(hù)。
1.1 動(dòng)態(tài) SQL 標(biāo)簽
MyBatis 提供了以下動(dòng)態(tài) SQL 標(biāo)簽：
<if>：用于條件判斷。<choose>：類(lèi)似于 Java 的switch-case。<where>：自動(dòng)添加WHERE關(guān)鍵字并處理多個(gè)條件。<set>：動(dòng)態(tài)生成SET子句，常用于更新語(yǔ)句。<foreach>：用于迭代生成 SQL（如IN子句或批量插入）。<trim>：自定義 SQL 前后綴（如添加括號(hào)、處理多余逗號(hào)等）。
1.2 動(dòng)態(tài) SQL 示例
（1）條件查詢(xún)：根據(jù)用戶(hù)輸入動(dòng)態(tài)生成查詢(xún)條件
XML 配置文件：
<select id="searchUsers" resultMap="UserResultMap">
SELECT * FROM user
<where>
<if test="username != null">
AND username = #{username}
</if>
<if test="email != null">
AND email = #{email}
</if>
</where>
</select>注意：
<where>標(biāo)簽會(huì)自動(dòng)處理?xiàng)l件的拼接，并在至少有一個(gè)條件成立時(shí)自動(dòng)添加WHERE關(guān)鍵字。
Java 調(diào)用代碼：
Map<String, Object> params = new HashMap<>();
params.put("username", "John");
params.put("email", null);
List<User> users = userMapper.searchUsers(params);（2）動(dòng)態(tài)更新：根據(jù)非空字段更新用戶(hù)信息
在實(shí)際場(chǎng)景中，往往需要對(duì)部分字段進(jìn)行更新，MyBatis 的動(dòng)態(tài) SQL 可以輕松實(shí)現(xiàn)。
XML 配置文件：
<update id="updateUser" parameterType="User">
UPDATE user
<set>
<if test="username != null">
username = #{username},
</if>
<if test="password != null">
password = #{password},
</if>
<if test="email != null">
email = #{email},
</if>
</set>
WHERE id = #{id}
</update>注意：
<set>標(biāo)簽會(huì)自動(dòng)處理逗號(hào)，確保生成的 SQL 語(yǔ)句語(yǔ)法正確。null值的字段會(huì)被忽略，避免誤更新。
Java 調(diào)用代碼：
User user = new User();
user.setId(1L);
user.setUsername("NewName");
int rows = userMapper.updateUser(user);（3）批量查詢(xún)：使用 <foreach> 生成 IN 子句
XML 配置文件：
<select id="findUsersByIds" resultMap="UserResultMap">
SELECT * FROM user
WHERE id IN
<foreach collection="idList" item="id" open="(" separator="," close=")">
#{id}
</foreach>
</select>說(shuō)明：
collection指定輸入?yún)?shù)（一般為 List 或數(shù)組）。item是每次迭代的變量。open、separator和close分別定義 SQL 子句的開(kāi)頭、分隔符和結(jié)尾。
Java 調(diào)用代碼：
List<Long> idList = Arrays.asList(1L, 2L, 3L); List<User> users = userMapper.findUsersByIds(idList);
生成的 SQL：
SELECT * FROM user WHERE id IN (1, 2, 3);
2. 分頁(yè)查詢(xún)
分頁(yè)查詢(xún)是 Web 應(yīng)用中最常見(jiàn)的功能之一。在 MyBatis 中，可以借助 PageHelper 插件實(shí)現(xiàn)高效分頁(yè)。
2.1 使用 PageHelper 插件
（1）引入依賴(lài)
在 pom.xml 中添加以下依賴(lài)：
<dependency>
<groupId>com.github.pagehelper</groupId>
<artifactId>pagehelper-spring-boot-starter</artifactId>
<version>1.4.0</version>
</dependency>（2）分頁(yè)查詢(xún)示例
在 Service 層調(diào)用分頁(yè)方法：
import com.github.pagehelper.PageHelper;
import com.github.pagehelper.PageInfo;
public List<User> getUsersByPage(int pageNum, int pageSize) {
// 啟用分頁(yè)
PageHelper.startPage(pageNum, pageSize);
List<User> users = userMapper.getAllUsers();
// 封裝分頁(yè)結(jié)果
return new PageInfo<>(users).getList();
}（3）自定義分頁(yè)
如果不想引入插件，也可以通過(guò)手動(dòng)拼接分頁(yè) SQL：
XML 配置文件：
<select id="getUsersByPage" resultMap="UserResultMap">
SELECT * FROM user
LIMIT #{offset}, #{pageSize}
</select>Mapper 接口：
List<User> getUsersByPage(@Param("offset") int offset, @Param("pageSize") int pageSize);Java 調(diào)用代碼：
int offset = (pageNum - 1) * pageSize; List<User> users = userMapper.getUsersByPage(offset, pageSize);
3. 復(fù)雜對(duì)象映射
3.1 一對(duì)多映射
場(chǎng)景：一個(gè)用戶(hù)有多個(gè)訂單。
數(shù)據(jù)庫(kù)表設(shè)計(jì)：
CREATE TABLE orders (
id BIGINT PRIMARY KEY,
user_id BIGINT,
order_name VARCHAR(255),
FOREIGN KEY (user_id) REFERENCES user(id)
);XML 配置文件：
<resultMap id="UserWithOrders" type="User">
<id column="id" property="id"/>
<result column="username" property="username"/>
<collection property="orders" ofType="Order">
<id column="order_id" property="id"/>
<result column="order_name" property="orderName"/>
</collection>
</resultMap>
<select id="getUserWithOrders" resultMap="UserWithOrders">
SELECT u.id, u.username, o.id AS order_id, o.order_name
FROM user u
LEFT JOIN orders o ON u.id = o.user_id
WHERE u.id = #{id}
</select>3.2 嵌套查詢(xún)
對(duì)于復(fù)雜的多表查詢(xún)，可以使用嵌套查詢(xún)實(shí)現(xiàn)。
XML 配置：
<resultMap id="OrderResultMap" type="Order">
<id column="id" property="id"/>
<result column="order_name" property="orderName"/>
</resultMap>
<resultMap id="UserWithOrders" type="User">
<id column="id" property="id"/>
<result column="username" property="username"/>
<collection property="orders" resultMap="OrderResultMap" column="id"/>
</resultMap>
<select id="getUserWithOrders" resultMap="UserWithOrders">
SELECT * FROM user WHERE id = #{id};
</select>六、最佳實(shí)踐
1. 分層設(shè)計(jì)
- Controller 層：負(fù)責(zé)接收請(qǐng)求和返回響應(yīng)。
- Service 層：封裝業(yè)務(wù)邏輯。
- Mapper 層：專(zhuān)注于數(shù)據(jù)庫(kù)交互。
2. 避免 N+1 查詢(xún)
一對(duì)多、多對(duì)多場(chǎng)景中，優(yōu)先使用聯(lián)合查詢(xún)或嵌套查詢(xún)，避免多個(gè) SQL 執(zhí)行。
3. 啟用日志
在 application.yml 中啟用 MyBatis 日志：
mybatis:
configuration:
log-impl: org.apache.ibatis.logging.stdout.StdOutImpl4. 動(dòng)態(tài) SQL 使用
<foreach>實(shí)現(xiàn)批量操作。- 使用
<if>結(jié)合<set>實(shí)現(xiàn)動(dòng)態(tài)更新。
總結(jié)
MyBatis 的高級(jí)功能如動(dòng)態(tài) SQL、分頁(yè)查詢(xún)和復(fù)雜對(duì)象映射，為開(kāi)發(fā)者提供了極大的靈活性。在項(xiàng)目中，結(jié)合實(shí)際場(chǎng)景選擇合適的實(shí)現(xiàn)方式，可以顯著提高開(kāi)發(fā)效率并降低維護(hù)成本。如果有任何疑問(wèn)，歡迎在評(píng)論區(qū)留言討論！
到此這篇關(guān)于Spring Boot 集成 MyBatis 全面講解(最新推薦)的文章就介紹到這了,更多相關(guān)Spring Boot 集成 MyBatis內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！
- 5分鐘快速搭建SpringBoot3?+?MyBatis-Plus工程/項(xiàng)目的實(shí)現(xiàn)示例
- 解決mybatis-plus-boot-starter與mybatis-spring-boot-starter的錯(cuò)誤問(wèn)題
- Spring Boot 中整合 MyBatis-Plus詳細(xì)步驟(最新推薦)
- Spring Boot 中使用 Mybatis Plus的操作方法
- SpringBoot同時(shí)集成Mybatis和Mybatis-plus框架
- Springboot使用MybatisPlus實(shí)現(xiàn)mysql樂(lè)觀鎖
- 淺談Spring Boot、MyBatis、MyBatis-Plus 依賴(lài)版本對(duì)應(yīng)關(guān)系
- Spring Boot Mybatis++ 2025詳解
相關(guān)文章
Java批量從svn導(dǎo)出多個(gè)項(xiàng)目代碼實(shí)例
這篇文章主要介紹了java批量從svn導(dǎo)出多個(gè)項(xiàng)目代碼實(shí)例,文中通過(guò)示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友可以參考下2020-03-03
Spring Security @PreAuthorize注解分析
本教程介紹了如何使用 Spring 方法級(jí)安全和 @PreAuthorize 注解來(lái)保護(hù) RestController 方法,通過(guò)這些步驟,您可以確保只有具有適當(dāng)角色或權(quán)限的用戶(hù)才能訪問(wèn)特定的 REST API,感興趣的朋友跟隨小編一起看看吧2024-11-11
今天小編就為大家分享一篇關(guān)于Java抽象類(lèi)的概念講解，小編覺(jué)得內(nèi)容挺不錯(cuò)的，現(xiàn)在分享給大家，具有很好的參考價(jià)值，需要的朋友一起跟隨小編來(lái)看看吧2019-02-02
log4j控制日志輸出文件名稱(chēng)的兩種方式小結(jié)
這篇文章主要介紹了log4j控制日志輸出文件名稱(chēng)的兩種方式小結(jié)，具有很好的參考價(jià)值，希望對(duì)大家有所幫助。如有錯(cuò)誤或未考慮完全的地方，望不吝賜教2021-12-12
在hibernate中，提到性能優(yōu)化，很自然地我們就想到了緩存。緩存是什么，都有哪些呢？下面這篇文章就主要給大家介紹了關(guān)于Hibernate緩存與性能優(yōu)化的相關(guān)資料，需要的朋友可以參考下。2017-02-02
CCF考試試題之門(mén)禁系統(tǒng)java解題代碼
這篇文章主要為大家詳細(xì)介紹了CCF考試試題之門(mén)禁系統(tǒng)java解題代碼，文中示例代碼介紹的非常詳細(xì)，具有一定的參考價(jià)值，感興趣的小伙伴們可以參考一下2019-01-01
SpringCloud Nacos配置中心管理超詳細(xì)講解
這篇文章主要介紹了Springcloud中的Nacos服務(wù)配置,本文以用戶(hù)微服務(wù)為例，進(jìn)行統(tǒng)一的配置，結(jié)合實(shí)例代碼給大家介紹的非常詳細(xì)，需要的朋友可以參考下2022-11-11
Java版數(shù)據(jù)結(jié)構(gòu)插入數(shù)據(jù)時(shí)遇到的結(jié)點(diǎn)為空的問(wèn)題詳解
這篇文章主要介紹了Java版數(shù)據(jù)結(jié)構(gòu)插入數(shù)據(jù)時(shí)遇到的結(jié)點(diǎn)為空的問(wèn)題及解決辦法，需要的朋友們可以學(xué)習(xí)下。2019-09-09
java統(tǒng)計(jì)文件中每個(gè)字符出現(xiàn)的個(gè)數(shù)
這篇文章主要為大家詳細(xì)介紹了java統(tǒng)計(jì)文件中每個(gè)字符出現(xiàn)的個(gè)數(shù)，具有一定的參考價(jià)值，感興趣的小伙伴們可以參考一下2019-03-03
Spring data JPA只查詢(xún)部分字段問(wèn)題及解決
這篇文章主要介紹了Spring data JPA只查詢(xún)部分字段問(wèn)題及解決,具有很好的參考價(jià)值,希望對(duì)大家有所幫助,如有錯(cuò)誤或未考慮完全的地方,望不吝賜教2024-08-08