[seasar-javadoc:363] Re: ComponentDeployer

Koichi Kobayashi koichik @ improvement.jp
2006年 7月 15日 (土) 03:00:04 JST


小林 (koichik) です.

Date:    Thu, 13 Jul 2006 02:22:10 +0900
From:    Hideaki Suzuki <suzuki @ uinet.or.jp>
To:      seasar-javadoc @ ml.seasar.org
Subject: [seasar-javadoc:357] Re: ComponentDeployer

> ○ 有効(処理あり)
> △ 有効(処理なし)
> × 無効(例外)
> という色分けで表を調整してみました。いかがでしょう?

よさげです.
あと,「処理あり」「処理なし」の説明を簡単にした方がいいかも.

> ついでに、さりげなく外部コンテキストの並びも、スコープの大きい順
> application > session > request
> に直しました ^^;;;

いいっすね.

> さらに deploy() メソッドの内容が、"deploy" の名に恥じる内容だったので
> 肉付けしてみました。 ^^;

こちらもいいと思います.


ちょっと気になったのはやはりクラスコメントの冒頭ですね.

>  * このインターフェースは、 コンポーネントを利用可能にするための機能を提供するコンポーネントデプロイヤを表します。

どうせ「コンポーネントデプロイヤ」って言葉を使うなら,いっそのこと

 * コンポーネントデプロイヤのインタフェースです。
 * <p>
 * コンポーネントデプロイヤとは、コンポーネントを利用可能にして提供するもので、
 * {@link InstanceDef コンポーネントインスタンス定義}に応じて以下の機能を提供します。

とかどうでしょう?


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



seasar-javadoc メーリングリストの案内