nablarch.fw.messaging.action

クラス MessagingAction

java.lang.Object

nablarch.core.db.support.DbAccessSupport

nablarch.fw.messaging.action.MessagingAction

すべての実装されたインタフェース:

Handler<RequestMessage,ResponseMessage>, nablarch.fw.TransactionEventCallback<RequestMessage>

直系の既知のサブクラス:

MessagingAction

public abstract class MessagingAction
extends DbAccessSupport
implements Handler<RequestMessage,ResponseMessage>, nablarch.fw.TransactionEventCallback<RequestMessage>

被仕向同期応答処理を行う業務処理で使用するテンプレートクラス。

業務アクションハンドラは、本クラスを継承し、本クラスに定義されたテンプレートメソッドを必要に応じて実装する。

作成者:

Iwauo Tajima

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
MessagingAction() MessagingActionオブジェクトを生成する。

メソッドのサマリー

修飾子とタイプ	メソッドと説明
protected ResponseMessage	onError(Throwable e, RequestMessage request, ExecutionContext context) 業務トランザクションが異常終了した場合の処理を実行する。
protected abstract ResponseMessage	onReceive(RequestMessage request, ExecutionContext context) 要求電文毎にフレームワークから起動され、要求電文の内容をもとに業務処理を実行する。

クラスから継承されたメソッド nablarch.core.db.support.DbAccessSupport

countByParameterizedSql, countByStatementSql, getParameterizedSqlStatement, getParameterizedSqlStatement, getSqlCStatement, getSqlPStatement, search

インタフェースから継承されたメソッド nablarch.fw.Handler

handle

コンストラクタの詳細

MessagingAction

@Published
public MessagingAction()

MessagingActionオブジェクトを生成する。

メソッドの詳細

onReceive

@Published
protected abstract ResponseMessage onReceive(RequestMessage request,
                                                        ExecutionContext context)

要求電文毎にフレームワークから起動され、要求電文の内容をもとに業務処理を実行する。

パラメータ:

request - 要求電文オブジェクト

context - 実行コンテキスト

戻り値:

応答電文オブジェクト

onError

@Published
protected ResponseMessage onError(Throwable e,
                                             RequestMessage request,
                                             ExecutionContext context)

業務トランザクションが異常終了した場合の処理を実行する。

本メソッドは、業務トランザクションがロールバックされると起動される。 任意のエラー応答電文(ResponseMessage)を返却したい場合は、本メソッドをオーバーライドすること。 デフォルト実装ではなにもしない。

注意: 以下のケースでは業務アクションへのディスパッチが行われる前にエラーが 発生するため、エラー応答電文の内容を制御することはできない。

• フレームワーク制御ヘッダの形式不正
• MOMミドルウェアのレイヤーで発生したエラー (JMSException等)

パラメータ:

e - 発生したエラーオブジェクト

request - 要求電文オブジェクト

context - 実行コンテキスト

戻り値:

エラー応答用電文。nullを返した場合はフレームワークが編集した電文が送信される。