Java 9 - JavaDocs améliorés
La documentation Java peut être générée à l'aide de l'outil javadoc. Il génère actuellement de la documentation au format html 4.0. Dans Java 9, nous pouvons générer de la documentation au format html 5 en utilisant l'option -html5 dans les arguments de la ligne de commande.
Documentation Java à l'ancienne
Considérez le code suivant dans le dossier C:/JAVA.
Testeur.java
Démo en direct
/**
* @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");
}
}
Exécutez maintenant l'outil javadoc de jdk 7 pour générer la documentation.
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...
Il créera la page de documentation Java dans le répertoire C:/JAVA et vous verrez la sortie suivante.
Nouvelle documentation Java avec prise en charge de la recherche et HTML5
Exécutez l'outil javadoc de jdk 9 avec l'indicateur -html5 pour générer un nouveau type de documentation.
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...
Il créera la page de documentation Java mise à jour dans le répertoire D:/test et vous verrez la sortie suivante.
Java