nablarch.fw.messaging.action

Class MessagingAction

java.lang.Object

nablarch.core.db.support.DbAccessSupport

nablarch.fw.messaging.action.MessagingAction

All Implemented Interfaces:

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

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

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

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

Author:

Iwauo Tajima

Constructor Summary

Constructors

Constructor and Description
MessagingAction() MessagingActionオブジェクトを生成する。

Method Summary

Modifier and Type	Method and Description
protected nablarch.fw.messaging.ResponseMessage	onError(java.lang.Throwable e, RequestMessage request, ExecutionContext context) 業務トランザクションが異常終了した場合の処理を実行する。 本メソッドは、業務トランザクションがロールバックされると起動される。 任意のエラー応答電文(ResponseMessage)を返却したい場合は、本メソッドをオーバーライドすること。 デフォルト実装ではなにもしない。 注意: 以下のケースでは業務アクションへのディスパッチが行われる前にエラーが 発生するため、エラー応答電文の内容を制御することはできない。 フレームワーク制御ヘッダの形式不正 MOMミドルウェアのレイヤーで発生したエラー (JMSException等)
protected abstract nablarch.fw.messaging.ResponseMessage	onReceive(RequestMessage request, ExecutionContext context) 要求電文毎にフレームワークから起動され、要求電文の内容をもとに業務処理を実行する。

Methods inherited from class nablarch.core.db.support.DbAccessSupport

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

Constructor Detail

MessagingAction

@Published
public MessagingAction()

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

Method Detail

onReceive

@Published
protected abstract nablarch.fw.messaging.ResponseMessage onReceive(RequestMessage request,
                                                                              ExecutionContext context)

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

Parameters:

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

context - 実行コンテキスト

Returns:

応答電文オブジェクト

onError

@Published
protected nablarch.fw.messaging.ResponseMessage onError(java.lang.Throwable e,
                                                                   RequestMessage request,
                                                                   ExecutionContext context)

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

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

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

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

Parameters:

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

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

context - 実行コンテキスト

Returns:

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