设置注释模板的入口: Window->Preference->Java->Code Style->Code Template 然后展开Comments节点就是所有需设置注释的元素啦。现就每一个元素逐一介绍:
文件(Files)注释标签:
/**
* @Title: ${file_name}
* @Package ${package_name}
* @Description: ${todo}(用一句话描述该文件做什么)
* @author A18ccms A18ccms_gmail_com
* @date ${date} ${time}
* @version V1.0
*/
类型(Types)注释标签(类的注释):
/**
* @ClassName: ${type_name}
* @Description: ${todo}(这里用一句话描述这个类的作用)
* @author A18ccms a18ccms_gmail_com
* @date ${date} ${time}
*
* ${tags}
*/
字段(Fields)注释标签:
/**
* @Fields ${field} : ${todo}(用一句话描述这个变量表示什么)
*/
构造函数标签:
/**
* Title:
* Description:
* ${tags}
*/
方法(Constructor & Methods)标签:
/**
* @Title: ${enclosing_method}
* @Description: ${todo}(这里用一句话描述这个方法的作用)
* @param ${tags} 设定文件
* @return ${return_type} 返回类型
* @throws
*/
覆盖方法(Overriding Methods)标签:
/* (非 Javadoc)
* Title: ${enclosing_method}
* Description:
* ${tags}
* ${see_to_overridden}
*/
代表方法(Delegate Methods)标签:
/**
* ${tags}
* ${see_to_target}
*/
getter方法标签:
/**
* @return ${bare_field_name}
*/
setter方法标签:
/**
* @param ${param} 要设置的 ${bare_field_name}
*/
简单模板例子:
view plaincopy to clipboardprint?
/**
* @Fields ${field} : ${todo}(用一句话描述这个变量表示什么)
*/
/**
* @return ${bare_field_name}
*/
/**
* Title:${file_name}
* Description: 构造函数
* ${tags}
*/
/**
* @Title: ${file_name}
* @Package ${package_name}
* @Description: ${todo}(用一句话描述该文件做什么)
* @author DAIGUANGJIU
* @date ${date} ${time}
* @version V1.0
*/
/**
* @param ${param} 要设置的 ${bare_field_name}
*//**
* @author ${user}
*
* ${tags}
*//**
* ${tags}
* ${see_to_target}
*//** (非 Javadoc)
* Title: ${enclosing_method}
* Description:
* ${tags}
* ${see_to_overridden}
*//**
* ${tags}
*//**
* @Fields ${field} : ${todo}(用一句话描述这个变量表示什么)
*/
/**
* @return ${bare_field_name}
*/
/**
* Title:${file_name}
* Description: 构造函数
* ${tags}
*/
/**
* @Title: ${file_name}
* @Package ${package_name}
* @Description: ${todo}(用一句话描述该文件做什么)
* @author DAIGUANGJIU
* @date ${date} ${time}
* @version V1.0
*/
/**
* @param ${param} 要设置的 ${bare_field_name}
*//**
* @author ${user}
*
* ${tags}
*//**
* ${tags}
* ${see_to_target}
*//** (非 Javadoc)
* Title: ${enclosing_method}
* Description:
* ${tags}
* ${see_to_overridden}
*//**
* ${tags}
*/
例子2:
view plaincopy to clipboardprint?
/**
* 创建一个新的实例 ${enclosing_type}.
*
* ${tags}
*/
/**
* @param ${param} the ${bare_field_name} to set
*/
/**
* 此方法描述的是:
* @author: [email protected]
* @version: ${date} ${time}
*/
/**
* ${tags}
* ${see_to_target}
*/
/**
* 文件名:${file_name}
*
* 版本信息:
* 日期:${date}
* Copyright 足下 Corporation ${year}
* 版权所有
*
*/
/**
* ${bare_field_name}
*
* @return the ${bare_field_name}
* @since CodingExample Ver(编码范例查看) 1.0
*/
/* (non-Javadoc)
* ${see_to_overridden}
*/
/**
* ${field}:${todo}(用一句话描述这个变量表示什么)
*
* @since Ver 1.1
*/
/**
* 此类描述的是:
* @author: [email protected]
* @version: ${date} ${time}
*/
/**
* 创建一个新的实例 ${enclosing_type}.
*
* ${tags}
*/
/**
* @param ${param} the ${bare_field_name} to set
*/
/**
* 此方法描述的是:
* @author: [email protected]
* @version: ${date} ${time}
*/
/**
* ${tags}
* ${see_to_target}
*/
/**
* 文件名:${file_name}
*
* 版本信息:
* 日期:${date}
* Copyright 足下 Corporation ${year}
* 版权所有
*
*/
/**
* ${bare_field_name}
*
* @return the ${bare_field_name}
* @since CodingExample Ver(编码范例查看) 1.0
*/
/* (non-Javadoc)
* ${see_to_overridden}
*/
/**
* ${field}:${todo}(用一句话描述这个变量表示什么)
*
* @since Ver 1.1
*/
/**
* 此类描述的是:
* @author: [email protected]
* @version: ${date} ${time}
*/
-----------------------------------------------------------------------------------
Eclipse中Java开发中版权声明及编码风格的注释
Java项目开发中,常常需要在编码文件上面加上一些版权声明或者类注释,如果文件很多,手工去添加或者修改,会很麻烦。可以利用工具满足我们的要求。
一、版权声明
可以使用Jautodoc。将jautodoc的plugin和feature目录对应copy到eclipse目录中,并且带-clean参数重新启动一次eclipse(以后不再需要该参数)。到eclipse的window-reference菜单中,java- jautodoc,configure project specific settings中,选择add file header,并点【edit】按钮,输入版权信息,保存。
以后要添加版权时,按alt+shift+J,就可以了。
类似的版权信息如下:
/**
*@项目名称: ${project_name}
*@文件名称: ${file_name}
*@Date: ${date}
*@Copyright: ${year} www.xxx.com Inc. All rights reserved.
*注意:本内容仅限于xxx公司内部传阅,禁止外泄以及用于其他的商业目的
*/
其中${project_name},${file_name}和${date}、${year} 是内置的变量,在编辑模板的时候,输入$之后,会有很多类似的变量提示显示出来。
二、类注释,方法注释等
可以直接使用eclipse的code style功能。
类注释在window-reference-java-code style-code templates-comments,选中types,然后点击【edit】按钮,输入类注释信息,保存。
以后要添加版权时,按Ctrl+alt+J(快捷方式可以在Window-preference-general-keys查看和修改),就可以了。
类似的类注释如下:
/**
*@Project: ${project_name}
*@Author: Vin
*@Date: ${date}
*@Copyright: ${year} www.xxx.com Inc. All rights reserved.
*/
同样,这里的${date}也是预定义的变量 。
window-preference-java-code style-code templates-comments,选中types,可以编辑类的注释,
window-preference-java-code style-code templates-comments,选中files,可编辑类文件的注释
window-preference-java-code style-code templates-comments,选中methods,可编辑方法的注释
等等。
在window-preference-java-code style-code templates-code,编辑new class files,加入
${filecomment}
${package_declaration}
${typecomment}
${type_declaration}
可以在新建一个类文件的时候自动加入前面设置的文件注释和类注释。
方法注释的操作与类注释的操作类似。可以自己研究。
最后,要使用这些注释,在window-preference-java-code style,将Automatically add comments for new methods and types选上才可应用到开发中。