クラス SimpleThreadScope
- 実装されたすべてのインターフェース:
Scope
Scope
実装。 注意 : このスレッドスコープは、一般的なコンテキストではデフォルトでは登録されません。代わりに、ConfigurableBeanFactory.registerScope(java.lang.String, org.springframework.beans.factory.config.Scope)
または CustomScopeConfigurer
Bean のいずれかを使用して、セットアップのスコープキーに明示的に割り当てる必要があります。
SimpleThreadScope
は、それに関連付けられたオブジェクトをクリーンアップしません。通常、Web 環境で org.springframework.web.context.request.RequestScope
などのリクエストにバインドされたスコープ実装を使用し、スコープ付き属性(信頼できる破棄を含む)のライフサイクル全体を実装することをお勧めします。
破棄コールバックをサポートするスレッドベースの Scope
の実装については、例による Spring を参照してください。
スレッドスコープの元のプロトタイプを提出してくれた Eugene Kuleshov に感謝します!
- 導入:
- 3.0
- 作成者:
- Arjen Poutsma, Juergen Hoeller
- 関連事項:
コンストラクターのサマリー
コンストラクターメソッドのサマリー
修飾子と型メソッド説明get
(StringSE name, ObjectFactory<?> objectFactory) 基になるスコープから指定された名前のオブジェクトを返します。基になるストレージメカニズムで見つからない場合はcreating it
。存在する場合、現在の基礎となるスコープの会話 ID を返します。void
registerDestructionCallback
(StringSE name, RunnableSE callback) スコープ内の指定されたオブジェクトの破棄(またはスコープが個々のオブジェクトを破棄せず、その全体で終了する場合はスコープ全体の破棄)で実行されるコールバックを登録します。指定されたname
を持つオブジェクトを基になるスコープから削除します。指定されたキーがある場合、そのコンテキストオブジェクトを解決します。
コンストラクターの詳細
SimpleThreadScope
public SimpleThreadScope()
メソッドの詳細
get
インターフェースからコピーされた説明:Scope
基になるスコープから指定された名前のオブジェクトを返します。基になるストレージメカニズムで見つからない場合はcreating it
。これは、Scope の中心的な操作であり、絶対に必要な唯一の操作です。
- 次で指定:
- インターフェース
Scope
のget
- パラメーター:
name
- 取得するオブジェクトの名前objectFactory
- 基になるストレージメカニズムに存在しない場合、スコープオブジェクトの作成に使用するObjectFactory
- 戻り値:
- 目的のオブジェクト (非
null
)
remove
インターフェースからコピーされた説明:Scope
指定されたname
を持つオブジェクトを基になるスコープから削除します。オブジェクトが見つからなかった場合、
null
を返します。それ以外の場合は、削除されたObject
を返します。実装は、指定されたオブジェクトの登録された破棄コールバックも削除する必要があることに注意してください。ただし、この場合、登録された破棄コールバックを実行する必要はありません。オブジェクトは呼び出し元によって破棄されるためです(適切な場合)。
注: これはオプションの操作です。実装は、オブジェクトの明示的な削除をサポートしていない場合、
UnsupportedOperationException
SE をスローする場合があります。registerDestructionCallback
インターフェースからコピーされた説明:Scope
スコープ内の指定されたオブジェクトの破棄(またはスコープが個々のオブジェクトを破棄せず、その全体で終了する場合はスコープ全体の破棄)で実行されるコールバックを登録します。注: これはオプションの操作です。このメソッドは、実際の破棄構成(DisposableBean、destroy-method、DestructionAwareBeanPostProcessor)を持つスコープ付き Bean に対してのみ呼び出されます。実装は、適切なタイミングで特定のコールバックを実行するために最善を尽くす必要があります。そのようなコールバックが基礎となるランタイム環境によってまったくサポートされていない場合、コールバックは無視され、対応する警告がログに記録される必要があります。
「破棄」とは、アプリケーションによって明示的に削除された個々のスコープオブジェクトではなく、スコープ自体のライフサイクルの一部としてオブジェクトを自動的に破棄することです。スコープ付きオブジェクトがこのファサードの
Scope.remove(String)
メソッドを介して削除された場合、削除されたオブジェクトが再利用されるか手動で破棄されると仮定して、登録されている破棄コールバックも削除する必要があります。- 次で指定:
- インターフェース
Scope
のregisterDestructionCallback
- パラメーター:
name
- 破棄コールバックを実行するオブジェクトの名前callback
- 実行される破棄コールバック。渡された Runnable は例外をスローしないため、try-catch ブロックを囲むことなく安全に実行できることに注意してください。さらに、Runnable は通常、そのターゲットオブジェクトも直列化可能であれば、直列化可能です。- 関連事項:
resolveContextualObject
インターフェースからコピーされた説明:Scope
指定されたキーがある場合、そのコンテキストオブジェクトを解決します。例: キー「リクエスト」の HttpServletRequest オブジェクト。- 次で指定:
- インターフェース
Scope
のresolveContextualObject
- パラメーター:
key
- コンテキストキー- 戻り値:
- 対応するオブジェクト。見つからない場合は
null
getConversationId
インターフェースからコピーされた説明:Scope
存在する場合、現在の基礎となるスコープの会話 ID を返します。会話 ID の正確な意味は、基礎となるストレージメカニズムによって異なります。セッションスコープのオブジェクトの場合、会話 ID は通常
session ID
と等しい(または派生する)でしょう。セッション全体に含まれるカスタム会話の場合、現在の会話の特定の ID が適切です。注: これはオプションの操作です。基になるストレージメカニズムにこのような ID の明らかな候補がない場合、このメソッドの実装で
null
を返すことは完全に有効です。- 次で指定:
- インターフェース
Scope
のgetConversationId
- 戻り値:
- 会話 ID、または現在のスコープに会話 ID がない場合は
null