为Eclipse定制你自己的注释模板变量

文章转自：http://shareal.blog.163.com/blog/static/27659056201193063914196/

Copyright ＠ 原创版权所有，免费引用请注明出处。

Eclipse的代码注释模板很丰富，如：user、year、date、time等等，请参考附件。
尽管模板变量如此之多，但是对于复杂多边的实际项目而言，还是不够用，怎么办？自己增加新的呗！
Eclipse配置界面都不支持定制自己的注释模板变量，没办法，改Eclipse源码，
具体怎么改，好像无头苍蝇，百度和谷歌了2天，还是无果，在边搜边摸索的过程中才知道需要修改如下两个架包对应的源码，
org.eclipse.jdt.ui.jar
org.eclipse.text.jar
发现了三个重要的文件：
org.eclipse.jface.text.template.TextTemplateMessageg.properties
org.eclipse.jface.text.templates.GlobalTemplateVariables.java
org.eclipse.jdt.internal.corext.template.java.CodeTemplateContextType.java

1、TextTemplateMessageg.properties里面定义了一些全局模板：

# global variables
GlobalVariables.variable.description.cursor=The cursor position after editing template variables
GlobalVariables.variable.description.dollar=The dollar symbol
GlobalVariables.variable.description.date=Current date
GlobalVariables.variable.description.year=Current year
GlobalVariables.variable.description.time=Current time
GlobalVariables.variable.description.user=User name
GlobalVariables.variable.description.selectedWord= The selected word
GlobalVariables.variable.description.selectedLines= The selected lines
我们可以看到user、year、date、time都在里面。
如果要增加自己的模板变量，就加吧？例如：
GlobalVariables.variable.description.copyright=Copyright all resolved

2、全局模板变量在GlobalTemplateVariables里面，均继承自SimpleTemplateVariableResolver
   增加一个对应GlobalVariables.variable.description.copyright的模板变量
    /**
     * The copyright variable evaluates to the current copyright.
     * Added by 博主 2011-10-30
      */
    public static class Copyright extends SimpleTemplateVariableResolver
    {
        /**
         * 默认从环境变量中取copyright信息，环境变量可以定义在eclipse.ini的vmargs下面
         */
        private static String value = System.getProperty("copyright");
        /**
         * Creates a new copyright variable
         */
        public Copyright()
        {
            super("copyright", TextTemplateMessages.getString("GlobalVariables.variable.description.copyright")); //$NON-NLS-1$ //$NON-NLS-2$
        }

        /**
         * {@inheritDoc}
         */
        protected String resolve(TemplateContext context)
        {
            if (value != null)
            {
                return TextTemplateMessages.getString("GlobalVariables.variable.description.copyright");
            }
            return value; //$NON-NLS-1$
        }
    }

3、让Eclipse的Reference界面配置code template是支持${copyright}
    修改：CodeTemplateContextType，在其构造方法里面增加Copyright实例

    public CodeTemplateContextType(String contextName) {
        super(contextName);

        fIsComment= false;

        // global
        addResolver(new GlobalTemplateVariables.Dollar());
        addResolver(new GlobalTemplateVariables.Date());
        addResolver(new GlobalTemplateVariables.Year());
        addResolver(new GlobalTemplateVariables.Time());
        addResolver(new GlobalTemplateVariables.User());
        //   Added by 博主 2011-10-30
       addResolver(new GlobalTemplateVariables.Copyright());

4、将修改的内容加到 org.eclipse.jdt.ui.jar和org.eclipse.text.jar这两个包中
    先退出Eclipse，再使用BeyondCompare之类的比较工具，将修改编译好的calss文件和properties文件覆盖到原有包中，不过如果你动jar的命令行操作，也可以使用jar命令打包。
    好了，现在重新启动Eclipse，赶紧到windows-preferences->java-code style->code template界面去体验一下：
     
    新建一个java类，在类名上方按Ctrl+Alt+j就可以出现自己的copyright注释了。

想想很简单。

附录：Eclipse针对java代码模板的内置变量
cursor 将编辑器的光标放在这个位置。 N/A 

date 插入当前日期。

dollar 插入货币的文字符号。 $ 

elemType 尝试猜测具有给定 ID 的这个元素的类型。 MyType 

enclosing_method 插入模板被插入其中的那个方法的名称。 method() 

enclosing_method_arguments 为包围方法插入参数。 arg1, arg2 

enclosing_package 插入当前类的包名。 com.example.ui 

enclosing_project 插入包含所编辑的这个类的项目的名称。 myProject 

enclosing_type 插入正在编辑的类型（类）的名称。 MyType 

exception_variable_name 插入一个异常变量名称，进行最佳猜测。 e, ioe 

file 文件的简称。 MyType.java 

import 如果尚未导入，那么针对给定类型插入一个导入声明。 import com.example.ui.MyOtherType 

importStatic 与 import 相同，只不过是静态导入。 import static com.example.ui.MyOtherType.* 

line_selection 将选中的行插入到这里。这对用模板包装行是很有用的。 以选中行作为主体的 do、while 循环 

primary_type_name 没有扩展名的文件简称。 MyType 

time 插入当前的时间。

todo 注释中的 TODO 标记。 TODO 

user 当前用户的名字。 ngood 

var 解析为本地变量，如果不只一个，就提供一个列表。 myvar 

word_selection 插入当前选中的单词。 N/A 

year 将现在的年份插入到代码中。 2010