2.2.7　アノテーションによるトランザクションブランチの作成（SQL-Participant限定）

(a)　ライブラリの組み込み

@PctoTransactionBranchアノテーションを使用するには、hmppcto-orchestratorライブラリをアプリケーションに組み込む必要があります。Gradleで組み込む記載例を次に示します。

dependencies {
    implementation 'jp.co.Hitachi.soft.hmppcto:hmppcto-orchestrator:<V.R.S>※'
}

注※

V.R.Sは使用するHMP-PCTOのバージョンに合わせて読み替えてください。

(b)　コーディング例

@PctoTransactionBranchアノテーションを使用するコーディング例を次に示します。@PctoTransactionBranchアノテーションを使用するメソッドのアクセス制御修飾子は、private以外にしてください。privateとした場合は、HMP-PCTOの機能は正しく動作しません。

@PctoTransactionBranch
public void service() {
    
    // 業務処理
    
}

(c)　エラーハンドリング

トランザクションではない呼び出し元で@PctoTransactionBranchアノテーションを指定したメソッドを呼び出した場合、メソッドの呼び出し元にTransactionBranchException例外が送出されます。

(a)　ライブラリの組み込み

先行プリペア機能を使用する場合に組み込むライブラリは、@PctoTransactionBranchアノテーションをメソッドに指定する際に使用するライブラリと同じです。ライブラリについては、「(a)　ライブラリの組み込み」を参照してください。

(b)　コーディング例

先行プリペア機能を使用する場合、@PctoTransactionBranchアノテーションのprePreparedOn属性にtrueを設定します。prePreparedOn属性の詳細については、「8.2.13　@PctoTransactionBranchアノテーション」を参照してください。

@PctoTransactionBranch(prePreparedOn = true)
public void service() {
    
    // 業務処理
    
}

(c)　エラーハンドリング

先行プリペア機能の使用によって、アプリケーションでエラーハンドリングが必要なエラーは発生しません。