- Java 9 教程
- Java 9 - 主页
- Java 9 - 概述
- Java 9 - 环境设置
- Java 9 - 模块系统
- Java 9 - REPL(JShell)
- Java 9 - 改进的 JavaDocs
- Java 9 - 多版本 JAR
- Java 9 - 集合工厂方法
- Java 9 - 私有接口方法
- Java 9 - 流程 API 改进
- Java 9 - 流 API 改进
- 尝试资源改进
- 增强的@Deprecated注释
- 内部类钻石运算符
- 可选的类改进
- Java 9 - 多分辨率图像 API
- CompletableFuture API 改进
- Java 9 - 其他功能
- java9 有用的资源
- Java 9 - 问题与解答
- Java 9 - 快速指南
- Java 9 - 有用的资源
- Java 9 - 讨论
Java 9 - 改进的 JavaDocs
Java 文档可以使用 javadoc 工具生成。它当前生成 html 4.0 格式的文档。在java 9中,我们可以通过在命令行参数中使用-html5选项来生成html 5格式的文档。
旧式java文档
考虑 C:/JAVA 文件夹中的以下代码。
测试器.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 文档页面,您将看到以下输出。