MyBatis 詳解及代碼示例

MyBatis 是一個 半自動 ORM 框架，主要用于 Java 與數據庫之間的持久化操作，它本質是對 JDBC 的封裝

全名：MyBatis（前身 iBATIS）
核心作用：自動將 SQL 執行結果映射為 Java 對象；也可以將 Java 對象自動轉成 SQL 參數
特點：
- SQL 寫在 XML 或注解中，開發者可控制 SQL 邏輯（相比 Hibernate 更靈活）
- 支持參數映射、結果映射
- 支持動態 SQL（根據條件生成 SQL）

🏗? 1. 在 SpringMVC 項目中的使用步驟

🌱 一、技術棧說明

Spring MVC（控制層）
MyBatis（持久層）
Spring（IoC、事務管理）
MySQL 數據庫
Maven 構建

🧱 二、項目結構示意（SpringMVC 示例）

spring-mybatis-demo/
├── src/main/java/
│   ├── com.example.controller/     # 控制層
│   ├── com.example.service/        # 業務邏輯
│   ├── com.example.mapper/         # MyBatis Mapper 接口
│   ├── com.example.model/          # 實體類
│   └── com.example.config/         # 配置類（可選）
├── src/main/resources/
│   ├── mapper/                     # MyBatis XML 映射文件
│   ├── spring-mybatis.xml          # 核心整合配置
│   └── db.properties               # 數據源配置
├── webapp/
│   ├── WEB-INF/
│   │   ├── jsp/                    # 視圖層 JSP
│   │   └── web.xml                 # Web 配置
└── pom.xml

📦 三、核心配置文件

3.1 `pom.xml`（關鍵依賴）

<dependencies><!-- Spring 核心依賴 --><dependency> <groupId>org.springframework</groupId> <artifactId>spring-webmvc</artifactId><version>5.3.30</version></dependency><!-- MyBatis --><dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis</artifactId> <version>3.5.15</version> </dependency><dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis-spring</artifactId> <version>2.1.1</version> </dependency><!-- MySQL 驅動 --><dependency><groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>8.0.30</version> </dependency><!-- 其他：日志、JSTL、Servlet 等 -->
</dependencies>

3.2 `db.properties`

jdbc.driver=com.mysql.cj.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/testdb
jdbc.username=root
jdbc.password=123456

3.3 `spring-mybatis.xml`（Spring + MyBatis 整合配置）

<beans xmlns="http://www.springframework.org/schema/beans"xmlns:context="http://www.springframework.org/schema/context"xmlns:tx="http://www.springframework.org/schema/tx"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="..."><!-- 1. 讀取屬性配置 --><context:property-placeholder location="classpath:db.properties"/><!-- 2. 配置數據源 --><bean id="dataSource" class="org.apache.commons.dbcp2.BasicDataSource"><property name="driverClassName" value="${jdbc.driver}"/><property name="url" value="${jdbc.url}"/><property name="username" value="${jdbc.username}"/><property name="password" value="${jdbc.password}"/></bean><!-- 3. 配置 SqlSessionFactory --><bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean"><property name="dataSource" ref="dataSource"/><property name="mapperLocations" value="classpath:mapper/*.xml"/><property name="typeAliasesPackage" value="com.example.model"/></bean><!-- 4. Mapper 接口掃描 --><bean class="org.mybatis.spring.mapper.MapperScannerConfigurer"><property name="basePackage" value="com.example.mapper"/></bean><!-- 5. 掃描 Service、Controller --><context:component-scan base-package="com.example"/><!-- 6. 事務管理 --><bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager"><property name="dataSource" ref="dataSource"/></bean><tx:annotation-driven transaction-manager="transactionManager"/>
</beans>

3.4 `web.xml` 配置 Spring MVC 和核心監聽器

<web-app ...><!-- Spring 容器監聽器 --><listener><listener-class>org.springframework.web.context.ContextLoaderListener</listener-class></listener><context-param><param-name>contextConfigLocation</param-name><param-value>classpath:spring-mybatis.xml</param-value></context-param><!-- Spring MVC 核心配置 --><servlet><servlet-name>spring</servlet-name><servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class><init-param><param-name>contextConfigLocation</param-name><param-value>classpath:spring-mvc.xml</param-value></init-param><load-on-startup>1</load-on-startup></servlet><servlet-mapping><servlet-name>spring</servlet-name><url-pattern>/</url-pattern></servlet-mapping>
</web-app>

💻 四、代碼示例

4.1 實體類 `User.java`

public class User {private Integer id;private String name;private Integer age;// Getter / Setter
}

4.2 Mapper 接口 `UserMapper.java`

java復制編輯public interface UserMapper {User selectById(Integer id);List<User> selectAll();
}

4.3 Mapper XML 文件 `UserMapper.xml`

<mapper namespace="com.example.mapper.UserMapper"><select id="selectById" resultType="User">SELECT * FROM user WHERE id = #{id}</select><select id="selectAll" resultType="User">SELECT * FROM user</select>
</mapper>

4.4 Service 類

@Service
public class UserService {@Autowiredprivate UserMapper userMapper;public User getUser(Integer id) {return userMapper.selectById(id);}public List<User> getAllUsers() {return userMapper.selectAll();}
}

4.5 Controller 類

@Controller
@RequestMapping("/user")
public class UserController {@Autowiredprivate UserService userService;@RequestMapping("/list")public String list(Model model) {List<User> users = userService.getAllUsers();model.addAttribute("users", users);return "userList"; // 對應 userList.jsp}
}

4.6 JSP 頁面（視圖層）`userList.jsp`

<%@ page contentType="text/html;charset=UTF-8" %>
<html>
<body>
<h2>User List</h2>
<table border="1"><tr><th>ID</th><th>Name</th><th>Age</th></tr><c:forEach var="u" items="${users}"><tr><td>${u.id}</td><td>${u.name}</td><td>${u.age}</td></tr></c:forEach>
</table>
</body>
</html>

💡 五、動態 SQL 示例（補充）

可以在 UserMapper.xml 中這樣寫：

<select id="searchUser" resultType="User">SELECT * FROM user<where><if test="name != null and name != ''">AND name LIKE CONCAT('%', #{name}, '%')</if><if test="age != null">AND age = #{age}</if></where>
</select>

調用時只傳入某些字段，MyBatis 會自動拼接對應 SQL 語句。

📌 六、總結

內容	說明
Spring MVC	控制器接收請求，返回視圖
MyBatis	封裝了 JDBC，實現 SQL 到 Java 映射
配置方式	XML 文件整合（`spring-mybatis.xml`、`mapper.xml`）
特點	靈活、輕量、適合手寫 SQL

在 SpringBoot 項目中的使用步驟

一、項目結構

1.1 引入依賴（Maven）

<dependency><groupId>org.mybatis.spring.boot</groupId><artifactId>mybatis-spring-boot-starter</artifactId><version>2.3.0</version>
</dependency>

1.2 配置 `application.yml`

spring:datasource:url: jdbc:mysql://localhost:3306/testdbusername: rootpassword: 123456driver-class-name: com.mysql.cj.jdbc.Drivermybatis:mapper-locations: classpath:mapper/*.xmltype-aliases-package: com.example.modelconfiguration:map-underscore-to-camel-case: true

2.3 編寫實體類

public class User {private Integer id;private String name;private Integer age;// getter/setter...
}

2.4 編寫 Mapper 接口

@Mapper
public interface UserMapper {User selectUserById(Integer id);List<User> selectAllUsers();
}

2.5 編寫 Mapper.xml（放在 `resources/mapper/UserMapper.xml`）

<mapper namespace="com.example.mapper.UserMapper"><select id="selectUserById" resultType="User">SELECT * FROM user WHERE id = #{id}</select><select id="selectAllUsers" resultType="User">SELECT * FROM user</select>
</mapper>

2.6 Service 和 Controller 層調用

@Service
public class UserService {@Autowiredprivate UserMapper userMapper;public User getUser(Integer id) {return userMapper.selectUserById(id);}
}

?? 2. 配置文件詳解（MyBatis 配置）

除了 application.yml 中配置項，MyBatis 也支持獨立 XML 配置（mybatis-config.xml），示例：

<configuration><settings><!-- 駝峰命名自動映射 --><setting name="mapUnderscoreToCamelCase" value="true"/></settings><typeAliases><package name="com.example.model"/></typeAliases><mappers><mapper resource="mapper/UserMapper.xml"/></mappers>
</configuration>

這些配置項在 Spring Boot 項目中一般都寫在 application.yml 里

🧱 3. 核心組件說明

組件	作用說明
SqlSession	MyBatis 的 SQL 會話對象，封裝了 JDBC 操作
Mapper 接口	定義與數據庫交互的方法
XML Mapper 文件	定義 SQL 語句，與接口方法一一對應
TypeHandler	類型處理器，用于 Java 類型與 JDBC 類型互相轉換
Executor	MyBatis 的 SQL 執行器，控制 SQL 執行流程
Configuration	全局配置對象，保存所有配置信息

🧠 4. 動態 SQL（重點）

動態 SQL 是 MyBatis 的亮點之一，常用標簽如下：

4.1 `<if>`

<if test="name != null">AND name = #{name}
</if>

4.2 `<where>`

自動拼接 WHERE，去掉多余 AND/OR：

<where><if test="name != null"> AND name = #{name} </if><if test="age != null"> AND age = #{age} </if>
</where>

4.3 `<set>`

用于動態生成 UPDATE SET，避免多余逗號：

<set><if test="name != null"> name = #{name}, </if><if test="age != null"> age = #{age} </if>
</set>

4.4 `<foreach>`

用于 IN 查詢等場景：

<foreach collection="idList" item="id" open="(" separator="," close=")">#{id}
</foreach>

4.5 `<choose>` `<when>` `<otherwise>`

<choose><when test="type == 'admin'"> AND role = 'ADMIN' </when><otherwise> AND role = 'GUEST' </otherwise>
</choose>

MyBatis 詳解及代碼示例

🏗? 1. 在 SpringMVC 項目中的使用步驟

🌱 一、技術棧說明

🧱 二、項目結構示意（SpringMVC 示例）

📦 三、核心配置文件

3.1 pom.xml（關鍵依賴）

3.2 db.properties

3.3 spring-mybatis.xml（Spring + MyBatis 整合配置）

3.4 web.xml 配置 Spring MVC 和核心監聽器

💻 四、代碼示例

4.1 實體類 User.java

4.2 Mapper 接口 UserMapper.java

4.3 Mapper XML 文件 UserMapper.xml