Javadoc

みるくあいらんどっ! > ドキュメント > Java > じっくり学ぶ Java講座 [初心者向け・入門]


Javadocコメントの書き方

Javadocコメントとは「/**」と「*/」でくくるコメントのことでした。

Javadocコメントの中で主に使用するのは以下の 4つです。

  • @args 引数…引数の説明
  • @throws 例外…例外の説明
  • @return…戻り値の説明

Javadocを生成する

Javadocコメントを HTMLファイルとして出力することができます。手順は以下の通り。

まずは、出力したいプロジェクトを選択します。今回は D302プロジェクトを選択しました。

プロジェクトを選択

続いて、メニューバーから、Project→ Generate Javadocを選択します。

Javadoc生成を選択

新しいウインドウが表示されます。

サブウインドウ

ここでは、3点を設定する必要があります。

  • Javadoc command…「Configure」ボタンを押し、パソコンのどこかに入っている JDKディレクトリの binディレクトリの中にある javadocを選択します。
  • Create Javadoc for members with visibility…今回は「Package」を選択します。
  • Use standard doclet…出力ディレクトリを指定します。新規ディレクトリを指定しましょう。

最後に「Finish」を押すと、Javadocが生成されます。その index.htmlを開くと、そのプロジェクトのクラスやメソッドの一覧を確認することができます。

最終更新: 2013/03/14 , 公開: 2013/03/14
▲top