86、Java编程知识综合解析

Java编程知识综合解析

1. Javadoc搜索与使用

在使用Javadoc搜索时，可通过上下箭头键浏览搜索结果。查看搜索结果详情有两种方式：一是点击搜索结果打开该主题的Javadoc；二是用上下箭头高亮搜索结果后，按回车键打开主题详情。

若不想在生成的Javadoc中显示搜索框，可在使用javadoc工具时添加 -noindex 选项。Javadoc搜索是通过客户端JavaScript在本地执行的，服务器端未实现计算或搜索逻辑，若浏览器禁用了JavaScript，则无法使用该搜索功能。

1.1 Javadoc标签

Java允许在源代码中编写用于生成文档的注释，以 /* 开头，以 / 结尾。javadoc工具包含在JDK中，用于从源代码中提取并生成文档注释，生成的文档为HTML格式，支持许多有特殊含义的自定义标签，也允许在文档中使用HTML标签。

文档注释中的标签分为块标签和内联标签。块标签以 @ 字符开头，后跟标签名和标签文本，必须出现在文档注释行的开头；内联标签用花括号括起来，可出现在文档注释中文本能出现的任何位置。

JDK 9引入了新的Javadoc标签，如 @hidden、@provides、@uses 和 {@index}。@hidden 标签可在生成的Javadoc中隐藏程序元素；@provides 和 @uses 标签仅用于模块声明，记录模块提供和使用的服务；{@index} 标签用于指定Javadoc中可搜索的关键字。

1.2 Javadoc搜索操作流程

graph LR