1. 使用 JUnit 進行單元測試

JUnit 是 Java 中非常流行的單元測試框架，MyBatis 與 JUnit 可以很好地結合，來測試持久層代碼的正確性。

1.1 添加 JUnit 依賴

在使用 JUnit 之前，需要在 pom.xml 中引入 JUnit 依賴。

<dependency><groupId>junit</groupId><artifactId>junit</artifactId><version>4.13.2</version><scope>test</scope>
</dependency>

1.2 單元測試基本結構

假設我們要測試 UserMapper 中的 getUserById 方法，測試代碼如下：

import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
import org.junit.Assert;
import org.junit.Before;
import org.junit.Test;import java.io.InputStream;public class UserMapperTest {private SqlSessionFactory sqlSessionFactory;// 在測試開始前初始化 SqlSessionFactory@Beforepublic void setup() throws Exception {String resource = "mybatis-config.xml";InputStream inputStream = Resources.getResourceAsStream(resource);sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);}// 測試獲取用戶的方法@Testpublic void testGetUserById() {try (SqlSession session = sqlSessionFactory.openSession()) {UserMapper mapper = session.getMapper(UserMapper.class);User user = mapper.getUserById(1);// 斷言用戶不為空Assert.assertNotNull("用戶不存在", user);// 斷言用戶名是否正確Assert.assertEquals("用戶名不匹配", "Alice", user.getName());}}
}

1.3 運行測試

• 每個 @Test 注解的方法代表一個測試用例。
• 使用 @Before 注解的方法會在每個測試方法執(zhí)行前運行，常用于初始化。
• 使用 Assert 方法來驗證測試結果，例如 Assert.assertNotNull() 檢查對象是否為空，Assert.assertEquals() 檢查預期結果是否與實際結果一致。

通過運行 JUnit 測試，你可以快速驗證 MyBatis Mapper 的 SQL 執(zhí)行是否正確。

---

2. 使用 JUL（Java Util Logging）日志系統(tǒng)

Java Util Logging (JUL) 是 Java 內(nèi)置的日志系統(tǒng)。MyBatis 默認使用 JUL 作為日志輸出工具，你可以通過配置來控制日志輸出級別與格式。

2.1 配置 MyBatis 日志級別

MyBatis 可以輸出執(zhí)行的 SQL 語句、參數(shù)及結果等信息。首先，你需要在 mybatis-config.xml 中配置日志級別。

<configuration><settings><!-- 開啟日志輸出 --><setting name="logImpl" value="JUL"/></settings>
</configuration>

• logImpl 屬性指定日志實現(xiàn)，這里設置為 JUL，表示使用 Java 自帶的日志系統(tǒng)。

2.2 配置日志屬性文件

在項目的 resources 目錄下創(chuàng)建 logging.properties 文件，配置日志輸出格式和級別。

logging.properties 示例：

handlers= java.util.logging.ConsoleHandler# 設置根日志級別
.level= INFO# 控制臺日志級別和格式
java.util.logging.ConsoleHandler.level = INFO
java.util.logging.ConsoleHandler.formatter = java.util.logging.SimpleFormatter# MyBatis 日志級別
org.apache.ibatis.level = FINE

• .level：設置根日志的默認級別，這里設為 INFO，表示輸出普通信息及更高級別的日志。
• org.apache.ibatis.level：將 MyBatis 的日志級別設置為 FINE，輸出更詳細的 SQL 日志。

2.3 常見日志級別

• SEVERE：嚴重錯誤，可能導致程序崩潰的錯誤。
• WARNING：警告信息，潛在問題。
• INFO：普通信息，程序正常運行的相關消息。
• CONFIG：配置信息，程序初始化時的信息。
• FINE、FINER、FINEST：調(diào)試信息，顯示程序細節(jié)，日志級別遞增。

2.4 運行時日志輸出

通過上面的配置，當你運行 MyBatis 程序時，日志會輸出到控制臺，并顯示執(zhí)行的 SQL 語句以及執(zhí)行時間等。

示例日志輸出：

INFO: PooledDataSource forcefully closed/removed all connections.
FINE: ==>  Preparing: SELECT * FROM users WHERE id = ? 
FINE: ==> Parameters: 1(Integer)
FINE: <==      Total: 1

日志中會顯示 SQL 語句的準備狀態(tài)、綁定的參數(shù)以及查詢返回的記錄數(shù)。

3. 使用 Properties 配置文件

Properties 文件是 Java 項目中常用的配置文件格式，用于配置一些可調(diào)整的參數(shù)，如數(shù)據(jù)庫連接信息、日志級別等。在 MyBatis 中，properties 文件也可以用于配置日志系統(tǒng)。

3.1 配置文件示例

創(chuàng)建一個名為 application.properties 的文件，內(nèi)容如下：

# 數(shù)據(jù)庫配置
db.url=jdbc:mysql://localhost:3306/mydb
db.username=root
db.password=123456# 日志配置
log.level=INFO

然后在 Java 代碼中加載這個配置文件：

import java.io.InputStream;
import java.util.Properties;public class ConfigLoader {public static Properties loadProperties(String fileName) {Properties properties = new Properties();try (InputStream input = ConfigLoader.class.getClassLoader().getResourceAsStream(fileName)) {properties.load(input);} catch (Exception e) {e.printStackTrace();}return properties;}
}

通過 loadProperties 方法可以將配置文件加載到內(nèi)存中，在程序中使用時可以動態(tài)獲取這些配置。

---

4. 編寫日志配置文件

為了使用 Java 內(nèi)置的日志系統(tǒng) JUL，你可以編寫一個 logging.properties 文件，配置日志的輸出格式、級別、輸出位置等。這個配置文件通常放在 resources 目錄下。

4.1 logging.properties 文件內(nèi)容示例：

# 使用 ConsoleHandler 輸出日志到控制臺
handlers = java.util.logging.ConsoleHandler# 全局日志級別
.level = INFO# 控制臺日志處理器的級別和格式
java.util.logging.ConsoleHandler.level = INFO
java.util.logging.ConsoleHandler.formatter = java.util.logging.SimpleFormatter# MyBatis 日志配置
org.apache.ibatis.level = FINE

• handlers：定義日志輸出的處理器，這里我們使用 ConsoleHandler 將日志輸出到控制臺。
• .level：定義默認的日志級別，INFO 表示輸出一般信息。
• org.apache.ibatis.level：為 MyBatis 特定包設置日志級別為 FINE，顯示更詳細的 SQL 執(zhí)行信息。

4.2 使用 logging.properties

在應用啟動時，你需要將 logging.properties 文件加載到日志系統(tǒng)中?？梢酝ㄟ^以下方式加載：

import java.util.logging.LogManager;public class LogConfig {static {try {LogManager.getLogManager().readConfiguration(LogConfig.class.getClassLoader().getResourceAsStream("logging.properties"));} catch (Exception e) {e.printStackTrace();}}
}

將此類放置在應用啟動類中，它會自動讀取日志配置文件。

---

5. 使用 Lombok 快速開啟日志

Lombok 提供了一些注解來自動生成日志記錄器，從而簡化日志功能的使用。在 MyBatis 項目中，可以使用 Lombok 提供的注解快速開啟日志記錄。

5.1 添加 Lombok 依賴

在 pom.xml 文件中添加 Lombok 依賴：

<dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId><version>1.18.24</version><scope>provided</scope>
</dependency>

5.2 使用 Lombok 的日志注解

Lombok 提供了多種日志注解，常用的有：

• @Slf4j: 使用 SLF4J 日志框架
• @Log: 使用 JUL 日志框架
• @Log4j: 使用 Log4j 日志框架

在這里，我們使用 @Log 注解來使用 Java 自帶的 JUL 日志系統(tǒng)：

import lombok.extern.java.Log;@Log
public class MyService {public void performAction() {log.info("Performing some action...");}
}

• @Log 自動生成了一個 log 對象，你可以直接使用 log.info()、log.warning() 等方法記錄日志。
• 這樣做的好處是，不需要手動創(chuàng)建日志記錄器對象，Lombok 會自動幫你生成。

---

6. MyBatis 日志系統(tǒng)

MyBatis 提供了內(nèi)置的日志系統(tǒng)，可以輸出 SQL 語句的執(zhí)行情況、參數(shù)綁定、返回結果等信息。MyBatis 支持多種日志框架，如 JUL、Log4j、SLF4J 等。你可以根據(jù)項目需要選擇合適的日志框架。

6.1 配置 MyBatis 日志系統(tǒng)

MyBatis 默認支持多種日志實現(xiàn)方式，你可以通過 mybatis-config.xml 文件指定使用哪種日志系統(tǒng)。

<configuration><settings><!-- 配置 MyBatis 使用 JUL 作為日志框架 --><setting name="logImpl" value="JUL"/></settings>
</configuration>

6.2 查看 SQL 日志

在啟用了 MyBatis 日志系統(tǒng)后，每當執(zhí)行 SQL 語句時，控制臺上會輸出相關的日志信息。示例日志輸出如下：

FINE: ==>  Preparing: SELECT * FROM users WHERE id = ? 
FINE: ==> Parameters: 1(Integer)
FINE: <==      Total: 1

• Preparing：顯示即將執(zhí)行的 SQL 語句。
• Parameters：顯示 SQL 語句的參數(shù)綁定信息。
• Total：顯示查詢返回的結果數(shù)。

6.3 使用 Log4j 或 SLF4J 作為日志系統(tǒng)

MyBatis 也支持其他日志系統(tǒng)，比如 Log4j 或 SLF4J。如果你想使用 Log4j，首先需要添加依賴：

<dependency><groupId>log4j</groupId><artifactId>log4j</artifactId><version>1.2.17</version>
</dependency>

然后修改 mybatis-config.xml 配置文件，設置 logImpl 為 LOG4J：

<configuration><settings><!-- 使用 Log4j 作為日志系統(tǒng) --><setting name="logImpl" value="LOG4J"/></settings>
</configuration>

---

總結

• JUnit 單元測試：通過 JUnit 進行單元測試可以確保 MyBatis 的持久層代碼正常工作，@Before 和 @Test 是最常用的注解，Assert 方法用于驗證測試結果。
• JUL 日志系統(tǒng)：MyBatis 支持 Java 自帶的日志系統(tǒng) (JUL)，你可以通過 logging.properties 文件配置日志的級別、格式和輸出位置。
• Properties 文件：可以通過 application.properties 文件配置數(shù)據(jù)庫連接信息和日志級別，并通過 Java 代碼加載這些配置。
• 日志配置文件：logging.properties 文件用于配置 JUL 日志系統(tǒng)，可以控制日志的輸出級別、格式等。
• Lombok 日志注解：使用 Lombok 的 @Log、@Slf4j 等注解可以快速開啟日志功能，簡化日志代碼的書寫。
• MyBatis 日志系統(tǒng)：MyBatis 支持多種日志框架，通過 mybatis-config.xml 可以指定日志實現(xiàn)，MyBatis 的日志系統(tǒng)會輸出 SQL 的執(zhí)行情況，方便調(diào)試。