Javadocの作成

Javaドキュメントの作成

Javadocの作成

JavadocはJavaソースコードからHTML形式のドキュメントを生成します。

Javaアプリケーションを作成するとき、保守などのために各プログラムの仕様書を作成しなければならない場合があります。ソースコードに含まれるクラスやメソッドなどを後から調べて仕様書を作成するのは簡単ではありません。

JavadocはJDKに標準で含まれているプログラムで、ソースコードに含まれるクラスやメソッドのコメントから自動的に仕様書を作成してくれる便利なツールです。ここではJavadocの書き方を中心に使い方を説明します。

Javadocの規則に従ったコメントの書き方を学ぶことで、Javaプログラミングにおけるコメント作成の標準も学べます。


Javadocの基本

Javadocで生成されるドキュメントの確認や、Javadocに対応したコメントの書き方など、Javadocの基本事項を説明する。

Javadocコメントの書式

Javadocで生成されるドキュメントの確認や、Javadocに関連するコメントの書き方など、Javadocの基本事項を説明する。

Javadocタグ

コメントには説明文とJavadocタグを書くことができる。ここでは、引数や戻り値、例外、参照先の指定などに使うJavadocタグと値について説明する。

Javadocオプションの指定

Javadocツールを使用するときには、いくつかのオプションが用意されている。ここでは各オプションの使い方を実際の例を見ながら確認する。