package-info.java からこのパッケージの外部 (同じプロジェクト内) の別のパッケージにリンクする方法はありますか?
Java 7でこれを行おうとすると、常に次のようになります。
warning - Tag @link: reference not found:
との両方がパッケージへのリンクをサポートしてい@link
ます。@see
ファイルの 1 つに次のコードがpackage-info.java
あり、javadoc ツールがリンクを生成します。
/** * <p>ただし、{@link gov.va.med.srcalc.domain} のクラスは * JPA アノテーションを介して大部分のデータ マッピングを定義します。</p> */ パッケージ gov.va.med.srcalc.db;
ビルド ツールとして Gradle を使用していますが、Gradle ではリンクが生成されず、reference not found: gov.va.med.srcalc.domain
警告が表示されることがわかりました。多分それはGradleのバグです。
@docroot
標準の Java ドックレットで動作する単純なリンク:
/**
* See the
* <a href="{@docRoot}/com/mycorp/package-summary.html#package_description">
* package overview
* </a> for more information.
*/
これが package-info.java またはクラスで必要かどうかは問題ではありません{@link}
。タグはパッケージへのリンクを処理できません。
これは回避策ですが、少なくともパッケージ内のファイルにリンクする場合、com.foo.Bar
Eclipseでは、後でインライン プレビューなどでホバー/クリックすることで説明Bar
に移動できます。package-info.java
foo
javadoc が参照している名前空間を認識できるように、使用したパッケージをインポートする必要があります。
package-info.java は、次のリンクを参照してください。
import package.subpackage.ClassnameYouWantToLink;
/**
* {@link ClassnameYouWantToLink}
*/
パッケージをインポートしたくない場合は、ClassName の前に完全に修飾された package-Name が必要です。
/**
* {@link package.subpackage.ClassnameYouWantToLink}
*/