[seasar-javadoc:481] Re: TooManyRegistrationComponentDef

[Koichi Kobayashi]

小林 (koichik) です．

Date:    Mon, 31 Jul 2006 22:02:34 +0900
From:    Seto Azusa <azusa ＠ fieldnotes.jp>
To:      seasar-javadoc ＠ ml.seasar.org
Subject: [seasar-javadoc:477]  TooManyRegistrationComponentDef

> TooManyRegistrationComponentDef.javaのJavaDocです。

ありがとうございます．

>  * S2コンテナ内に1つのキーで複数登録されたコンポーネントを定義するインタフェースです。

「コンポーネントを定義する〜」だとちょっと違和感．
ComponentDef と同様，「コンポーネントの定義を表す〜」で．
お願いします．

>  * コンポーネントを取得しようとした際に、 指定したキー(コンポーネントのクラス、 インターフェース、
>  * あるいは名前)に該当するコンポーネント定義が複数存在した場合、 {@link TooManyRegistrationRuntimeException}がスローされます。

これはこれでいいと思うのですが，実際にはこれは TooMany〜Exception の
説明なので，1 行目とこれの間に TooMany〜Def 自身の説明がもう少し
欲しいですね．
例えば

 * コンテナにコンポーネントが登録される際に、そのキーに対応する
 * コンポーネントがすでに登録されていると，そのコンポーネント定義は
 * <code>TooManyRegistrationComponentDef</code>になります。

みたいなことを書いておいて (「そのキー」「そのコンポーネント」と
続くのはイマイチかも，改善お願いします)，

 * コンポーネントを取得しようとした際に、コンポーネント定義が
 * <code>TooManyRegistrationComponentDef</code> である場合、
 * {@link TooManyRegistrationRuntimeException}がスローされます。

みたいに続けるとか．


-- 
<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>