Java 9 Javadocの改善

Java 9 新特性Java 9 の新機能

javadoc ツールは Java ドキュメントを生成できます。Java 9 の javadoc の出力は HTML5 標準に準拠するようになりました。

Java 9 より前の旧バージョンのドキュメント

次のファイルコード 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 9 で生成されたドキュメントは HTML5 標準に準拠しています

jdk 9 の javadoc コマンドの-html5パラメータを使用すると、生成されたドキュメントが HTML5 標準をサポートできるようになります:

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...

上記のコマンドを実行すると、C:/JAVA ディレクトリの下にドキュメントページが生成されます。次の図のようになります:

Java 9 新特性Java 9 の新機能

その他の拡張