nablarch.fw.handler

クラス BasicDuplicateProcessChecker

java.lang.Object

nablarch.fw.handler.BasicDuplicateProcessChecker

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

Initializable, DuplicateProcessChecker

public class BasicDuplicateProcessChecker
extends java.lang.Object
implements DuplicateProcessChecker, Initializable

データベースのテーブルを用いてプロセスの多重起動防止を行うDuplicateProcessCheckerの実装クラス。

２重起動チェックは、データベースのテーブルを用いて行う。 データベースのテーブルには、予めプロセスを識別するための値を設定しておく必要がある。 プロセスを識別する値が設定さていない場合は、２重起動チェックが正しく行えないが、 ２重起動の可能性もあるため２重起動であることを示す例外を送出する。

２重起動チェック用テーブルレイアウト例を以下に示す。

 ----------------------------------   ------------------------------------------------------
 カラム名                             説明
 ----------------------------------   ------------------------------------------------------
 プロセス識別子                       プロセスを一意に識別するための値を格納する。

                                      例えばジョブIDなど

 プロセスアクティブフラグ             プロセスの現在の状態を格納する。

                                      * 0:非アクティブ(実行されていない状態)
                                      * 1:アクティブ(実行されている状態)
 ----------------------------------   ------------------------------------------------------
 

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

コンストラクタ

コンストラクタと説明
BasicDuplicateProcessChecker()

メソッドのサマリー

修飾子とタイプ	メソッドと説明
void	checkAndActive(java.lang.String processIdentifier) プロセスの2重起動チェックとアクティブ化を行う。
void	inactive(java.lang.String processIdentifier) プロセスの非アクティブ化を行う。
void	initialize() ２重起動チェック用のSQL文を構築する。
void	setDbTransactionManager(SimpleDbTransactionManager dbTransactionManager) データベーストランザクションマネージャを設定する。
void	setPermitProcessIdentifier(java.lang.String[] permitProcessIdentifier) ２重起動を許可するプロセスの識別子リストを設定する。
void	setProcessActiveFlgColumnName(java.lang.String processActiveFlgColumnName) プロセスが起動中であることを示すフラグが格納されるカラムの物理名を設定する。
void	setProcessIdentifierColumnName(java.lang.String processIdentifierColumnName) プロセスを特定するための識別子が格納されるカラムの物理名を設定する。
void	setTableName(java.lang.String tableName) テーブル名を設定する。

クラスから継承されたメソッド java.lang.Object

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

コンストラクタの詳細

BasicDuplicateProcessChecker

public BasicDuplicateProcessChecker()

メソッドの詳細

initialize

public void initialize()

２重起動チェック用のSQL文を構築する。

定義:

initialize インタフェース内 Initializable

setDbTransactionManager

public void setDbTransactionManager(SimpleDbTransactionManager dbTransactionManager)

データベーストランザクションマネージャを設定する。

パラメータ:

dbTransactionManager - データベーストランザクションマネージャ

setTableName

public void setTableName(java.lang.String tableName)

テーブル名を設定する。

パラメータ:

tableName - テーブル名

setProcessIdentifierColumnName

public void setProcessIdentifierColumnName(java.lang.String processIdentifierColumnName)

プロセスを特定するための識別子が格納されるカラムの物理名を設定する。

パラメータ:

processIdentifierColumnName - プロセスを識別する値のカラム物理名

setProcessActiveFlgColumnName

public void setProcessActiveFlgColumnName(java.lang.String processActiveFlgColumnName)

プロセスが起動中であることを示すフラグが格納されるカラムの物理名を設定する。

パラメータ:

processActiveFlgColumnName - プロセス起動中フラグのカラム物理名

setPermitProcessIdentifier

public void setPermitProcessIdentifier(java.lang.String[] permitProcessIdentifier)

２重起動を許可するプロセスの識別子リストを設定する。

パラメータ:

permitProcessIdentifier - 許可リクエストIDのリスト

checkAndActive

public void checkAndActive(java.lang.String processIdentifier)
                    throws AlreadyProcessRunningException

インタフェースからコピーされた説明: DuplicateProcessChecker

プロセスの2重起動チェックとアクティブ化を行う。 プロセスが既に実行中の場合には、AlreadyProcessRunningExceptionを送出する。

定義:

checkAndActive インタフェース内 DuplicateProcessChecker

パラメータ:

processIdentifier - プロセスを識別する値

例外:

AlreadyProcessRunningException - プロセスの多重起動の場合

inactive

public void inactive(java.lang.String processIdentifier)

インタフェースからコピーされた説明: DuplicateProcessChecker

プロセスの非アクティブ化を行う。

定義:

inactive インタフェース内 DuplicateProcessChecker

パラメータ:

processIdentifier - プロセスを識別する値