在 MyBatis 以及 MyBatis - Plus 的開發過程中，注解的使用是提升開發效率和實現特定功能的關鍵。今天我們就來聊聊 @Options 注解，以及在 MyBatis - Plus 中它的使用場景和替代方案。

一、MyBatis 中的 @Options 注解

在 MyBatis 框架中，@Options 注解是一個非常實用的注解，它主要用于配置 mapper 接口方法的一些執行選項，像緩存、結果集處理、主鍵生成等方面都能用到它。

1. 新增數據時獲取自增主鍵

在實際開發中，當我們向數據庫中插入一條新數據時，常常需要立即獲取這條數據的自增主鍵，以便進行后續的關聯操作。在 MyBatis 中，借助 @Options 注解就能輕松實現這一功能。

例如，有一個用戶表 user，其 id 是自增主鍵，對應的實體類 User 和 mapper 接口 UserMapper 如下：

// User實體類public class User {private Long id; // 自增主鍵private String username;private String email;// 省略getter和setter方法}// UserMapper接口public interface UserMapper {/*** 新增用戶并獲取自增主鍵*/@Insert("INSERT INTO user(username, email) VALUES(#{username}, #{email})")@Options(useGeneratedKeys = true, keyProperty = "id", keyColumn = "id")void insertUser(User user);}

在業務層調用時，插入數據后可以直接通過 user.getId () 獲取自增的主鍵：

@Servicepublic class UserService {@Autowiredprivate UserMapper userMapper;public Long addUser(User user) {userMapper.insertUser(user);return user.getId(); // 插入后直接獲取自增主鍵}}

這里，@Options 注解的 useGeneratedKeys 屬性設置為 true，表示開啟自動生成主鍵功能；keyProperty 屬性指定了主鍵值要注入到 User 對象的 id 屬性中；keyColumn 屬性則指定了數據庫表中的主鍵列名，當與實體類的屬性名一致時可以省略。通過這樣的配置，避免了插入數據后再查詢一次主鍵的額外操作，大大提升了性能。

2. 高頻查詢配置緩存

對于一些高頻訪問但不常變更的數據，比如網站首頁的熱門商品列表，我們可以通過 @Options 注解配置 MyBatis 二級緩存，從而減少數據庫的訪問壓力。

// Product實體類（需要實現Serializable接口，因為緩存要求序列化）public class Product implements Serializable {private Long id;private String name;private BigDecimal price;// 省略getter和setter方法}// ProductMapper接口public interface ProductMapper {/*** 查詢熱門商品列表，啟用緩存*/@Select("SELECT id, name, price FROM product WHERE is_hot = 1 ORDER BY sort DESC LIMIT 10")@Options(useCache = true, flushCache = Options.FlushCachePolicy.FALSE, timeout = 5000)List<Product> getHotProducts();/*** 更新商品信息后刷新緩存，避免緩存臟數據*/@Update("UPDATE product SET name = #{name}, price = #{price} WHERE id = #{id}")@Options(flushCache = Options.FlushCachePolicy.TRUE)void updateProduct(Product product);}

在上面的代碼中，getHotProducts 方法通過 @Options 注解配置了 useCache = true，啟用了二級緩存，這樣后續的請求就可以直接從緩存中獲取數據，而不用每次都訪問數據庫。同時，設置 flushCache = Options.FlushCachePolicy.FALSE，表示查詢后不刷新緩存。而 updateProduct 方法設置 flushCache = Options.FlushCachePolicy.TRUE，意味著更新操作后會刷新緩存，避免了緩存中出現臟數據。

3. 大數據量查詢優化

當處理大數據量查詢，比如導出訂單報表時，一次性加載過多數據可能會導致內存溢出。這時，我們可以使用 @Options 注解的 fetchSize 屬性來控制 JDBC 每次從數據庫讀取的行數，進行分批讀取，降低內存占用。

// OrderMapper接口public interface OrderMapper {/*** 批量查詢訂單，用于報表導出*/@Select("SELECT id, order_no, amount, create_time FROM `order` WHERE create_time BETWEEN #{startTime} AND #{endTime}")@Options(fetchSize = 1000, resultSetType = ResultSetType.FORWARD_ONLY)List<Order> queryOrdersByTimeRange(@Param("startTime") LocalDateTime startTime, @Param("endTime") LocalDateTime endTime);}

這里，fetchSize = 1000 表示每次從數據庫讀取 1000 行數據，resultSetType = ResultSetType.FORWARD_ONLY 設置結果集為只向前滾動，配合 fetchSize 可以達到分批讀取數據的效果，有效優化了大數據量查詢時的內存占用。

二、MyBatis - Plus 中的情況

MyBatis - Plus 是在 MyBatis 基礎上的增強工具，它對很多常見功能進行了更簡潔的封裝，在很多場景下不需要顯式使用 @Options 注解。

1. 主鍵生成

MyBatis - Plus 提供了 @TableId 注解專門用于主鍵配置，支持多種主鍵策略，完全可以替代 @Options 注解在主鍵生成方面的功能。

例如，對于自增主鍵，我們可以這樣配置：

// 實體類public class User {// 配置主鍵自增，等價于MyBatis中@Options(useGeneratedKeys = true, keyProperty = "id")@TableId(type = IdType.AUTO)private Long id;private String username;// 省略其他字段和getter、setter方法}// Mapper接口（直接繼承BaseMapper，無需編寫SQL語句）public interface UserMapper extends BaseMapper<User> {// 插入后可以直接通過user.getId()獲取自增主鍵}// 調用方式User user = new User();user.setUsername("testUser");userMapper.insert(user);Long id = user.getId(); // 直接獲取自增主鍵

MyBatis - Plus 的 IdType.AUTO 會自動處理插入后返回主鍵的邏輯，非常方便。而且，它還支持其他主鍵策略，如 UUID、雪花算法等，當使用這些策略時，甚至不需要數據庫設置自增，更加靈活。

2. 緩存控制

MyBatis - Plus 并沒有改變 MyBatis 的緩存機制，所以如果我們使用 MyBatis 原生的二級緩存，@Options 注解仍然有效。不過，MyBatis - Plus 推薦使用 @CacheNamespace 注解在 Mapper 接口上統一配置緩存，這種方式比在每個方法上分散使用 @Options 注解更簡潔。

// 使用@CacheNamespace統一配置緩存（推薦）@CacheNamespace(implementation = MybatisRedisCache.class, eviction = LruCache.class, flushInterval = 60000)public interface ProductMapper extends BaseMapper<Product> {// 所有方法默認使用緩存，無需在每個方法上添加@Options注解}// 個別方法需要特殊配置時，仍可以使用@Options注解覆蓋默認配置@Select("SELECT * FROM product WHERE id = #{id}")@Options(useCache = false) // 該方法不使用緩存Product getProductById(Long id);

3. 其他參數配置

對于 fetchSize、timeout 等參數，MyBatis - Plus 沒有進行額外的封裝，所以在需要這些配置時，仍然需要使用 @Options 注解。

public interface OrderMapper extends BaseMapper<Order> {// 自定義批量查詢SQL，設置fetchSize和timeout優化性能@Select("SELECT * FROM `order` WHERE status = #{status}")@Options(fetchSize = 1000, timeout = 10000)List<Order> selectByStatus(@Param("status") Integer status);}

三、總結

@Options 注解在 MyBatis 中有著重要的作用，能幫助我們實現主鍵獲取、緩存控制、大數據量查詢優化等功能。而在 MyBatis - Plus 中，由于其對常見功能進行了封裝，在主鍵生成方面，我們可以使用 @TableId 注解替代 @Options；在緩存控制方面，推薦使用 @CacheNamespace 注解進行統一配置；但對于 fetchSize、timeout 等參數，仍然需要使用 @Options 注解來配置。

了解這些知識點，能讓我們在使用 MyBatis 和 MyBatis - Plus 進行開發時，更加靈活地處理各種業務場景，提高開發效率和系統性能。