286

現在、この Javadoc 構文を使用して他のクラスのメソッドを参照しています。

@see {@link com.my.package.Class#method()}

そして、ドキュメントから私が理解していることでは、これがこれを行う正しい方法です。しかし、ここで面白い部分、またはイライラする部分に移ります。このjavadocを生成すると、まず次のエラーが発生します:

warning - Tag @see:illegal character: "123" in "{@link com.my.package.Class#method()}"
warning - Tag @see:illegal character: "64" in "{@link com.my.package.Class#method()}"
warning - Tag @see: reference not found: {@link com.my.package.Class#method()}

これの生成された HTML コードは次のとおりです。

"," <code>com.my.package.Class#method()}</code> ","

そしてもちろん、私はリンクを持っていません。何が起こっているのか、これを修正する方法についてのヒントを教えてもらえますか?

ASCII テーブルによると、 wold の文字 123 と 64 は { と @ を表すので、この構文がドキュメントに従って正しいのに、これらの文字が有効でないのはなぜですか?

4

3 に答える 3

341

Javadoc タグの場合、 ;@seeを使用する必要はありません。@linkJavadoc がリンクを作成します。試す

@see com.my.package.Class#method()

についての詳細はこちら@see。

于 2013-07-05T19:57:39.580 に答える
95

したがって、元の問題の解決策は、同じ行に "@see" と "{@link...}" の両方の参照を必要としないことです。「@link」タグは自己完結型であり、前述のように、javadoc ブロック内のどこにでも配置できます。したがって、2 つのアプローチを混在させることができます。

/**
 * some javadoc stuff
 * {@link com.my.package.Class#method()}
 * more stuff
 * @see com.my.package.AnotherClass
 */
于 2016-07-19T17:39:07.353 に答える