[seasar-javadoc:259] Re: S2Container

[Koichi Kobayashi]

小林 (koichik) です．

Date:    Tue, 20 Jun 2006 00:24:25 +0900
From:    "Makoto Yonezawa" <stratosphire ＠ gmail.com>
To:      seasar-javadoc ＠ ml.seasar.org
Subject: [seasar-javadoc:255] Re: S2Container

> 今までの内容の反映とプラス
> #void registerDescendant(S2Container descendant);
> までの送ります。

お疲れ様です．

injectDependency(Object outerComponent) ですが，

>      * <code>outerComponent</code>のクラスをキーとして登録された
>      * {@link ComponentDef コンポーネント定義}に従って必要なコンポーネントのインジェクションを実行します。

「従って」の後に「、」を入れた方がいいかも．

injectDependency(Object outerComponent, Class componentClass)

>      * <code>componentClass</code>のクラスをキーとして登録された
>      * {@link ComponentDef コンポーネント定義}に従って必要なコンポーネントのインジェクションを実行します。

この場合は componentClass 自身がキーとなります．
componentClass は Class 型なので，そのクラスは Class です．

injectDependency(Object outerComponent, String componentName)

>      * <code>componentName</code>のクラスをキーとして登録された
>      * {@link ComponentDef コンポーネント定義}に従ってインジェクションを実行します。

componentName がキーとなります．
componentName は String 型なので以下略


register(Object component)

>      * オブジェクトをコンポーネントとして登録します。
>      * キーはオブジェクトのクラスになります。

「オブジェクト」だと何のオブジェクトか分かりにくい気もするので，
「<code>component</code>」がよいかも．
injectDependency() との一貫性の点でも．

getComponentDefSize()

>      * コンポーネント定義の数を返します。

「コンテナに登録されている」を頭に付けた方がよさげ．


findComponentDefs(Object componentKey)

>      * @return コンポーネント定義の配列。キーに対応するコンポーネントが存在しない場合は空の配列を返します。
最後の「を返します」はいらないかな．


> descendantがかなり怪しくなっています・・・つっこみお願いしますm_ _m

怪しいというか，元々の実装が少し微妙かも．

hasDescendant(String path)

>      * ルートのS2コンテナで指定したパスに対応するS2コンテナが読み込まれている場合<code>true</code>を返します。

S2Container 単独としては，ルートからの話ではないです．
registerDescendant(S2Container) されたものであれば，true を
返すというだけです．

ただし，S2ContainerFactory はインクルードが発生すると
ルートに対して registerDescendant(S2Container) を呼び出します．
その意味では記述通り．

んで，この場合は S2ContainerFactory のやってることも S2Container の
仕様と考えるべきか否か．
ちょっと悩ましいなぁ．



-- 
<component name="koichik">
    <property name="fullName">"Koichi Kobayashi"</property>
    <property name="email">"koichik ＠ improvement.jp"</property>
    <property name="blog">"http://d.hatena.ne.jp/koichik"</property>
</component>