当前位置: 移动技术网 > 移动技术>移动开发>Android > android编程实现的自定义注释模板实例

android编程实现的自定义注释模板实例

2019年07月24日  | 移动技术网移动技术  | 我要评论

本文实例讲述了android编程实现的自定义注释模板。分享给大家供大家参考,具体如下:

作为一名程序员 不仅要有一个写代码的能力,养成一个良好的编写习惯也是很重要的。今天给大家详细介绍一下如何创建注释模板,给每个类和方法都自己手动去注释信息也可以,只是这样比较繁琐。为何我们不手动去创建一个注释模板呢?

第一: 首先我们需要编写一个模板的xml文件(codetemplates.xml)

第二、我们现在就给xml文件编写主要注释的内容信息,我就直接把自己用的xml信息直接贴出来

<?xml version="1.0" encoding="utf-8" standalone="no"?><templates><template autoinsert="false" context="overridecomment_context" deleted="false" description="comment for overriding methods" enabled="true" id="org.eclipse.jdt.ui.text.codetemplates.overridecomment" name="overridecomment">/**
 * @描述:
 * @方法名: ${enclosing_method}
 * $android
自定义
模板

 * @创建人:${user}
 * @创建时间:${date}${time} 
 * @修改人:${user}
 * @修改时间:${date}${time} 
 * @修改备注:
 * @throws
*/</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">/**
 * @描述:
 * @方法名: ${enclosing_method}
 * $android
自定义
模板

 * @返回类型 ${return_type}
 * @创建人 ${user}
 * @创建时间 ${date}${time} 
 * @修改人 ${user}
 * @修改时间 ${date}${time} 
 * @修改备注 
 * @since
 * @throws
*/</template><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">/**
* <p>title: </p>
* <p>description: </p>
* $android
自定义
模板

*/</template><template autoinsert="false" context="settercomment_context" deleted="false" description="comment for setter method" enabled="true" id="org.eclipse.jdt.ui.text.codetemplates.settercomment" name="settercomment">/**
* @param ${param} ${bare_field_name}
*/</template><template autoinsert="false" context="delegatecomment_context" deleted="false" description="comment for delegate methods" enabled="true" id="org.eclipse.jdt.ui.text.codetemplates.delegatecomment" name="delegatecomment">/**
* $android
自定义
模板

* ${see_to_target}
*/</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">/**
* @return ${bare_field_name}
*/</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">/**
 * @类描述:
 * @项目名称:${project_name}
 * @包名: ${package_name}
 * @类名称:${type_name} 
 * @创建人:${user}
 * @创建时间:${date}${time} 
 * @修改人:${user}
 * @修改时间:${date}${time} 
 * @修改备注:
 * @version v1.0
 * @see [nothing]
 * @bug [nothing]
 * @copyright go3c
 * @mail *@qq.com
*/</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}
* @包名: ${package_name}
* @功能描述:${todo} 
* @作者: ${user}
* @创建时间: ${date} ${time}
* @version v1.0
*/</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}
 * @功能描述:
 * @创建人:${user}
 * @创建时间:${date}${time} 
*/</template></templates>

三、我们如何在eclipse中使用这个编写好的xml文件呢?  现在我就给大家解析一下吧!

window --> preferences --> java --> code style --> code templates --> comments --> import --> 选择             codetemplates.xml --> ok     添加后可以自己修改邮箱地址。创建人名称可以在eclipse目录下的eclipse.ini 中增加一行 -duser.name="whateveryouwant"。

四、我们在eclipse中如何快速使用我们写好的注释模块信息呢?

添加注释时在类名上输入/**然后回车就会自动生成如下格式注释:

/**
* 
* @类描述:
* @项目名称:
* @包名: 
* @类名称:appdao  
* @创建人:
* @创建时间:2014-4-30上午10:32:30  
* @修改人:
* @修改时间:2014-4-30上午10:32:30  
* @修改备注:
* @version v1.0
* @see [nothing]
* @bug [nothing]
* @copyright 
* @mail */

在方法名上输入/**然后回车就会自动生成如下格式注释:

/**
* 
* @描述:
* @方法名: updateplayerhistory
* @param db
* @param item
* @return
* @返回类型 int
* @创建人 
* @创建时间 2014-4-30上午10:22:36  
* @修改人 
* @修改时间 2014-4-30上午10:22:36  
* @修改备注 
* @since
* @throws
*/

描述内容需要自己手动填写。

希望本文所述对大家android程序设计有所帮助。

如对本文有疑问, 点击进行留言回复!!

相关文章:

验证码:
移动技术网