Java 9 - 改善された JavaDoc
Java ドキュメントは、javadoc ツールを使用して生成できます。現在、ドキュメントは html 4.0 形式で生成されます。 Java 9 では、コマンド ライン引数で -html5 オプションを使用して、html 5 形式でドキュメントを生成できます。
古いスタイルの Java ドキュメント
C:/JAVA フォルダー内の次のコードを検討してください。
Tester.java
ライブデモ
/**
* @author MahKumar
* @version 0.1
*/
public class Tester {
/**
* Default method to be run to print
* <p>Hello world</p>
* @param args command line arguments
*/
public static void main(String []args) {
System.out.println("Hello World");
}
}
jdk 7 の javadoc ツールを実行してドキュメントを生成します。
C:\JAVA>javadoc -d C:/JAVA Tester.java Loading source file tester.java... Constructing Javadoc information... Standard Doclet version 1.7.0_21 Building tree for all the packages and classes... Generating C:\JAVA\Tester.html... Generating C:\JAVA\package-frame.html... Generating C:\JAVA\package-summary.html... Generating C:\JAVA\package-tree.html... Generating C:\JAVA\constant-values.html... Building index for all the packages and classes... Generating C:\JAVA\overview-tree.html... Generating C:\JAVA\index-all.html... Generating C:\JAVA\deprecated-list.html... Building index for all classes... Generating C:\JAVA\allclasses-frame.html... Generating C:\JAVA\allclasses-noframe.html... Generating C:\JAVA\index.html... Generating C:\JAVA\help-doc.html...
C:/JAVA ディレクトリに Java ドキュメント ページが作成され、次の出力が表示されます。
検索と HTML5 をサポートする新しい Java ドキュメント
-html5 フラグを指定して jdk 9 の javadoc ツールを実行し、新しいタイプのドキュメントを生成します。
C:\JAVA> javadoc -d C:/JAVA -html5 Tester.java Loading source file Tester.java... Constructing Javadoc information... Standard Doclet version 9.0.1 Building tree for all the packages and classes... Generating C:\JAVA\Tester.html... Generating C:\JAVA\package-frame.html... Generating C:\JAVA\package-summary.html... Generating C:\JAVA\package-tree.html... Generating C:\JAVA\constant-values.html... Building index for all the packages and classes... Generating C:\JAVA\overview-tree.html... Generating C:\JAVA\index-all.html... Generating C:\JAVA\deprecated-list.html... Building index for all classes... Generating C:\JAVA\allclasses-frame.html... Generating C:\JAVA\allclasses-frame.html... Generating C:\JAVA\allclasses-noframe.html... Generating C:\JAVA\allclasses-noframe.html... Generating C:\JAVA\index.html... Generating C:\JAVA\help-doc.html...
D:/test ディレクトリに更新された Java ドキュメント ページが作成され、次の出力が表示されます。
Java