android編程實現(xiàn)的自定義注釋模板實例

更新時間：2015年11月02日 11:58:27 作者：年輕的zhangchang

這篇文章主要介紹了android編程實現(xiàn)的自定義注釋模板,以完整實例形式分析了Android自定義魔板的定義及具體實現(xiàn)與使用技巧,需要的朋友可以參考下

本文實例講述了android編程實現(xiàn)的自定義注釋模板。分享給大家供大家參考，具體如下：

作為一名程序員不僅要有一個寫代碼的能力，養(yǎng)成一個良好的編寫習慣也是很重要的。今天給大家詳細介紹一下如何創(chuàng)建注釋模板，給每個類和方法都自己手動去注釋信息也可以，只是這樣比較繁瑣。為何我們不手動去創(chuàng)建一個注釋模板呢？

第一：首先我們需要編寫一個模板的xml文件（codetemplates.xml）

第二、我們現(xiàn)在就給xml文件編寫主要注釋的內(nèi)容信息，我就直接把自己用的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
自定義
模板

 * @創(chuàng)建人：${user}
 * @創(chuàng)建時間：${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}
 * @創(chuàng)建人 ${user}
 * @創(chuàng)建時間 ${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">/**
* &lt;p&gt;Title: &lt;/p&gt;
* &lt;p&gt;Description: &lt;/p&gt;
* $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} 
 * @創(chuàng)建人：${user}
 * @創(chuàng)建時間：${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}
* @創(chuàng)建時間： ${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}
 * @功能描述：
 * @創(chuàng)建人：${user}
 * @創(chuàng)建時間：${date}${time} 
*/</template></templates>

三、我們?nèi)绾卧趀clipse中使用這個編寫好的xml文件呢？現(xiàn)在我就給大家解析一下吧！

Window --> Preferences --> Java --> Code Style --> Code Templates --> Comments --> Import --> 選擇 codetemplates.xml --> OK 添加后可以自己修改郵箱地址。創(chuàng)建人名稱可以在eclipse目錄下的eclipse.ini 中增加一行 -Duser.name="whateveryouwant"。

四、我們在eclipse中如何快速使用我們寫好的注釋模塊信息呢？

添加注釋時在類名上輸入/**然后回車就會自動生成如下格式注釋：

/**
* 
* @類描述：
* @項目名稱：
* @包名： 
* @類名稱：AppDao  
* @創(chuàng)建人：
* @創(chuàng)建時間：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
* @創(chuàng)建人 
* @創(chuàng)建時間 2014-4-30上午10:22:36  
* @修改人 
* @修改時間 2014-4-30上午10:22:36  
* @修改備注 
* @since
* @throws
*/

描述內(nèi)容需要自己手動填寫。

希望本文所述對大家Android程序設計有所幫助。

您可能感興趣的文章: