Eclipse中用于CodeTemplate的变量总结

今天研究了一下Eclipse中用于CodeTemplate功能的变量。

在Window→Preferences菜单里，找到Java语言的CodeTemplates界面。

CodeTemplates分为Comments和Code两类，选中一条后点击Edit按钮能够编辑这个模版。

在这里能够看到【InsertVariable】按钮。在这里列出了CodeTemplate中可使用到的变量。

在Java中的对应位置，输入/**三个字符，再按下回车键，就能够自动生成CodeTemplate中指定的模式了。

下面是对其中变量的逐一说明：

CodeTemplate中的变量，都用美圆符号后面的花括号围住，如${date}、${time}等，若是要在CodeTemplate中要写美圆符号$，则用两个美圆符号连写表示。

下面逐一解释一下这些变量的含义：

一、${year}，表明当前年份，例如：2015

二、${date}，表明当前日期，例如：2015年11月29日

三、${time}，表明当前时间，例如：下午10:07:15

四、${project_name}，表明项目名，若是项目如上图所示，则该变量值为：VariableTest

五、${package_name}，表明包名，若是项目如上图所示，则该变量值为：varTest

六、${file_name}，表明当前文件名，若是项目如上图所示，则该变量值为：VarTest.java

七、${type_name}，表明当前类名，例如：VarTest

八、${enclosing_type}，若是类A是在另外一个类B内部声明的，则该变量记录了类B的名字，不然为空，代码举例以下：

/**
 * @enclosing_type
 */
public class VarTest {
    /**
     * @enclosing_type VarTest
     */
    public class VarTest2 {
        /**
         * @enclosing_type VarTest.VarTest2
         */
        public class VarTest3 {
            
        }
    }
}

九、${tags}，输出函数的输入参数与返回值，例若有函数声明以下：

public int func(int a, String b, long c, boolean d) {
    return 0;
}

CodeTemplate的Pattern以下：

/**
 * ${tags}
 */

则生成的注释以下：

/**
 * 
 * @param a
 * @param b
 * @param c
 * @param d
 * @return
 */

十、${todo}，有这个变量的位置，会生成一个TODO标签

十一、${user}，这个变量存储了当前Eclipse的用户名，这个用户名能够在eclipse.ini中设置。

在最后添加一行

-Duser.name=Tsybius2014

其中Tsybius2014能够换成任意本身但愿取的名字，修改位置以下图所示：

以类为例，将Comment下的Type的Pattern设置成这样

/**
 * @author ${user}
 * @date ${date}
 * @time ${time}
 * @remark
 *
 * ${tags}
 */

这样输出的注释就会是：

/**
 * 
 * @author Tsybius2014
 * @date 2015年11月29日
 * @time 下午10:40:35
 * @remark
 *
 */
public class VarTest {
    // ...
}

其中 @ author 后面的文字，就是咱们刚才设定的内容

END