Eclipse Java注释模板设置详解

简介:

原文:http://blog.csdn.net/ahhsxy/article/details/4542682

设置注释模板的入口: 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}(用一句话描述这个变量表示什么)
*/
构造函数标签:

/**
* <p>Title: </p>
* <p>Description: </p>
* ${tags}
*/


方法(Constructor & Methods)标签:

/**
* @Title: ${enclosing_method}
* @Description: ${todo}(这里用一句话描述这个方法的作用)
* @param ${tags}    设定文件
* @return ${return_type}    返回类型
* @throws
*/


覆盖方法(Overriding Methods)标签:

/* (非 Javadoc)
* <p>Title: ${enclosing_method}</p>
* <p>Description: </p>
* ${tags}
* ${see_to_overridden}
*/


代表方法(Delegate Methods)标签:

/**
* ${tags}
* ${see_to_target}
*/
getter方法标签:

/**
* @return ${bare_field_name}
*/

setter方法标签:

/**
* @param ${param} 要设置的 ${bare_field_name}
*/

 

简单模板例子:

<?xml version="1.0" encoding="UTF-8"?><templates><template autoinsert="true" context="fieldcomment_context" deleted="false" description="字段的注释" enabled="true" id="org.eclipse.jdt.ui.text.codetemplates.fieldcomment" name="fieldcomment">/**
* @Fields ${field} : ${todo}(用一句话描述这个变量表示什么)
*/
</template><template autoinsert="true" context="gettercomment_context" deleted="false" description="getter 方法的注释" enabled="true" id="org.eclipse.jdt.ui.text.codetemplates.gettercomment" name="gettercomment">/**
 * @return ${bare_field_name}
 */
 </template><template autoinsert="true" context="constructorcomment_context" deleted="false" description="创建的构造函数的注释" enabled="true" id="org.eclipse.jdt.ui.text.codetemplates.constructorcomment" name="constructorcomment">/**
* <p>Title:${file_name} </p>
* <p>Description: 构造函数</p>
* ${tags}
*/
</template><template autoinsert="true" context="filecomment_context" deleted="false" description="已创建的 Java 文件的注释" enabled="true" id="org.eclipse.jdt.ui.text.codetemplates.filecomment" name="filecomment">/**  
* @Title: ${file_name}
* @Package ${package_name}
* @Description: ${todo}(用一句话描述该文件做什么)
* @author DAIGUANGJIU   
* @date ${date} ${time}
* @version V1.0  
*/
 </template><template autoinsert="true" context="settercomment_context" deleted="false" description="setter 方法的注释" enabled="true" id="org.eclipse.jdt.ui.text.codetemplates.settercomment" name="settercomment">/**
 * @param ${param} 要设置的 ${bare_field_name}
 */</template><template autoinsert="true" context="typecomment_context" deleted="false" description="创建的类型的注释" enabled="true" id="org.eclipse.jdt.ui.text.codetemplates.typecomment" name="typecomment">/**
 * @author ${user}
 *
 * ${tags}
 */</template><template autoinsert="true" context="delegatecomment_context" deleted="false" description="代表方法的注释" enabled="true" id="org.eclipse.jdt.ui.text.codetemplates.delegatecomment" name="delegatecomment">/**
* ${tags}
* ${see_to_target}
*/</template><template autoinsert="true" context="overridecomment_context" deleted="false" description="覆盖方法的注释" enabled="true" id="org.eclipse.jdt.ui.text.codetemplates.overridecomment" name="overridecomment">/** (非 Javadoc)
* <p>Title: ${enclosing_method}</p>
* <p>Description: </p>
* ${tags}
* ${see_to_overridden}
*/</template><template autoinsert="true" context="methodcomment_context" deleted="false" description="非覆盖方法的注释" enabled="true" id="org.eclipse.jdt.ui.text.codetemplates.methodcomment" name="methodcomment">/**
 * ${tags}
 */</template></templa

例子2:

<?xml version="1.0" encoding="UTF-8"?>
<templates>
	
	<template 
				autoinsert="false" 
			  	context="constructorcomment_context" 
				deleted="false" 
				description="Comment for created constructors" 
				enabled="true" 
				id="org.eclipse.jdt.ui.text.codetemplates.constructorcomment"
				name="constructorcomment">
	/**
	 * 创建一个新的实例 ${enclosing_type}.
	 *
	 * ${tags}
	 */
	</template>
	
	<template 
				autoinsert="true" 
				context="settercomment_context"
				deleted="false" 
				description="Comment for setter method" 
				enabled="true" 
				id="org.eclipse.jdt.ui.text.codetemplates.settercomment" 
				name="settercomment">
	/**
	 * @param ${param} the ${bare_field_name} to set
	 */
	</template>
	
	
	<template
				autoinsert="false" 
				context="methodcomment_context" 
				deleted="false" 
				description="Comment for non-overriding methods" 
				enabled="true" 
				id="org.eclipse.jdt.ui.text.codetemplates.methodcomment" 
				name="methodcomment">
	/**
	 * 此方法描述的是:
	 * @author: wangxiongdx@163.com
	 * @version: ${date} ${time}
	 */
	</template>
	
	
	<template 
				autoinsert="true" 
				context="delegatecomment_context" 
				deleted="false" 
				description="Comment for delegate methods" 
				enabled="true" 
				id="org.eclipse.jdt.ui.text.codetemplates.delegatecomment" 
				name="delegatecomment">
	/**
	 * ${tags}
	 * ${see_to_target}
	 */
	</template>
	
	
	<template
				autoinsert="false" 
				context="filecomment_context" 
				deleted="false" 
				description="Comment for created Java files" 
				enabled="true" 
				id="org.eclipse.jdt.ui.text.codetemplates.filecomment" 
				name="filecomment">
	/**
	 * 文件名:${file_name}
	 *
	 * 版本信息:
	 * 日期:${date}
	 * Copyright 足下 Corporation ${year} 
	 * 版权所有
	 *
	 */
	</template>
	
	
	<template 
				autoinsert="false" 
				context="gettercomment_context" 
				deleted="false" 
				description="Comment for getter method" 
				enabled="true" 
				id="org.eclipse.jdt.ui.text.codetemplates.gettercomment" 
				name="gettercomment">
	/**
	 * ${bare_field_name}
	 *
	 * @return  the ${bare_field_name}
	 * @since   CodingExample Ver(编码范例查看) 1.0
	*/
	</template>

	<template 
				autoinsert="true" 
				context="overridecomment_context" 
				deleted="false" 
				description="Comment for overriding methods" 
				enabled="true" 
				id="org.eclipse.jdt.ui.text.codetemplates.overridecomment" 
				name="overridecomment">
	/* (non-Javadoc)
	 * ${see_to_overridden}
	 */
	</template>
	
	
	<template 
				autoinsert="false" 
				context="fieldcomment_context" 
				deleted="false" 
				description="Comment for fields" 
				enabled="true" 
				id="org.eclipse.jdt.ui.text.codetemplates.fieldcomment" 
				name="fieldcomment">
	/**
	 * ${field}:${todo}(用一句话描述这个变量表示什么)
	 *
	 * @since Ver 1.1
	 */
	</template>
	
	
	<template 
				autoinsert="false" 
				context="typecomment_context" 
				deleted="false" 
				description="Comment for created types" 
				enabled="true" 
				id="org.eclipse.jdt.ui.text.codetemplates.typecomment" 
				name="typecomment">
	/**
	 * 此类描述的是:
	 * @author: wangxiongdx@163.com
	 * @version: ${date} ${time} 
	 */
	</template>
 
 </templates>


相关文章
|
17天前
|
缓存 Java Spring
Java本地高性能缓存实践问题之Caffeine中设置刷新机制的问题如何解决
Java本地高性能缓存实践问题之Caffeine中设置刷新机制的问题如何解决
|
17天前
|
缓存 Java
Java本地高性能缓存实践问题之Caffeine缓存库中基于时间设置驱逐策略的问题如何解决
Java本地高性能缓存实践问题之Caffeine缓存库中基于时间设置驱逐策略的问题如何解决
|
8天前
|
Java C# 容器
逻辑运算符Java代码的注释
这段代码及文字介绍了一个简单的Java程序以及Java编程的基础概念。代码展示了如何输出“Hello Word”。接着,用贴近生活的比喻解释了`package`(包)、`public`(访问修饰符)、`class`(类)、`static`(静态)和`void`(空)的概念。此外,还介绍了`System.out.println()`方法。进一步讲解了Java中的注释、数据类型(包括整型、浮点型、字符型和布尔型),变量和常量的概念,以及运算符、类型转换、赋值运算符、关系运算符与逻辑运算符等基础知识点。通过生动的例子帮助初学者更好地理解和记忆。
15 2
|
17天前
|
Java
【Java 第三篇章】注释、数据类型、运算符
【8月更文挑战第2天】 Java支持三种注释:单行(`//`)、多行(`/*...*/`)及文档注释(`/**...*/`)。它定义了八种基本数据类型,包括四种整数类型(`byte`、`short`、`int`、`long`),两种浮点类型(`float`、`double`),一种字符类型(`char`)和一种布尔类型(`boolean`)。数据类型之间可以自动转换或通过强制转换改变,但后者可能导致精度损失。Java中的运算符涵盖算术(如`+`、`-`)、赋值(如`=`)、比较(如`==`)、逻辑(如`&&`)和三目运算符等。例如,算术运算可用于执行基本数学计算,而逻辑运算符用于组合条件判断。
10 1
|
17天前
|
Java
Java系列之 IDEA 为类 和 方法设置注解模板
这篇文章介绍了如何在IntelliJ IDEA中为类和方法设置注解模板,包括类模板的创建和应用,以及两种不同的方法注解模板的创建过程和实际效果展示,旨在提高代码的可读性和维护性。
|
13天前
|
JSON Java API
【Azure API 管理】通过Java APIM SDK创建一个新的API,如何为Reqeust的Representation设置一个内容示例(Sample)?
【Azure API 管理】通过Java APIM SDK创建一个新的API,如何为Reqeust的Representation设置一个内容示例(Sample)?
|
13天前
|
缓存 前端开发 Java
【Azure 应用服务】App Service 使用Tomcat运行Java应用,如何设置前端网页缓存的相应参数呢(-Xms512m -Xmx1204m)?
【Azure 应用服务】App Service 使用Tomcat运行Java应用,如何设置前端网页缓存的相应参数呢(-Xms512m -Xmx1204m)?
|
14天前
|
固态存储 Java 网络安全
【Azure Developer】使用Java SDK代码创建Azure VM (包含设置NSG,及添加数据磁盘SSD)
【Azure Developer】使用Java SDK代码创建Azure VM (包含设置NSG,及添加数据磁盘SSD)
|
4月前
|
Java
【Java探索之旅】我与Java的初相识(完):注释,标识符,关键字
【Java探索之旅】我与Java的初相识(完):注释,标识符,关键字
27 0
|
Java 数据安全/隐私保护 C++
Java - 注释、标识符、关键字
Java - 注释、标识符、关键字
104 0
Java - 注释、标识符、关键字

推荐镜像

更多
下一篇
DDNS