一個實際的例子學習 SAP BTP Java 應用的 @Before 註解使用方式

注销發表於2022-03-12
Java

我們可以使用了 On 註釋，它替換了 CAP Java 執行時提供的事件的預設處理，以此來註冊自定義事件處理程式，從而處理實體的 READ 或 CREATE 事件。

如果想增加預設處理，我們將使用 @Before 和 @After 註釋。 使用 @Before 註釋註冊的事件處理程式旨在執行輸入實體資料的驗證。 這使得在建立訂單之前驗證特定書籍的可用庫存成為可能。 相比之下，使用 @After 註釋註冊的事件處理程式可以對返回的實體進行後處理。 這對於在從資料庫中讀取訂單或其專案後計算總和淨金額元素很有用。

假設我們開發了一套圖書管理系統，其中圖書模型定義如下：

entity Products : cuid, managed {
        title    : localized String(111);
        descr    : localized String(1111);
        stock    : Integer;
        price    : Decimal(9,2);
        currency : Currency;
        category : Association to Categories;
    }

每本書有一個 stock 欄位維護庫存。

另一個專案 bookstore，設計了 orders 和 orderItems 行專案模型：

我們期望下單時，對應圖書的 stock 欄位會被 OrderItems 裡的 amount 欄位扣減。

新建一個 handlers 資料夾，裡面放置一個檔案 OrdersService.java：

package com.sap.cap.bookstore.handlers;

import com.sap.cds.services.handler.EventHandler;
import com.sap.cds.services.handler.annotations.ServiceName;

import org.springframework.stereotype.Component;

@Component
@ServiceName("OrdersService")
public class OrdersService implements EventHandler {

}

首先根據 orderItem 裡包含的 book ID，從資料庫裡讀取對應的圖書模型，獲取其庫存，同訂單行專案的 quantity 欄位比較，如果購買的數量小於庫存，說明能夠下單。

建立一個新的 Configuration：

選擇 bookstore：

點選 Run module：

建立一個新的訂單，guid 和 currency 都選擇的硬編碼：

curl -X POST http://localhost:8080/odata/v... \
-H "Content-Type: application/json" \
-d '{"ID": "50425a69-48b9-45f1-b6d2-687d55355e03", "currency_code": "USD"}'

建立一個新的 order item，買了兩本書：amount = 2

curl -X POST http://localhost:8080/odata/v... \
-H "Content-Type: application/json" \
-d '{"parent_ID": "50425a69-48b9-45f1-b6d2-687d55355e03", "book_ID": "abed2f7a-c50e-4bc5-89fd-9a00a54b4b16", "amount": 2}'

4b16 結尾的 entity 對應的 book：

初始庫存為 12：

實際庫存為 10：

使用如下命令可以使資料庫回到初始狀態：

cds deploy --to sqlite

方法 calculateNetAmount 是使用 @After 註釋註冊的。 這意味著在從資料庫中讀取 OrderItems 實體之後呼叫該方法。 註釋還指定，每當讀取或建立實體 OrderItems 時都應呼叫該方法。

相關文章