23

非常によく文書化されたインターフェースを生成しました。すべてのメソッドには独自の JavaDoc があります。このインターフェイスを実装するクラスは、ロジックにほとんど違いがありません。

スーパークラスから既存のJavaDocにJavaDocを追加するにはどうすればよいですか。キーワード

/**
 * {@inheritDoc}
 */

スーパークラスの javaDoc のみを現在のメソッドに設定します。しかし、いくつかの単語を追加しようとすると、次のようにスーパーメソッドのJavaDocがなくなりました

/**
 * {@inheritDoc}
 * These value depends on...
 */

スーパーメソッドのJavaDocを削除せずに更新する方法を知っている人はいますか?

編集：

ブライアン・アグニューの回答に関しては、これは良いですが、本当の回答ではありません;）

Swing の paint() のような既存のメソッドを上書きしたい場合や、外部から描画動作を初期化または処理する方法を記述したい場合にも、同じ問題が発生する可能性があります。これはインターフェースの説明だけではありません。

4

2 に答える 2

16

javadoc に何かを追加する必要がある場合は、何かを変更したと思います。したがって、まったく同じ方法で javadoc を記述するのが正しいかもしれません。

/**
 * Enhanced swing paint for my cool component.
 * @see JButton#paint();
 */
@Override
public void paint() {
    super.paint();
    //my stuff
}
于 2010-02-08T09:32:57.467 に答える
2

それを行う直接的なJavaDocイディオムは知りません。ただし、Eclipse と IntelliJ を使用すると、スーパー JDoc を取得して挿入できます...完全にはほど遠いです。supr JDoc を変更する場合は、すべてのオーバーライドを再編集する必要がありますが、手動でコピーして貼り付けるよりはましです...

于 2009-04-02T17:27:03.063 に答える