Day 24 JPA 交易管理

2024 iThome 鐵人賽

DAY 24

Modern Web

Spring Boot API 開發：從 0 到 1系列第 24 篇

16th鐵人賽

cashwugeek

2024-09-24 08:35:20

325 瀏覽

分享至

在開發企業級應用程式時，交易管理是一個至關重要的概念

交易是一系列操作的集合，這些操作要麼全部成功執行，要麼全部不執行

這種特性保證了資料的一致性和完整性，尤其是在處理複雜的業務邏輯或多個相關操作時

今天，我們將探討如何在 Spring Data JPA 中實現交易管理

資料庫的交易管理

什麼是交易管理？

交易管理（Transaction Management）是一種確保多個資料庫操作要麼全部成功，要麼全部不執行的機制

ACID

交易的基本特性通常被稱為 ACID

原子性（Atomicity）：交易中的所有操作要麼全部完成，要麼全部不完成
一致性（Consistency）：交易必須使資料庫從一個一致性狀態轉換到另一個一致性狀態
隔離性（Isolation）：併發執行的交易之間不會互相影響
持久性（Durability）：一旦交易提交 (commit)，其結果就會被永久保存

JPA 的 @Transactional 實作

在 Spring 框架中，交易管理變得相當簡單。Spring 提供了聲明式交易管理，我們只需要通過註解或 XML 配置就可以輕鬆實現交易控制

在使用 Spring Data JPA 時，我們可以使用 @Transactional 註解來實現交易管理

這個註解 @Transactional 可以應用在方法或類別上，來定義該方法或該類別中的所有公開方法都應該在一個交易中執行

@Transactional 註解支持多種屬性來細粒度控制交易行為

propagation：定義交易的傳播行為
isolation：定義交易的隔離級別
timeout：定義交易的超時時間
readOnly：指定交易是否為只讀
rollbackFor：指定哪些異常會導致交易回滾

使用 @Transactional 註解時，Spring 會自動處理交易的開始、提交或回滾

如果方法正常結束，交易會被提交；如果拋出異常，交易則會被回滾

文章範例中不會特別說明這幾個屬性，有興趣的讀者可以參考官方文件

新增 TodoService

讓我們來新增一個 TodoService 來加入交易管理

@Service
public class TodoService {

    private final TodoRepository todoRepository;
    
    public TodoService(TodoRepository todoRepository) {
        this.todoRepository = todoRepository;
    }

    @Transactional
    public Todo save(Todo todo) {
        
        // 保存 Todo
        Todo savedTodo = todoRepository.save(todo);
        
        // 假設我們需要進行一些額外的操作
        // 如果這裡拋出異常，整個交易會回滾
        performAdditionalOperations(savedTodo);
        
        return savedTodo;
    }

    @Transactional(readOnly = true)
    public List<Todo> findAll() {
        return todoRepository.findAll();
    }

    private void performAdditionalOperations(Todo todo) {
        // 模擬一些可能會拋出異常的操作
        if (todo.getTitle().length() > 20) {
            throw new RuntimeException("Todo title is too long from TodoService");
        }
    }
}

這裡要先注意的是，@Transactional 應該要匯入 springframework 套件下的，而不是 Jakarta 套件下的

在這個例子中，我們對 save 方法使用了 @Transactional 註解，這意味著方法中的所有資料庫操作都會在同一個交易中執行

如果方法執行過程中拋出任何未捕捉的例外，交易會自動回滾，確保資料的一致性

我們還在 findAll 方法上使用了 @Transactional(readOnly = true)，這表明該方法只進行讀取操作，不會修改資料，這可以幫助資料庫最佳化查詢效能

修改 Controller

修改 TodoController 來使用 TodoService

@RestController
@RequestMapping("/api/todos")
public class TodoController {

    // 為了方便，在這裡只展示了所增加的相關程式碼

    private final TodoService todoService;

    public TodoController(TodoService todoService) {
        this.todoService = todoService;
    }

    @PostMapping
    public ResponseEntity<MyApiResponse<Todo>> createTodo(@RequestBody Todo todo) {

        Todo savedTodo = todoService.save(todo);
        return ResponseEntity.ok(new MyApiResponse<>(true, savedTodo, null));
    }

    @GetMapping
    public ResponseEntity<MyApiResponse<List<Todo>>> getAllTodos() {

        List<Todo> todos = todoService.findAll();
        return ResponseEntity.ok(new MyApiResponse<>(true, todos, null));
    }
}

測試

新增一個 title 長度大於 20 的資料

### 創建一個新的 Todo
POST http://localhost:8080/api/todos
Content-Type: application/json

{
  "title": "學習 Spring Boot 學習 Spring Boot",
  "completed": false
}

可以看到錯誤是從 TodoService 裡面丟出來的