freemarker入门实例与源码研究准备工作

准备工作

首先去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!

输出结果为：
Hello, my name is 张三. I come from 中国-北京. Nice to meet you!
（本文于2015年6月5日修订）