SpringBoot使用MyBatis的XML文件進(jìn)行SQL語(yǔ)句編寫(xiě)
前言
在現(xiàn)代 Java Web 開(kāi)發(fā)中，Spring Boot 和 MyBatis 是兩個(gè)非常流行的技術(shù)框架。它們的結(jié)合使得數(shù)據(jù)庫(kù)操作變得更加簡(jiǎn)潔和高效。本文將詳細(xì)介紹如何在 Spring Boot 項(xiàng)目中使用 MyBatis 的 XML 文件來(lái)編寫(xiě) SQL 語(yǔ)句，包括配置、代碼結(jié)構(gòu)、SQL 編寫(xiě)技巧以及最佳實(shí)踐等內(nèi)容。
一、什么是 MyBatis
MyBatis 是一個(gè)基于 Java 的持久層框架，它允許開(kāi)發(fā)者通過(guò) XML 或注解方式編寫(xiě) SQL，并與 Java 對(duì)象進(jìn)行映射（ORM）。相比 Hibernate 等全自動(dòng) ORM 框架，MyBatis 更加靈活，適用于需要對(duì) SQL 進(jìn)行精細(xì)控制的場(chǎng)景。
二、Spring Boot + MyBatis 的基本架構(gòu)
典型的 Spring Boot + MyBatis 項(xiàng)目結(jié)構(gòu)如下：
src
└── main
├── java
│ └── com.example.demo
│ ├── DemoApplication.java
│ ├── controller
│ ├── service
│ ├── mapper
│ └── model
└── resources
├── application.properties
└── mapper
└── UserMapper.xml
其中 mapper 包下的接口與 resources/mapper 下的 XML 文件是一一對(duì)應(yīng)的。
三、搭建環(huán)境
1. 添加依賴（Maven）
<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.3</version>
</dependency>
<!-- MySQL 驅(qū)動(dòng) -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.33</version>
</dependency>
</dependencies>
2. 配置數(shù)據(jù)庫(kù)連接（application.properties）
spring.datasource.url=jdbc:mysql://localhost:3306/demo_db?useSSL=false&serverTimezone=UTC spring.datasource.username=root spring.datasource.password=123456 spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver mybatis.mapper-locations=classpath:mapper/**/*.xml mybatis.type-aliases-package=com.example.demo.model
四、編寫(xiě) Mapper 接口和 XML 文件
1. 創(chuàng)建實(shí)體類（Model）
package com.example.demo.model;
public class User {
private Long id;
private String name;
private String email;
// Getter and Setter
}
2. 創(chuàng)建 Mapper 接口
package com.example.demo.mapper;
import com.example.demo.model.User;
import java.util.List;
public interface UserMapper {
List<User> getAllUsers();
User getUserById(Long id);
void insertUser(User user);
void updateUser(User user);
void deleteUserById(Long id);
}
3. 創(chuàng)建 XML 映射文件
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">
<!-- 查詢所有用戶 -->
<select id="getAllUsers" resultType="User">
SELECT * FROM users
</select>
<!-- 根據(jù)ID查詢用戶 -->
<select id="getUserById" parameterType="long" resultType="User">
SELECT * FROM users WHERE id = #{id}
</select>
<!-- 插入用戶 -->
<insert id="insertUser">
INSERT INTO users (name, email)
VALUES (#{name}, #{email})
</insert>
<!-- 更新用戶 -->
<update id="updateUser">
UPDATE users
SET name = #{name}, email = #{email}
WHERE id = #{id}
</update>
<!-- 刪除用戶 -->
<delete id="deleteUserById">
DELETE FROM users WHERE id = #{id}
</delete>
</mapper>
五、動(dòng)態(tài) SQL 使用詳解
MyBatis 提供了強(qiáng)大的動(dòng)態(tài) SQL 功能，常見(jiàn)標(biāo)簽有 <if>、<choose>、<when>、<set>、<where>、<foreach> 等。
示例：根據(jù)條件查詢用戶
Mapper 接口：
List<User> searchUsers(@Param("name") String name, @Param("email") String email);
XML 文件：
<select id="searchUsers" resultType="User">
SELECT * FROM users
<where>
<if test="name != null and name != ''">
AND name LIKE CONCAT('%', #{name}, '%')
</if>
<if test="email != null and email != ''">
AND email LIKE CONCAT('%', #{email}, '%')
</if>
</where>
</select>
示例：批量插入用戶
<insert id="batchInsert">
INSERT INTO users (name, email)
VALUES
<foreach collection="list" item="user" separator=",">
(#{user.name}, #{user.email})
</foreach>
</insert>
六、測(cè)試 MyBatis SQL
可以創(chuàng)建一個(gè)簡(jiǎn)單的 Service 層調(diào)用 Mapper 并打印結(jié)果。
Service 示例
@Service
public class UserService {
@Autowired
private UserMapper userMapper;
public void printAllUsers() {
List<User> users = userMapper.getAllUsers();
users.forEach(System.out::println);
}
}
Controller 示例
@RestController
@RequestMapping("/users")
public class UserController {
@Autowired
private UserService userService;
@GetMapping
public void getUsers() {
userService.printAllUsers();
}
}
七、MyBatis XML 常見(jiàn)標(biāo)簽總結(jié)
| 標(biāo)簽 | 用途 |
|---|---|
| <select> | 查詢操作 |
| <insert> | 插入操作 |
| <update> | 更新操作 |
| <delete> | 刪除操作 |
| <where> | 自動(dòng)處理 WHERE 子句，避免多余的 AND/OR |
| <if> | 條件判斷 |
| <choose>/<when>/<otherwise> | 多條件選擇 |
| <set> | 自動(dòng)處理更新字段中的逗號(hào)問(wèn)題 |
| <foreach> | 循環(huán)處理集合數(shù)據(jù)（如 IN 子句、批量插入） |
八、最佳實(shí)踐建議
1.命名規(guī)范統(tǒng)一：XML 文件名與 Mapper 接口名保持一致。
2.SQL 與業(yè)務(wù)邏輯分離：將 SQL 放在 XML 中，便于維護(hù)和審計(jì)。
3.使用 <where> 和 <set> 避免語(yǔ)法錯(cuò)誤。
4.合理使用 <resultMap> 映射復(fù)雜對(duì)象關(guān)系。
5.開(kāi)啟 MyBatis 日志輸出，方便調(diào)試：
logging:
level:
com.example.demo.mapper: debug
九、擴(kuò)展功能推薦
PageHelper 分頁(yè)插件：輕松實(shí)現(xiàn)分頁(yè)查詢。
MyBatis Generator：自動(dòng)生成 Model、Mapper 和 XML 文件。
MyBatis Plus：增強(qiáng)型 MyBatis 工具包，簡(jiǎn)化 CRUD 操作。
十、結(jié)語(yǔ)
在 Spring Boot 中使用 MyBatis 的 XML 方式編寫(xiě) SQL，不僅保留了 SQL 的靈活性，還利用了框架提供的強(qiáng)大映射能力。通過(guò)本篇博客，你已經(jīng)掌握了從項(xiàng)目搭建到 SQL 編寫(xiě)的完整流程，以及動(dòng)態(tài) SQL 的高級(jí)用法。
以上就是SpringBoot使用MyBatis的XML文件進(jìn)行SQL語(yǔ)句編寫(xiě)的詳細(xì)內(nèi)容，更多關(guān)于SpringBoot MyBatis編寫(xiě)SQL的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！
- SpringBoot使用MyBatis Generator生成動(dòng)態(tài)SQL的詳細(xì)步驟
- 基于SpringBoot+Mybatis實(shí)現(xiàn)Mysql分表
- Springboot整合Mybatis和SQLite的詳細(xì)過(guò)程
- SpringBoot項(xiàng)目整合MybatisPlus并使用SQLite作為數(shù)據(jù)庫(kù)的過(guò)程
- Springboot應(yīng)用中Mybatis輸出SQL日志的3種方法代碼示例
- SpringBoot如何打印mybatis的執(zhí)行sql問(wèn)題
- springboot+mybatis-plus 兩種方式打印sql語(yǔ)句的方法
相關(guān)文章
MongoDB是基于Json數(shù)據(jù)結(jié)構(gòu)的非關(guān)系型數(shù)據(jù)庫(kù),每一個(gè)Json文檔有一個(gè)唯一的主鍵,下面通過(guò)實(shí)例代碼講解MongoDB在Spring Boot中的使用方式,感興趣的朋友一起看看吧2025-05-05
詳解Java中的reactive stream協(xié)議
Stream大家應(yīng)該都很熟悉了，java8中為所有的集合類都引入了Stream的概念。優(yōu)雅的鏈?zhǔn)讲僮?，流式處理邏輯，相信用過(guò)的人都會(huì)愛(ài)不釋手。本文將詳細(xì)介紹Java中的reactive stream協(xié)議。2021-06-06
在Java開(kāi)發(fā)中,字符串拼接是一個(gè)非常常見(jiàn)的操作,本文將通過(guò)實(shí)際的性能測(cè)試,深入分析 + 運(yùn)算符、StringBuilder 和 String.join() 三種字符串拼接方式的性能差異,幫助開(kāi)發(fā)者在不同場(chǎng)景下做出正確的選擇2026-05-05
在SpringBoot項(xiàng)目中動(dòng)態(tài)切換數(shù)據(jù)源和數(shù)據(jù)庫(kù)的詳細(xì)步驟
在許多企業(yè)級(jí)應(yīng)用中,可能需要根據(jù)不同的業(yè)務(wù)需求來(lái)切換不同的數(shù)據(jù)庫(kù),如讀寫(xiě)分離、分庫(kù)分表等場(chǎng)景,Spring Boot 提供了靈活的數(shù)據(jù)源配置方式,本文將介紹如何在 Spring Boot 項(xiàng)目中實(shí)現(xiàn)動(dòng)態(tài)切換數(shù)據(jù)源和數(shù)據(jù)庫(kù)的方案,需要的朋友可以參考下2025-08-08
這篇文章主要介紹了java 如何壓縮圖片體積，幫助大家更好的利用Java處理圖片，應(yīng)對(duì)特殊情況，感興趣的朋友可以了解下2020-10-10
這篇文章主要介紹了淺談Spring Boot中Redis緩存還能這么用，這種方式是Spring Cache提供的統(tǒng)一接口，實(shí)現(xiàn)既可以是Redis，也可以是Ehcache或者其他支持這種規(guī)范的緩存框架，感興趣的小伙伴們可以參考一下2019-06-06
Java Mybatis框架Dao層的實(shí)現(xiàn)與映射文件以及核心配置文件詳解分析
MyBatis 是一款優(yōu)秀的持久層框架，它支持自定義 SQL、存儲(chǔ)過(guò)程以及高級(jí)映射。MyBatis 免除了幾乎所有的 JDBC 代碼以及設(shè)置參數(shù)和獲取結(jié)果集的工作。MyBatis 可以通過(guò)簡(jiǎn)單的 XML 或注解來(lái)配置和映射原始類型、接口和 Java POJO為數(shù)據(jù)庫(kù)中的記錄2021-10-10
跟著思路走，之后從簡(jiǎn)單題入手，反復(fù)去看，做過(guò)之后可能會(huì)忘記，之后再做一次，記不住就反復(fù)做，反復(fù)尋求思路和規(guī)律，慢慢積累就會(huì)發(fā)現(xiàn)質(zhì)的變化2022-03-03
IDEA啟動(dòng)springboot項(xiàng)目報(bào)missing ServletWebServerFactory錯(cuò)誤的解決
Spring Boot項(xiàng)目在IDEA中啟動(dòng)時(shí)報(bào)錯(cuò),經(jīng)過(guò)排查發(fā)現(xiàn)是由于Tomcat依賴的AprLifecycleListener類未被正確加載,通過(guò)將Tomcat依賴的scope從provided改為compile,解決了問(wèn)題2025-12-12
在SpringBoot中如何使用HttpClient實(shí)現(xiàn)HTTP請(qǐng)求
本文介紹了如何使用Apache?HttpClient來(lái)訪問(wèn)HTTP協(xié)議的資源,并提供了詳細(xì)的使用示例,包括GET和POST請(qǐng)求的無(wú)參和有參調(diào)用2025-02-02