在使用Eclipse 编写Java代码时,自动生成的注释信息都是按照预先设置好的格式生成的。

修改作者、日期注释格式:打开Windows->Preferences->Java->Code Style->Code Templates,点击右边窗口中的Comments,可以看到有很多选项,我们便可对此注释信息模板进行编辑。

如我们希望在一个Java文件的开头设置作者信息、日期信息。

选择Types,点击Edit,将

/**

* @author ${user}

* ${tags}

*/

将${user}删除,改成你希望显示的名字;将${tags}删除,点击Insert Variable,选择Date,这样就会自动生成日期信息。在你需要添加注释的地方点击Sources->Ganarate Element Comment,或者使用快捷键 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}

*/

环境说明:
WindowsXP sp3
Eclipse3.6 Helios Release

一、.java 文件部分
———————

eclipse–>windows–>preferences–>Java–>Code Style–>Code Templates–>Code–>New Java files–>单击[edit]按钮

在文件首行,添加如下内容:

Java代码

${filecomment}   

${package_declaration}   

/**  

* 创建时间:${date} ${time}  

* 项目名称:${project_name}  

* @author daniel  

* @version 1.0   

* @since JDK 1.6.0_21  

* 文件名称:${file_name}  

* 类说明:  

*/  

${typecomment}   

${type_declaration}  

${filecomment}

${package_declaration}

/**

* 创建时间:${date} ${time}

* 项目名称:${project_name}

* @author daniel

* @version 1.0

* @since JDK 1.6.0_21

* 文件名称:${file_name}

* 类说明:

*/

${typecomment}

${type_declaration}

或者

Java代码

${filecomment}   

${package_declaration}   

/**   

* Filename:    ${file_name}   

* Copyright:   Copyright (c)2010  

* Company:     com  

* @version:    1.0   

* @since:  JDK 1.6.0_21  

* Create at:   ${date} ${time}   

* Description:  

*   

* Modification History:   

* Date    Author      Version     Description   

* —————————————————————– 

* ${date} daniel      1.0     1.0 Version   

*/     

${typecomment}   

${type_declaration}  

${filecomment}

${package_declaration}

/**

* Filename:    ${file_name}

* Copyright:   Copyright (c)2010

* Company:     com

* @version:    1.0

* @since:       JDK 1.6.0_21

* Create at:   ${date} ${time}

* Description:

*

* Modification History:

* Date     Author           Version           Description

* ——————————————————————

* ${date}       daniel             1.0          1.0 Version

*/ 

${typecomment}

${type_declaration}

二、.jsp 文件部分
———————

eclipse–>windows–>preferences–>Web–>JSP Files–>Editer–>Templates–>New JSP File–>单击[edit]按钮

在文件首行,添加如下内容:

Java代码

<%–    

创建时间:${date}${time}   

创 建 人:daniel   

相关说明:   

JDK1.6.0_21 tomcat6.0.29 servlet2.5    

–%>  

<%–

创建时间:${date}${time}

创 建 人:daniel

相关说明:

JDK1.6.0_21 tomcat6.0.29 servlet2.5

–%>

这样再创建 .java 或 .jsp 文件时,eclipse 就会为我们自动将注释写好。你还可以通过“导出”、“导入”功能,把自己的模板导出来,方便在其他机器上使用。

版权声明:本文为anpajin原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接和本声明。
本文链接:https://www.cnblogs.com/anpajin/p/6376722.html