ComponentDeployer (Lasta Di 0.6.0-RC7 API)

既知の実装クラスのリスト:: 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()`	`○`	△	△	△	△	△

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

作成者:: modified by jflute (originated in Seasar), belltree

メソッドのサマリー

All Methods Instance Methods Abstract Methods
修飾子とタイプ	メソッドと説明
`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)

インタフェース ComponentDeployer

メソッドのサマリー

メソッドの詳細

deploy

injectDependency

init

destroy