Javadoc
日本語 | ジャバ文書 |
英語 | java document |
ふりがな | じゃばどっく |
フリガナ | ジャバドック |
プログラムに書かれたコメントからドキュメントを作成するためのツール。
J2SEに付属するツールのひとつ。
javadocコマンドを使用することで、プログラムのドキュメンテーションコメント内のコメントから、HTML形式の仕様書を作成する。
パッケージ、クラス、メソッド、フィールドそれぞれの詳細なドキュメントを記述することができる。また、「@」から始まるタグを使用することで細かい情報を記述することができる。
J2SEに付属するツールのひとつ。
javadocコマンドを使用することで、プログラムのドキュメンテーションコメント内のコメントから、HTML形式の仕様書を作成する。
パッケージ、クラス、メソッド、フィールドそれぞれの詳細なドキュメントを記述することができる。また、「@」から始まるタグを使用することで細かい情報を記述することができる。
// Sample.java
/**
* サンプルクラスです。
*/
public class Sample
{
/**
* main()メソッド。<br>
* 最初に呼ばれるメソッドです。
* @param args javaコマンド実行時に渡されるパラメーターが入っています。
*/
public static void main( String[] args )
{
int result = toInt( "100" );
System.out.println( result );
// 100
}
/**
* 整数値に変換します。
* @return 変換後の整数値。
* @param string 変換前の文字列。"100"とか。
*/
public static int toInt( String string )
{
return Integer.parseInt( string );
}
}
/*
あとは、javadocコマンドで出力します。
>javadoc -d html src/*.java
この例では、srcディレクトリ内のソースファイルのドキュメントを
htmlディレクトリに出力します。
*/
/**
* サンプルクラスです。
*/
public class Sample
{
/**
* main()メソッド。<br>
* 最初に呼ばれるメソッドです。
* @param args javaコマンド実行時に渡されるパラメーターが入っています。
*/
public static void main( String[] args )
{
int result = toInt( "100" );
System.out.println( result );
// 100
}
/**
* 整数値に変換します。
* @return 変換後の整数値。
* @param string 変換前の文字列。"100"とか。
*/
public static int toInt( String string )
{
return Integer.parseInt( string );
}
}
/*
あとは、javadocコマンドで出力します。
>javadoc -d html src/*.java
この例では、srcディレクトリ内のソースファイルのドキュメントを
htmlディレクトリに出力します。
*/
// Sample.java /** * サンプルクラスです。 */ public class Sample { /** * main()メソッド。<br> * 最初に呼ばれるメソッドです。 * @param args javaコマンド実行時に渡されるパラメーターが入っています。 */ public static void main( String[] args ) { int result = toInt( "100" ); System.out.println( result ); // 100 } /** * 整数値に変換します。 * @return 変換後の整数値。 * @param string 変換前の文字列。"100"とか。 */ public static int toInt( String string ) { return Integer.parseInt( string ); } } /* あとは、javadocコマンドで出力します。 >javadoc -d html src/*.java この例では、srcディレクトリ内のソースファイルのドキュメントを htmlディレクトリに出力します。 */