nablarch.fw.web.handler

Class SessionConcurrentAccessHandler

java.lang.Object

nablarch.fw.web.handler.SessionConcurrentAccessHandler

All Implemented Interfaces:

Handler<java.lang.Object,java.lang.Object>

Direct Known Subclasses:

SessionConcurrentAccessHandler

Deprecated.

本ハンドラは、SessionStoreを用いてセッション管理を行う SessionStoreHandlerに置き換わりました。

@Deprecated
public class SessionConcurrentAccessHandler
extends java.lang.Object
implements Handler<java.lang.Object,java.lang.Object>

セッションスコープに対する並行アクセス制御を行うハンドラ。

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SessionConcurrentAccessHandler.ConcurrentAccessPolicy Deprecated. セッションスコープ変数に対する並行アクセス同期ポリシー。 補足：並行アクセス同期ポリシーについて、version 1.4.3まではMANUALとSERIALIZEDが存在していたが、MANUALとSERIALIZEについてはversion 1.5.0以降で廃止された。
static class	SessionConcurrentAccessHandler.SessionConfliction Deprecated. セッション書き込みに競合が発生したことを表す例外。

Constructor Summary

Constructors

Constructor and Description
SessionConcurrentAccessHandler() Deprecated.

Method Summary

Modifier and Type	Method and Description
SessionConcurrentAccessHandler.ConcurrentAccessPolicy	getConcurrentAccessPolicy() Deprecated. 並行アクセス同期ポリシーを返す。
java.lang.Object	handle(java.lang.Object req, ExecutionContext ctx) Deprecated. 入力データに対する処理を実行する。
static void	lockSession(java.util.Map<java.lang.String,java.lang.Object> session) Deprecated. セッションオブジェクトに対する排他ロックを獲得する。
SessionConcurrentAccessHandler	setConcurrentAccessPolicy(java.lang.String policyName) Deprecated. セッションスコープ変数に対する並行アクセス同期ポリシーを定義する。
void	setConflictWarningMessageId(java.lang.String messageId) Deprecated. セッションへの書き込みの際に競合が発生した場合に表示される文言の メッセージIDを設定する。
static void	setThrowsErrorOnSessionWriteConflict(boolean throwsError) Deprecated. セッション変更の書き戻しに失敗した場合に実行時例外を送出するか否かを設定する。
static void	unlockSession(java.util.Map<java.lang.String,java.lang.Object> session) Deprecated. カレントスレッドがセッションオブジェクトに対する排他ロックを 保持しているばあい、それを開放する。

Methods inherited from class java.lang.Object

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

Constructor Detail

SessionConcurrentAccessHandler

public SessionConcurrentAccessHandler()

Deprecated.

Method Detail

handle

public java.lang.Object handle(java.lang.Object req,
                               ExecutionContext ctx)

Deprecated.

入力データに対する処理を実行する。 このハンドラの実装では、各並行アクセスポリシーを実装したMapWrapperによって 実行コンテキスト上のセッションスコープをラップし、同期アクセス制御を開始する。 その後、後続ハンドラに処理を委譲する。 同期制御はこのハンドラの終了とともに停止する。 そのため、JSPサーブレットからのセッション書込みを同期対象に含めるには、 本ハンドラをレスポンスハンドラより上位に配置する必要がある。

Specified by:

handle in interface Handler<java.lang.Object,java.lang.Object>

Parameters:

req - 入力データ

ctx - 実行コンテキスト

Returns:

処理結果データ

setConcurrentAccessPolicy

public SessionConcurrentAccessHandler setConcurrentAccessPolicy(java.lang.String policyName)
                                                         throws java.lang.IllegalArgumentException

Deprecated.

セッションスコープ変数に対する並行アクセス同期ポリシーを定義する。

補足：
version 1.5.0以降では、"CONCURRENT" のみ有効。本メソッドは互換性のために残っている。

Parameters:

policyName - 平行アクセス同期ポリシーの名称(version 1.5.0以降では、"CONCURRENT" のみ有効)

Returns:

このオブジェクト自体

Throws:

java.lang.IllegalArgumentException - 上記以外の文字列を指定した場合。

getConcurrentAccessPolicy

public SessionConcurrentAccessHandler.ConcurrentAccessPolicy getConcurrentAccessPolicy()

Deprecated.

並行アクセス同期ポリシーを返す。

Returns:

現状のセッションスコープ変数に対する並行アクセス同期ポリシー。 version 1.5.0以降では、ConcurrentAccessPolicy.CONCURRENTが常に返却される。

setConflictWarningMessageId

public void setConflictWarningMessageId(java.lang.String messageId)

Deprecated.

セッションへの書き込みの際に競合が発生した場合に表示される文言の メッセージIDを設定する。

Parameters:

messageId - メッセージID

lockSession

public static void lockSession(java.util.Map<java.lang.String,java.lang.Object> session)

Deprecated.

セッションオブジェクトに対する排他ロックを獲得する。

Parameters:

session - セッションオブジェクト

unlockSession

public static void unlockSession(java.util.Map<java.lang.String,java.lang.Object> session)

Deprecated.

カレントスレッドがセッションオブジェクトに対する排他ロックを 保持しているばあい、それを開放する。

Parameters:

session - セッションオブジェクト

setThrowsErrorOnSessionWriteConflict

public static void setThrowsErrorOnSessionWriteConflict(boolean throwsError)

Deprecated.

セッション変更の書き戻しに失敗した場合に実行時例外を送出するか否かを設定する。

 明示的に設定しない場合のデフォルトはfalse。
 この場合、エラー画面にワーニングが表示されるものの、DBのトランザクションは正常にコミットされる。
 

Parameters:

throwsError - 例外を送出する場合はtrue