十年匠心定制 · 商业建站与技术教学双线并行 咨询热线:400-886-1026 service@lmnt.cn
ARTICLE DETAIL

资讯详情

深耕网站建设与运营推广的一线实战洞察。

JavaDoc:`@category`

JavaDoc:`@category` category 并非 Java 官方标准 Javadoc 标签而是属于自定义标签或历史提议标签。在早期的 Javadoc 规范讨论中如Proposed Javadoc Tags列表category 曾被列为未来可能实现的标签之一旨在用于对类或方法进行分类标记。然而它从未被纳入 Oracle 官方 JDK 的标准标签集如 param、return、author 等。因此标准的 javadoc 命令工具无法直接识别并处理该标签若在文档中使用通常需要配合自定义 Doclet 或在特定 IDE如 Eclipse中配置模板才能生效。主要特点与现状- 非标准支持官方 Javadoc 工具默认忽略该标签不会将其渲染到生成的 HTML 文档中除非开发者编写了自定义的 Doclet 来处理它。- IDE 模板使用部分开发团队会在 Eclipse 或 IntelliJ IDEA 的代码模板中配置 category用于内部代码管理或文档分类例如标记 TODO 状态或模块归属 。- 替代方案若需实现分类功能建议使用标准标签 see 链接到分类文档或使用 Java 9 引入的标准 index 标签来增强搜索分类能力 。
返回列表