[解決済み] seeと@inheritDocの違いについて詳しく説明します。
2022-01-31 06:22:49
質問
に目を通しました。
JavaDocリファレンス
との基本的な違いは理解していますが
@see
(各種リンク)と
{@inheritDoc}
(スーパークラスのエクスポート JavaDocコメント) が、実際にどのように実装されているのかを明確にする必要があります。
Eclipse IDEで、継承されたメソッド(インターフェースやtoString()のオーバーライドなど)の「要素のコメントを生成」を選択すると、以下のコメントが作成されます。
/* (non-Javadoc)
* @see SomeClass#someMethod()
*/
JavaDoc を作成する必要がある場合、そのままにしておくべきか、それとも次のように置き換えるべきか。
@see
で
{@inheritDoc}
で回すか
善意
このようなJavaDocです。
/**
* {@inheritDoc}
*/
その際、class#methodフラグはそのままで良いのでしょうか?
どのように解決するのですか?
まず、オリジナルのeclipseのテンプレートは、うるさいだけのガラクタなので、削除した方がいいです。意味のあるドキュメントを入れるか、何も入れないかのどちらかです。しかし、IDEのテンプレートを使って無駄な再掲をするのは、コードを乱雑にするだけです。
次に、javadocの作成が義務付けられているのであれば
ある
で始まるコメントとする。
/**
. そうでなければ、javadocではありません。
最後に、もしオーバーライドするのであれば、その時は
@inheritDoc
(にしたい場合を想定しています)。
追加
に、@seh がコメントで指摘したように、オリジナルのドキュメントを複製するだけなら、何も必要ありません)。
@see
を参照するためにのみ使用されるべきです。
その他
関連するメソッドです。
関連
-
[解決済み] JavaでSSLピアが正しくシャットダウンされない
-
[解決済み] SQLエラー。0, SQLState: 08S01 通信リンクの失敗 [重複]。
-
[解決済み] JavaにおけるHashMapとHashtableの違いは何ですか?
-
[解決済み] Javaにおけるpublic、protected、package-private、privateの違いは何ですか?
-
[解決済み] serialVersionUIDとは何ですか、またなぜそれを使用する必要がありますか?
-
[解決済み] StringBuilderとStringBufferの違いについて
-
[解決済み] wait()とsleep()の違いについて
-
[解決済み] Javaクラスにおけるcanonical name、simple name、class nameの違いは何ですか?
-
[解決済み] JDKとJREの違いは何ですか?
-
[解決済み】HashMap、LinkedHashMap、TreeMapの違いについて
最新
-
nginxです。[emerg] 0.0.0.0:80 への bind() に失敗しました (98: アドレスは既に使用中です)
-
htmlページでギリシャ文字を使うには
-
ピュアhtml+cssでの要素読み込み効果
-
純粋なhtml + cssで五輪を実現するサンプルコード
-
ナビゲーションバー・ドロップダウンメニューのHTML+CSSサンプルコード
-
タイピング効果を実現するピュアhtml+css
-
htmlの選択ボックスのプレースホルダー作成に関する質問
-
html css3 伸縮しない 画像表示効果
-
トップナビゲーションバーメニュー作成用HTML+CSS
-
html+css 実装 サイバーパンク風ボタン
おすすめ
-
[解決済み】Javaパッケージが存在しないエラー
-
[解決済み】StringUtils.isBlank() vs String.isEmpty()
-
[解決済み】Java、"変数名 "を変数に解決することができない
-
[解決済み】Android Studioでタスク :app:compileDebugJavaWithJavac の実行に失敗しました。
-
[解決済み】Java JDK - doubleからintへの非可逆変換の可能性
-
[解決済み】非閉鎖文字リテラルエラー
-
[解決済み] メソッドがそのスーパークラスのメソッドをオーバーライドしない
-
[解決済み] intellijが自動配線リポジトリにタイプのBeanが見つからないと不正確な発言をする件
-
[解決済み】Eclipseで「JUnitテストが見つかりませんでした。
-
[解決済み] java.sql.SQLException を取得しました。ResultSet が終了した後の操作は許可されません。