[seasar-javadoc:783] Re: AbstractTagHandler

Koichi Kobayashi koichik @ improvement.jp
2007年 1月 28日 (日) 03:00:12 JST


小林 (koichik) です.

Date:    Sat, 27 Jan 2007 02:52:56 +0900
From:    yatsu <fusatsukatsujin @ tbc.t-com.ne.jp>
To:      seasar-javadoc @ ml.seasar.org
Subject: [seasar-javadoc:782] Re: AbstractTagHandler

> というわけで、修正しましたのでご確認お願いいたします。

ありがとうございます.
以下,コメントです.

■クラスコメント

>  * <code> XmlS2ContainerBuilder</code>で共通に必要になる機能を、サブクラスに対し提供します。

XmlS2ContainerBuilder は @link しませう.

■createExpression()

>      * {@link OgnlExpression 式(OGNL)}を生成します。

@link の中のクラス名は import 文の効果がないので
FQN (パッケージで修飾された名前)でお願いします.
「式(OGNL)」は「OGNL式」でいいかと思います.

>      * @param context
>      *            <code>TagHandler</code>のコンテキスト情報

こちらの TagHandler も @link で.

>      * @return 生成された式

こっちも「OGNL式」で.

あと,throws 節に宣言されてないけどスローされる例外って
どうしてましたっけ?>ALL
このメソッドの場合,引数の body が OGNL として不正だと
OgnlRuntimeException がスローされることになるのだけど.

と思って JPA の Javadoc 見たら,throws 節に宣言がない
実行時例外でも Javadoc には @throws に書いてあるので,
書いた方がよさげ.
そんなわけで (どんなわけで?),追記お願いします>谷津さん


-- 
<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 メーリングリストの案内