Javadocの良い例[終了]


140

Javadocを含むソースファイルの良い例はありますか?

私はインターネット上でJavadocの良い例をたくさん見つけることができます。それらを作成するために使用される特定の構文を見つけたいと思います。どこかでライブラリのソースを調べられると思いますが、それは大変な作業のようです。

回答:


118

JDKのソースコードはどうですか?docjarのようなサードパーティからアクセスしますか?たとえば、コレクションのソース

そうすれば、大きなダウンロードはありません。


1
JoshとNealがコレクションを書いて以来、それは良い答えです。
cherouvim 2009

私のウイルス対策ソフトウェアは、docjarリンクは安全ではないと言っています。コレクションのソースを特徴とする他のウェブサイトを知っていますか?(これがトラフィック量の多い質問でなければ、スライドさせます:)
Gordon Gustafson 2013年

2
Windowsの場合、JDKのインストールにsrc.zipは、標準ライブラリのソースコードを含むファイルが含まれます。
スリハルシャチラカパティ2014

第三者が著作権で保護されたコードを配布することはどのように合法ですか?または著作権はそれを許可しますか?
ThePyroEagle

これは、「Docjar.netがダウンしている」という外部リンクの主な問題です。
ゼウス書

39

Javadocツールのドキュメントコメントを書く方法のページには、多数の優れた例が含まれています。1つのセクションは「Docコメントの例」と呼ばれ、かなりの使用法が含まれています。

また、Javadoc FAQには、答えを説明するためのいくつかの例が含まれています。



9

どの程度JDKのソースコード?


それは私の明白な考えでしたが、大きな混乱全体をダウンロードする必要があります。:-(
ジェイソンS

5
JDKに付属しているため、すでにインストールされている可能性があります(インストールオプションですが)。
Michael Borgwardt

5

ドキュメントパターンの小さなセットを使用します。

  • 常にスレッドセーフについて文書化する
  • 常に不変性を文書化する
  • 例付きのjavadoc(Formatterなど
  • 注釈付き要素を置き換えるためのWHYおよびHOWによる@Deprecation

非推奨のthxを置き換える方法を含めるための素晴らしいヒント
Tobi Tiggers



2

Luceneのソースをダウンロードして、それがどのように行われるかを確認してください。彼らは良いJavaDocsを持っています。


2

Eclipseを使用している場合は、インストールされているJREJDKJREではない)をセットアップし、次にOpen Type(+ + )を使用して、次のようにします。CtrlShiftTjava.util.Collections


1
言われたことに加えて、ほとんどのIDEは、使用するJDKを構成するときに、javadocとソースを自動的に構成します。これはEclipseだけに当てはまるわけではありません。
ThePyroEagle


1

JDKをインストールし、ソースもインストールすることを選択した場合、src.zipにはすべてのパブリックJavaクラスのソースが含まれます。これらのほとんどはかなり良いjavadocを持っています。


弊社のサイトを使用することにより、あなたは弊社のクッキーポリシーおよびプライバシーポリシーを読み、理解したものとみなされます。
Licensed under cc by-sa 3.0 with attribution required.