如何使用IntelliJ IDEA为自定义类库自动生成JavaDoc注释？
- 内容介绍
- 文章标签
- 相关推荐
本文共计1563个文字，预计阅读时间需要7分钟。
由于项目需求，团队开发了一个XML分析处理器，并将其设计为一个类库，提供相应的API接口。为了方便用户使用，生成了相应的JavaDoc帮助文档，类似于Java的文档风格。
因为某个项目需要，为团队其他兄弟姐妹开发了一个 XML 分析处理器，并将其设计为一个类库，提供相应的 API 接口。为了方便大家的使用，需要生成对应的 JavaDoc 帮助文档，就像 JavaSE 标准库提供的 JavaDoc 那样。我的开发工具为 IntelliJ IDEA 12.1.6，本身提供了很好的 JavaDoc 生成功能，以及标准 JavaDoc 注释转换功能，其实质是在代码编写过程中，按照标准 JavaDoc 的注释要求，为需要暴露给使用者的类、方法以及其他成员编写注释。然后使用 IDEA 的功能自动调用 javadoc.exe（JDK 自带的工具）根据源代码中的注释内容自动生成 JavaDoc 文档（超文本格式）。标准 JavaDoc 的注释规则，大家可以在网上很容易搜索到，这里有几点倒是要特别注意一下：
1.IDEA 的 JavaDoc 生成功能在菜单 Tools->Generate JavaDoc 项里面。
2.点击上述菜单项后，会出现生成 JavaDoc 的对话框，一般的选项都很直观，不必细说。
本文共计1563个文字，预计阅读时间需要7分钟。
由于项目需求，团队开发了一个XML分析处理器，并将其设计为一个类库，提供相应的API接口。为了方便用户使用，生成了相应的JavaDoc帮助文档，类似于Java的文档风格。
因为某个项目需要，为团队其他兄弟姐妹开发了一个 XML 分析处理器，并将其设计为一个类库，提供相应的 API 接口。为了方便大家的使用，需要生成对应的 JavaDoc 帮助文档，就像 JavaSE 标准库提供的 JavaDoc 那样。我的开发工具为 IntelliJ IDEA 12.1.6，本身提供了很好的 JavaDoc 生成功能，以及标准 JavaDoc 注释转换功能，其实质是在代码编写过程中，按照标准 JavaDoc 的注释要求，为需要暴露给使用者的类、方法以及其他成员编写注释。然后使用 IDEA 的功能自动调用 javadoc.exe（JDK 自带的工具）根据源代码中的注释内容自动生成 JavaDoc 文档（超文本格式）。标准 JavaDoc 的注释规则，大家可以在网上很容易搜索到，这里有几点倒是要特别注意一下：
1.IDEA 的 JavaDoc 生成功能在菜单 Tools->Generate JavaDoc 项里面。
2.点击上述菜单项后，会出现生成 JavaDoc 的对话框，一般的选项都很直观，不必细说。