zoukankan      html  css  js  c++  java
  • Eclipse Java注释模板设置详解

    设置注释模板的入口: 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  
    <?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>  
    <?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>

    本文来自CSDN博客,转载请标明出处:http://blog.csdn.net/ahhsxy/archive/2009/09/11/4542682.aspx

  • 相关阅读:
    Nginx支持WebSocket反向代理-学习小结
    CentOS6.9下升级默认的OpenSSH操作记录(升级到OpenSSH_7.6p1)
    CentOS 6下gcc升级的操作记录(由默认的4.4.7升级到6.4.0版本)
    Docker容器内部端口映射到外部宿主机端口
    Linux下分布式系统以及CAP理论分析
    C/ C++ 快速上手
    YUV视频格式详解(翻译自微软文档)
    YUV详解
    阿里云ECS使用vnc远程连接(Ubuntu + CentOS)
    oh-my-zsh: 让终端飞
  • 原文地址:https://www.cnblogs.com/wy2325/p/4668576.html
Copyright © 2011-2022 走看看