JAutodoc是一个Eclipse 插件,用于自动将Javadoc和文件头添加到源代码中。它可以通过使用 Javadoc的Velocity 模板和文件头来选择性地从元素名称生成初始注释 。
特征
JAutodoc具有以下功能:

 

java 插件 check style javadoc插件_搜索

模式

完整现有的Javadoc 


现有的Javadoc将不会被触及。只有缺失的标签将被添加,并且迄今未记录的元素将被记录。


保持现有的Javadoc 


现有的Javadoc不会被触及。缺少标签将不会被添加,但是迄今未记录的元素将被记录。


替换现有的Javadoc 


现有的Javadoc将完全由生成的Javadoc替代。请确定,如果你使用这个选项。


能见度


公开,保护,包装或私人 


决定您想要创建Javadoc的可见性。


过滤


仅评论类型,字段,方法或Getter / Setter 


决定您想要创建Javadoc的成员类型。


选项


为自动生成的Javadoc 


添加待办事项标志添加待办事项以便使用自动生成的Javadoc查找所有来源。这只对源文件完成一次。


java 插件 check style javadoc插件_源文件_02


从元素名称创建注释 


选中此选项JAutodoc将从元素名称生成注释,如下所示。 可以使用模板来定义如何创建这些评论。此外, 可以定义字段,方法和参数快捷方式替换。 



领域:



java 插件 check style javadoc插件_字段_03


方法:



java 插件 check style javadoc插件_搜索_04


单行字段注释 


用于创建单行字段注释的选项。


java 插件 check style javadoc插件_字段_05


使用Eclipse注释格式化程序 


使用Eclipse内部格式化程序来格式化生成的注释。格式可以根据偏好进行定义


java 插件 check style javadoc插件_搜索_06



[G,S] etter from field comment 


创建来自相关字段评论的Getter / Setter注释。


仅限第一句只 


使用第一句或完整的字段评论。


替换现有的[G,S] etter 


替换或保留现有的[G,S] etter注释。


包含子 


包在为包成员添加Javadoc时包含子包。


标签顺序


配置Javadoc标签顺序。


java 插件 check style javadoc插件_源文件_07

文件标题

添加/替换文件标题 


如果不存在标题,您可以指定将添加到源文件的文件标题。可选地,现有标题可以被替换。通过选中多注释标题选项,可以替换源头的多个注释。


在标题文本内部,可以使用速度模板语言(VTL)和预定义的 变量。


java 插件 check style javadoc插件_java 插件 check style_08


注意: 为了在标题模板中使用美元符号(例如,像$ id $这样的SVN / CVS属性),你必须用反斜线(\ $)来隐藏这些符号。


包Javadoc


编辑模板 


您可以指定package.htmlor 的初始内容package-info.java,可以通过Package Explorer中包节点的上下文菜单添加。



java 插件 check style javadoc插件_源文件_09


与标题一样,速度模板语言(VTL)和预定义的 变量可以在模板中使用。



使用package-info.java 


使用package-info.java的,而不是package.html


更换


从元素名称创建注释时,字段,方法和参数中的快捷键可以被另一个文本替换。例如“set”将被替换为“Sets”或“db”可以扩展为“Database”。


这些替换可以通过首选项添加,删除或更改。替换的范围可以是“字段”,“方法”或“两者”。字段和参数使用“字段”。可选地,只能替换快捷方式的前缀(前缀)或每次出现(全部)。



注意: 快捷方式不区分大小写。它们通过元素名称中的大写和小写字母之间的变化(例如setDbName)进行检测。


导入/导出全部...


将完整配置从/导入/导出到单个文件。


java 插件 check style javadoc插件_搜索_10


清理文件标题并保存操作


在清理或每次保存Java编辑器时添加/替换文件头。



java 插件 check style javadoc插件_源文件_11


java 插件 check style javadoc插件_搜索_12


java 插件 check style javadoc插件_字段_13


用法


对于在编辑器中打开的源文件,Javadoc可以添加所有或仅用于选定的成员。在这种情况下,修改后的源文件将不会自动保存到磁盘。 


java 插件 check style javadoc插件_源文件_14


如果游标位于字段或方法的声明中,则仅记录此元素。创建类型注释点到类型的名称。否则,当前源文件的所有成员都将被记录。


使用“...”选择菜单将打开一个选项对话框 ,在该对话框中可以取消当前的项目/工作区设置。这些设置仅对当前编译单元有效,且仅对此Eclipse会话有效。



java 插件 check style javadoc插件_java 插件 check style_15

在包资源管理器中,您可以选择一个或多个源文件以添加Javadoc。或者,您可以选择一个软件包并为所有软件包成员添加Javadoc,或者您可以为完整的项目执行此操作。 



警告: 编辑器中未打开的源文件将直接保存到磁盘。


在编辑器中使用选项对话框时,可以看到所有更改的 预览。


java 插件 check style javadoc插件_源文件_16


任务搜索


JAutodoc允许搜索像缺少Javadoc,文件头或特殊标签的任务。


java 插件 check style javadoc插件_字段_17


大多数选项都是自我解释。剩下的是:


生成的Javadoc 


搜索与JAutodoc生成的完全匹配的Javadoc评论。


过时的文件头 


搜索与JAutodoc生成的文件头不匹配的文件头。


搜索缺少的标签 


搜索像@author这样的缺失标签。如果没有消息的现有标签不应该被报告,或者加号,如果只有没有消息的现有标签应该被报告(例如@不需要描述),则向标签名称添加减号。



下载和安装


在此处下载JAutodoc 并将文件解压缩到Eclipse目录或使用更新站点