feat: add upsert mode to update records

[nameless-mc]

Why

kintone API の 2025年1月12日のアップデートで、Update Records API に UPSERT mode
が追加されました。この機能により、指定されたレコードが存在する場合は更新、存在しない場合は新規作成を一度のAPI呼び出しで実行できるようになります。Java
Clientでもこの新機能をサポートする必要があります。

ref: https://cybozu.dev/ja/kintone/news/api-updates/2025-01/

What

REST APIとしてはUpdate Records APIのオプション（upsertパラメーター）として実装されていますが、リクエスト・レスポンスともにパラメーターが追加されているため、JavaクライアントとしてはupdateRecordsとは独立したインターフェースとして実装しました。これにより、既存のupdateRecordsメソッドへの破壊的変更を防止しています。

• UpsertRecordsRequest クラスを新規作成（upsert = true が常に設定される）
• UpsertRecordsResponseBody クラスを新規作成
• レコード操作のタイプを表す RecordOperationType enum を新規作成（UPDATE / INSERT）
• Upsert Records API のレスポンスを表す RecordUpsertResult クラスを新規作成（id、revision、operation を含む）
• KintoneApi.UPSERT_RECORDS を追加
• RecordClient.upsertRecords(long, List) メソッドを追加
• RecordClient.upsertRecords(UpsertRecordsRequest) メソッドを追加

How to test

Checklist

• Read CONTRIBUTING.md at the repository.
• Updated documentation if it is required.
• Added/updated tests if it is required. (or tested manually)

[Copilot]

Pull Request Overview

This PR adds support for the UPSERT mode feature introduced in the kintone API update (January 12, 2025) for the Update Records API. The UPSERT mode allows updating existing records or creating new ones in a single API call.

Key changes:

• Added upsert field to UpdateRecordsRequest for enabling UPSERT mode
• Introduced RecordOperationType enum (UPDATE/INSERT) and RecordUpdateResult class to handle operation type information
• Changed the return type of RecordClient.updateRecords() from List<RecordRevision> to List<RecordUpdateResult> (breaking change)

Reviewed Changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
UpdateRecordsRequest.java	Added optional upsert field to enable UPSERT mode
RecordOperationType.java	New enum defining UPDATE and INSERT operation types
RecordUpdateResult.java	New class containing record ID, revision, and operation type
UpdateRecordsResponseBody.java	Changed to use RecordUpdateResult instead of RecordRevision
RecordClient.java	Updated return type of updateRecords() method to use RecordUpdateResult
RecordClientTest.java	Updated test to verify the new RecordUpdateResult return type

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[chihiro-adachi]

upsertRecords(app, records)があってもよさそう

    public List<RecordUpdateResult> upsertRecords(long app, List<RecordForUpdate> records) {
        UpdateRecordsRequest req = new UpdateRecordsRequest();
        req.setApp(app);
        req.setUpsert(true);
        req.setRecords(records);
        return updateRecords(req).getRecords();
    }

[nameless-mc]

f2e22da で対応

[chihiro-adachi]

RecordRevisionにreturned by Update Records APIの記述が残ってそう
https://github.com/kintone/kintone-java-client/blob/master/src/main/java/com/kintone/client/model/record/RecordRevision.java#L6-L7

[nameless-mc]

b7a495f で対応