[seasar-javadoc:783] Re: AbstractTagHandler

[Koichi Kobayashi]

小林 (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>