当前位置:

首页 > 编程开发 > java 改进_Java 9 改进 Javadoc

java 改进_Java 9 改进 Javadoc

Ja va 9改进 Ja vadoc 说到Ja va文档生成,Ja vadoc工具绝对是开发者的老朋友了。在Ja va 9中,这位老朋友迎来了一项重要升级:其生成的文档输出,现在完全符合兼容HTML5标准。这意味着什么?简单来说,就是生成的文档页面能更好地适配现代浏览器,结构更清晰,也更具未来兼容性

本文目录

    Ja va 9改进 Ja vadoc

    说到Ja va文档生成,Ja vadoc工具绝对是开发者的老朋友了。在Ja va 9中,这位老朋友迎来了一项重要升级:其生成的文档输出,现在完全符合兼容HTML5标准。这意味着什么?简单来说,就是生成的文档页面能更好地适配现代浏览器,结构更清晰,也更具未来兼容性。

    Ja va 9之前的旧版本文档

    为了直观地对比,我们先来看看旧版本是如何工作的。假设我们有一个简单的Ja va源文件,路径是 C:/JA VA/Tester.ja va,内容如下:

    实例

    /**
     * @author MahKumar
     * @version 0.1
     */
    public class Tester {
        /**
         * Default method to be run to print
         * 

    Hello world

    * @param args command line arguments */ public static void main(String[] args) { System.out.println("Hello World"); } }

    接下来,我们使用JDK 7环境下的ja vadoc命令来为它生成文档:

    C:\JA VA> ja vadoc -d C:/JA VA Tester.ja va
    Loading source file tester.ja va...
    Constructing Ja vadoc information...
    Standard Doclet version 1.7.0_21
    Building tree for all the packages and classes...
    Generating C:\JA VA\Tester.html...
    Generating C:\JA VA\package-frame.html...
    Generating C:\JA VA\package-summary.html...
    Generating C:\JA VA\package-tree.html...
    Generating C:\JA VA\constant-values.html...
    Building index for all the packages and classes...
    Generating C:\JA VA\overview-tree.html...
    Generating C:\JA VA\index-all.html...
    Generating C:\JA VA\deprecated-list.html...
    Building index for all classes...
    Generating C:\JA VA\allclasses-frame.html...
    Generating C:\JA VA\allclasses-noframe.html...
    Generating C:\JA VA\index.html...
    Generating C:\JA VA\help-doc.html...
    

    命令执行完毕后,一系列HTML文档就会在C:/JA VA目录下生成。其生成的索引页面效果,大致如下图所示:

    ada94978c39496c26449c0556b34877f.png

    Ja va 9生成的文档兼容HTML5标准

    那么,Ja va 9带来了什么变化呢?关键就在于一个新的命令行参数:-html5。使用JDK 9的ja vadoc时,只要加上这个参数,就能强制工具生成完全支持HTML5标准的文档。

    我们同样对那个Tester.ja va文件进行操作,这次使用JDK 9的命令:

    C:\JA VA> ja vadoc -d C:/JA VA -html5 Tester.ja va
    Loading source file Tester.ja va...
    Constructing Ja vadoc information...
    Standard Doclet version 9.0.1
    Building tree for all the packages and classes...
    Generating C:\JA VA\Tester.html...
    Generating C:\JA VA\package-frame.html...
    Generating C:\JA VA\package-summary.html...
    Generating C:\JA VA\package-tree.html...
    Generating C:\JA VA\constant-values.html...
    Building index for all the packages and classes...
    Generating C:\JA VA\overview-tree.html...
    Generating C:\JA VA\index-all.html...
    Generating C:\JA VA\deprecated-list.html...
    Building index for all classes...
    Generating C:\JA VA\allclasses-frame.html...
    Generating C:\JA VA\allclasses-frame.html...
    Generating C:\JA VA\allclasses-noframe.html...
    Generating C:\JA VA\allclasses-noframe.html...
    Generating C:\JA VA\index.html...
    Generating C:\JA VA\help-doc.html...
    

    从输出日志可以看到,核心流程与之前类似,但底层生成的HTML代码已经遵循了HTML5规范。执行上述命令后,在C:/JA VA目录下生成的文档页面,其外观可能看似变化不大,但内在的代码结构已经更新,如下图所示:

    21cb2374a6d4fecf09f090acd235e269.png

    这个改进虽然看似细微,但对于确保生成的文档能在当前及未来的浏览器中稳定、正确地显示,却至关重要。它标志着Ja va工具链正与现代Web标准保持同步。

    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系bd@zhengruan.com
    作者最新文章
    编程开发 Java
    相关文章 更多
    Java单元测试入门:使用JUnit 5编写第一个测试用例
    Java单元测试入门:使用JUnit 5编写第一个测试用例

    面向初学者的JUnit 5实用入门指南。从测试概念、Maven依赖配置,到手把手编写首个单元测试用例及断言验证,助你掌握Java单元测试的核心流程。

    Java变量未初始化报错解析:局部变量与成员变量默认值差异
    Java变量未初始化报错解析:局部变量与成员变量默认值差异

    深入解析Java中局部变量未初始化编译报错与成员变量自动赋予默认值的机制差异,涵盖JVM内存分配、编译期确定性赋值检查与实际排查修复方案。

    Java获取当前时间并格式化输出:DateTimeFormatter与SimpleDateFormat
    Java获取当前时间并格式化输出:DateTimeFormatter与SimpleDateFormat

    详细讲解在Java中获取当前系统时间并进行格式化输出的两种核心方案:基于Java 8全新日期时间API的DateTimeFormatter与传统遗留的SimpleDateFormat,包含完整代码示例、线程安全机制对比及生产选型建议。

    Java中final与static final常量的定义及初始化规则
    Java中final与static final常量的定义及初始化规则

    深入解析Java中final变量与static final常量的定义、内存语义、初始化时机及合法赋值路径,涵盖编译期常量优化与实战避坑指南。

    Java抽象方法与接口方法的区别及选型建议
    Java抽象方法与接口方法的区别及选型建议

    深入对比Java中抽象类抽象方法与接口方法的语法演进、设计意图及运行期差异,并提供清晰的架构选型决策流程与实战范例。

    Java实现HTTP请求与JSON解析的完整代码示例
    Java实现HTTP请求与JSON解析的完整代码示例

    本文提供Java标准库HttpClient发起HTTP GET/POST请求并结合Jackson进行JSON数据反序列化与序列化的完整代码示例与工程实践指南。

    Java递归出现StackOverflowError的原因分析及栈空间优化方案
    Java递归出现StackOverflowError的原因分析及栈空间优化方案

    详细分析Java递归调用出现StackOverflowError的原因,结合代码说明线程栈、栈帧和递归深度之间的关系,并介绍终止条件排查、迭代改写、减少栈帧开销以及通过-Xss调整JVM栈空间的方法。

    Java空指针异常(NPE)的代码排查与修复实例
    Java空指针异常(NPE)的代码排查与修复实例

    针对Java中常见的NullPointerException(NPE),本文从堆栈日志定位、典型代码触发场景、具体修复代码对比到防御体系进行系统讲解,提供实用且易上手的排查与修复方案。

    selenium上传文件教程本地文件路径设置方法
    selenium上传文件教程本地文件路径设置方法

    深入解析Selenium处理文件上传的技术细节,涵盖标准HTML控件的路径直接注入法与非标准控件的系统级模拟方案,提供Windows与Linux环境下的路径设置最佳实践及常见异常排查。

    大数据开发语言选型:Java对比Scala与Python的优缺点及适用场景
    大数据开发语言选型:Java对比Scala与Python的优缺点及适用场景

    针对大数据工程场景,系统对比Java、Scala与Python在执行性能、生态结合、开发效率和维护成本上的核心差异,给出清晰的架构选型依据与落地方案。

    查看更多
    精品专题 更多
    装机必备
    装机必备

    正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

    Windows
    Windows

    正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

    PDF教程
    PDF教程

    正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

    Mac软件 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    Aperty macOS版
    Aperty macOS版
    macOS

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    WINDOWS 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    PixTV 网页版
    PixTV 网页版
    Windows

    PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台,提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具,适合短剧、漫剧、广告及社交媒体内容制作。