SAP BTP 学習日記 Day5 —— CAP Java Handler 入門：@Before・@After イベントでビジネスロジックを実装

# Java 21 インストール
sudo apt install -y openjdk-21-jdk

# Maven インストール
sudo apt install -y maven

# バージョン確認
java --version
mvn --version

mvn -B archetype:generate   -DarchetypeArtifactId=cds-services-archetype   -DarchetypeGroupId=com.sap.cds   -DarchetypeVersion=RELEASE   -DgroupId=com.example   -DartifactId=my-cap-java   -Dpackage=com.example.bookshop

my-cap-java/
├── db/                    ← CDS データモデル
├── srv/                   ← CDS サービス + Java Handler
│   └── src/main/java/
│       └── com/example/bookshop/
│           └── Application.java
├── pom.xml                ← Maven 設定
└── package.json

db/schema.cds + srv/cat-service.cds
        ↓  mvn compile
srv/src/gen/java/cds/gen/
    ├── catalogservice/
    │   ├── Books.java        ← getter/setter 付きデータクラス
    │   ├── Books_.java       ← メタ情報（CDS_NAME など）
    │   └── CatalogService_.java
    └── my/bookshop/
        └── Books.java

@Component
@ServiceName(CatalogService_.CDS_NAME)
public class CatalogServiceHandler implements EventHandler {

    // ① Before：登録前のバリデーション
    @Before(event = CqnService.EVENT_CREATE, entity = Books_.CDS_NAME)
    public void beforeCreateBooks(List<Books> books) {
        for (Books book : books) {
            if (book.getStock() != null && book.getStock() < 0) {
                throw new IllegalArgumentException(
                    "在庫数は0以上でなければなりません。"
                );
            }
            if (book.getPrice() != null && book.getPrice().signum() <= 0) {
                throw new IllegalArgumentException(
                    "価格は0より大きくなければなりません。"
                );
            }
        }
    }

    // ② After：登録後のログ出力
    @After(event = CqnService.EVENT_CREATE, entity = Books_.CDS_NAME)
    public void afterCreateBooks(List<Books> books) {
        for (Books book : books) {
            System.out.println(
                "✅ 新しい本が登録されました: [ID=" + book.getId() +
                ", タイトル=" + book.getTitle() +
                ", 在庫=" + book.getStock() + "]"
            );
        }
    }

    // ③ After READ：在庫切れ警告
    @After(event = CqnService.EVENT_READ, entity = Books_.CDS_NAME)
    public void afterReadBooks(List<Books> books) {
        for (Books book : books) {
            if (book.getStock() != null && book.getStock() == 0) {
                System.out.println(
                    "⚠️ 在庫切れ: [ID=" + book.getId() +
                    ", タイトル=" + book.getTitle() + "]"
                );
            }
        }
    }
}

POST http://localhost:8080/odata/v4/CatalogService/Books
{
  "ID": 2,
  "title": "Invalid Book",
  "stock": -1,
  "price": 4800.00
}

→ {"error":{"code":"500","message":"在庫数は0以上でなければなりません。"}}

リクエスト受信
    ↓
@Before  ← バリデーション・データ加工
    ↓
@On      ← DB操作（省略時は CAP が自動処理）
    ↓
@After   ← ログ・通知・後処理
    ↓
レスポンス返却