首先去freemarker官网下载源码jar包,本文是基于freemarker-2.3.21.tar.gz进行研究的。解压源码包,找到freemarker的源码部分导入eclipse工程中。需要注意的是:freemarker的ftl文件解析使用javacc实现的,所以源码中没有解析类(FMParse.java)。要想研究freemarker源码,往往还需要引入freemarker.jar(含有FMParse.class),否则源码会出现编译问题。
另外,还需要引入的jar包有:commons-logging.jar,log4j.jar,servlet-api.jar。最后设置一下日志的输出,方便我们查看底层运行情况。log4j.properties文件的内容如下所示:
log4j.rootLogger=DEBUG,A1,A2
#指定log输出目的,这里设为输出日志到指定目录的文件my.log中
log4j.appender.A1=org.apache.log4j.FileAppender
log4j.appender.A1.File=logs/my.log
#指定日志信息的格式
log4j.appender.A1.layout=org.apache.log4j.PatternLayout
log4j.appender.A1.layout.ConversionPattern=%c[%d]-%m%n
#把A2输出到控制台
log4j.appender.A2=org.apache.log4j.ConsoleAppender
log4j.appender.A2.layout=org.apache.log4j.PatternLayout
log4j.appender.A2.layout.ConversionPattern=[%c][%d][%p]-%m%n
入门实例
首先在项目中建立存放模板的文件夹templates,然后放入模板文件person.ftl,内容如下:
Hello, my name is ${name}. I come from ${address}. Nice to meet you!
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
public class Test { public static void main(String[] args) throws IOException, TemplateException { Version version = new Version(2, 3, 1); Configuration cfg = new Configuration(version); cfg.setDirectoryForTemplateLoading(new File("templates")); cfg.setObjectWrapper(new DefaultObjectWrapper(version)); Template temp = cfg.getTemplate("person.ftl"); Map root = new HashMap(); root.put("name", "张三"); root.put("address", "中国-北京"); Writer out = new OutputStreamWriter(System.out); temp.process(root, out); out.flush(); } } |
输出结果为:
Hello, my name is 张三. I come from 中国-北京. Nice to meet you!