nablarch.fw.messaging.action

Class MessagingAction

java.lang.Object

nablarch.core.db.support.DbAccessSupport

nablarch.fw.messaging.action.MessagingAction

All Implemented Interfaces:

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

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

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

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

Author:

Iwauo Tajima

Constructor Summary

Constructors

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

Method Summary

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

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

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

Methods inherited from interface nablarch.fw.Handler

handle

Constructor Detail

MessagingAction

@Published
public MessagingAction()

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

Method Detail

onReceive

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

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

Parameters:

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

context - 実行コンテキスト

Returns:

応答電文オブジェクト

onError

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

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

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

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

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

Parameters:

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

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

context - 実行コンテキスト

Returns:

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