nablarch.fw.batch.ee.listener

Class NablarchListenerExecutor<T>

java.lang.Object

nablarch.fw.batch.ee.listener.NablarchListenerExecutor<T>

Type Parameters:

T - リスナークラス

public class NablarchListenerExecutor<T>
extends java.lang.Object

各レベルのリスナー実行クラスにて共通で必要となる処理をまとめたクラス。

本クラスの使用手順は以下の通り。

1. NablarchListenerExecutorのインスタンス変数をリスナー実行クラスに定義する
2. リスナー実行クラスの事前処理内でNablarchListenerExecutorのインスタンスを作成する
3. リスナー実行クラスで状況に応じてexecuteBefore(Runner)、executeAfter(Runner)、 executeOnError(Runner)を呼び出す

   なお、各メソッドの引数で渡すNablarchListenerExecutor.Runnerは、個別に実装クラスを作成し、 NablarchListenerExecutor.Runner.run(Object, NablarchListenerContext)にリスナーの事前処理等を記述する。

   例:

    
    executor.executeBefore(new Runner() {
        public void run(NablarchJobListener listener, NablarchListenerContext context) {
            listener.beforeJob(jobContext);
        }
    );
    }
    

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	NablarchListenerExecutor.Runner<L> リスナーを実行するランナー

Constructor Summary

Constructors

Constructor and Description
NablarchListenerExecutor(java.lang.String listenerListName, javax.batch.runtime.context.JobContext jobContext) コンストラクタ
NablarchListenerExecutor(java.lang.String listenerListName, javax.batch.runtime.context.JobContext jobContext, javax.batch.runtime.context.StepContext stepContext) コンストラクタ

Method Summary

Modifier and Type	Method and Description
void	executeAfter(NablarchListenerExecutor.Runner<T> runner) executeBefore(Runner)にて実行された(例外が発生したものを含む)リスナーの事後処理を、 executeBefore(Runner)で実行された順番とは逆順で実行する。 リスナーの事後処理の実行時に例外が発生した場合、ワーニングログを出力して後続のリスナーの事後処理を実行後、 発生した例外を呼び出し元に送出する。 複数の例外が発生した場合は、最初に発生した例外を呼び出し元に送出する。
void	executeBefore(NablarchListenerExecutor.Runner<T> runner) SystemRepositoryより実行対象となるリスナーのリストを取得し、リスナーの事前処理を順次実行する。
void	executeOnError(NablarchListenerExecutor.Runner<T> runner) executeBefore(Runner)にて実行された(例外が発生したものを含む)リスナーのエラー発生時処理を、 executeBefore(Runner)で実行された順番とは逆順で実行する。 リスナーのエラー発生時処理の実行時に例外が発生した場合、 ワーニングログを出力して後続のリスナーのエラー発生時処理を実行後、発生した例外を呼び出し元に送出する。 複数の例外が発生した場合は、最初に発生した例外を呼び出し元に送出する。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

NablarchListenerExecutor

public NablarchListenerExecutor(java.lang.String listenerListName,
                                javax.batch.runtime.context.JobContext jobContext)

コンストラクタ

Parameters:

listenerListName - SystemRepositoryに登録されているデフォルトのリスナーリスト名

jobContext - ジョブコンテキスト

NablarchListenerExecutor

public NablarchListenerExecutor(java.lang.String listenerListName,
                                javax.batch.runtime.context.JobContext jobContext,
                                javax.batch.runtime.context.StepContext stepContext)

コンストラクタ

Parameters:

listenerListName - SystemRepositoryに登録されているデフォルトのリスナーリスト名

jobContext - ジョブコンテキスト

stepContext - ステップコンテキスト

Method Detail

executeBefore

public final void executeBefore(NablarchListenerExecutor.Runner<T> runner)

SystemRepositoryより実行対象となるリスナーのリストを取得し、リスナーの事前処理を順次実行する。

Parameters:

runner - 事前処理を行うNablarchListenerExecutor.Runner

executeAfter

public final void executeAfter(NablarchListenerExecutor.Runner<T> runner)
                        throws java.lang.Exception

executeBefore(Runner)にて実行された(例外が発生したものを含む)リスナーの事後処理を、 executeBefore(Runner)で実行された順番とは逆順で実行する。

リスナーの事後処理の実行時に例外が発生した場合、ワーニングログを出力して後続のリスナーの事後処理を実行後、 発生した例外を呼び出し元に送出する。 複数の例外が発生した場合は、最初に発生した例外を呼び出し元に送出する。

Parameters:

runner - 事後処理を行うNablarchListenerExecutor.Runner

Throws:

java.lang.Exception - NablarchListenerExecutor.Runner.run(Object, NablarchListenerContext)実行時に最初に送出された例外

executeOnError

public final void executeOnError(NablarchListenerExecutor.Runner<T> runner)
                          throws java.lang.Exception

executeBefore(Runner)にて実行された(例外が発生したものを含む)リスナーのエラー発生時処理を、 executeBefore(Runner)で実行された順番とは逆順で実行する。

リスナーのエラー発生時処理の実行時に例外が発生した場合、 ワーニングログを出力して後続のリスナーのエラー発生時処理を実行後、発生した例外を呼び出し元に送出する。 複数の例外が発生した場合は、最初に発生した例外を呼び出し元に送出する。

Parameters:

runner - エラー発生時処理を行うNablarchListenerExecutor.Runner

Throws:

java.lang.Exception - NablarchListenerExecutor.Runner.run(Object, NablarchListenerContext)実行時に最初に送出された例外