org.seasar.framework.container
インタフェース ComponentDeployer

既知の実装クラスの一覧:

AbstractComponentDeployer, ApplicationComponentDeployer, OuterComponentDeployer, PrototypeComponentDeployer, RequestComponentDeployer, SessionComponentDeployer, SingletonComponentDeployer

public interface ComponentDeployer

コンポーネントデプロイヤは、 コンポーネントを利用可能な状態にして提供するためのインタフェースです。

このインターフェースは、 コンポーネントインスタンス定義に応じて以下の機能を提供します。

シングルトン(singleton)の場合

• コンポーネントを1回だけ生成して保持
• 保持しているコンポーネントの提供

プロトタイプ(prototype)の場合

• 新しいコンポーネントインスタンスの生成と提供

外部コンテキスト(application、 session、 request)の場合

• コンポーネントインスタンスの生成と外部コンテキストへの配備
• 外部コンテキストから取得したコンポーネントインスタンスの提供

外部コンポーネント(outer)の場合

• 外部コンポーネントに対する依存コンポーネントのインジェクション

コンポーネントインスタンス定義と有効なメソッドの対応表を以下に示します。

コンポーネントインスタンス定義と有効なメソッドとの関係
コンポーネントインスタンス定義		シングルトン	プロトタイプ	外部コンテキスト			外部コンポーネント
		singleton	prototype	application	session	request	outer
メソッド	init()	○	△	△	△	△	△
	deploy()	○	○	○	○	○	×
	injectDependency(Object)	×	×	×	×	×	○
	destroy()	○	△	△	△	△	△

○:適切な処理が行われます △:例外は発生しませんが何も処理を行いません ×:例外が発生します

作成者:

higa, belltree (Javacoc)

メソッドの概要

Object	deploy() コンポーネントインスタンス定義に応じてインスタンス生成や外部コンテキストへの配備などを行った後に、 そのコンポーネントのインスタンスを返します。
void	destroy() コンポーネントデプロイヤを破棄します。
void	init() コンポーネントデプロイヤを初期化します。
void	injectDependency(Object outerComponent) 外部コンポーネントouterComponentに対し、 このコンポーネントデプロイヤのコンポーネント定義に基づいて、 S2コンテナ上のコンポーネントをインジェクションします。

メソッドの詳細

deploy

Object deploy()

コンポーネントインスタンス定義に応じてインスタンス生成や外部コンテキストへの配備などを行った後に、 そのコンポーネントのインスタンスを返します。

戻り値:

コンポーネントのインスタンス

関連項目:

SingletonComponentDeployer.deploy(), PrototypeComponentDeployer.deploy(), ApplicationComponentDeployer.deploy(), RequestComponentDeployer.deploy(), SessionComponentDeployer.deploy()

injectDependency

void injectDependency(Object outerComponent)

外部コンポーネントouterComponentに対し、 このコンポーネントデプロイヤのコンポーネント定義に基づいて、 S2コンテナ上のコンポーネントをインジェクションします。

パラメータ:

outerComponent - 外部コンポーネント

関連項目:

OuterComponentDeployer.injectDependency(Object)

init

void init()

コンポーネントデプロイヤを初期化します。

デプロイするコンポーネントのコンポーネントインスタンス定義がsingletonの場合には、 アスペクトを適用したインスタンスの生成、 配備、 プロパティ設定の後に、 initMethodが呼ばれます。

関連項目:

SingletonComponentDeployer.init(), DefaultInitMethodAssembler.assemble(Object)

destroy

void destroy()

コンポーネントデプロイヤを破棄します。

デプロイするコンポーネントのコンポーネントインスタンス定義がsingletonの場合には、 destoryMethodが呼ばれます。

関連項目:

SingletonComponentDeployer.destroy(), DefaultDestroyMethodAssembler.assemble(Object)