在使用Eclipse 编写Java代码时,自动生成的注释信息都是按照预先设置好的格式生成的,例如其中author 的属性值。
我们可以在Eclipse 中进行设置自己希望显示的信息。
现在看看如何修改我们的用户名即作者信息:点击Windows->Preferences->Java->Code Style->Code Templates,
然后我们就可以选择右边窗口中的Comments,对应具体的comments选项,我们便可以对具体的注释信息进行编辑设置。
例如我们希望在一个Java文件的开头设置作者作者信息以及日期信息。
选择Types,点击Edit,将
/** * @author ${user} * ${tags} */
将${user}删除,改成Nemo Meng,这样作者信息就变成Nemo Meng;点击Insert Variable,选择Date,这样就会自动生成日期信息。
设置完以后我们测试一下,自动生成的注释信息为:
/**
* @author Nemo Meng
* 2016-12-28
*/
同样的步骤,我们也可以对其他例如构造函数等等注释信息进行编辑设置。
使用时鼠标放置在需要添加注释的方法内部的任意位置。点击菜单栏 中【源代码】下的【添加 Javadoc 注释】,或者使用快捷键 Alt Shift J ,则 eclipse 自动在该方法前面添加注释。
注释的规范如下:
文件注释标签:
/*** <p>Title: ${file_name}</p>* <p>Description: </p>* <p>Copyright: Copyright (c) 2007</p>* <p>Company: LTGames</p>* @author linrz* @date ${date}* @version 1.0*/
类型注释标签(类的注释):
/*** <p>Title: ${type_name}</p>* <p>Description: </p>* <p>Company: LTGames</p>* @author linrz* @date ${date}*/
字段注释标签:
/** ${field}*/
构造函数标签:
/*** <p>Title: </p>* <p>Description: </p>* ${tags}*/
方法标签:
/*** <p>Title: ${enclosing_method}</p>* <p>Description: </p>* ${tags}*/
覆盖方法标签:
/* (非 Javadoc)* <p>Title: ${enclosing_method}</p>* <p>Description: </p>* ${tags}* ${see_to_overridden}*/
代表方法标签:
/*** ${tags}* ${see_to_target}*/
getter方法标签:
/*** @return ${bare_field_name}*/
setter方法标签:
/*** @param ${param} 要设置的 ${bare_field_name}*/