ftl编辑器(freemarker)的使用和说明.doc

一、准备工作 1.1 下载文件 可以从/站点下载最新的freemarker.jar包（目前最新版本是2.3.18）与eclipse插件（最新版本是0.9.14）。 1.2 安装eclipse插件 将下载来的eclipse插件解压缩到本地磁盘，更改hudson.freemarker_ide_0.9.14文件夹中的freemarker-2.3.6.jar文件更改成最新版本的freemarker-2.3.18.jar，并且将META-INF/MANIFEST.MF文件中的Bundle-ClassPath属性值修改为freemarker-2.3.18.jar。最后将hudson.freemarker_ide_0.9.14放到eclipse的plugins目录中，完成eclipse插件的安装。 1.3 freemarker文档下载 从/ 二、freemarker的使用 2.1 简介 2.1.1 FTL tag标签 由于freemarker tag标签是属于freemarker的指令，它们仅仅是freemarker处理过程中的信息，而不会输出到页面上，所以它们与html标签有一些区别。这些标签都是以#号开头，如#import /public/work_public.ftl as public@s.if test=results!=nullresults.size()!=0 注意FTL标签不可以在其他FTL标签和插值中使用（注释可以在FTL标签和插值中使用，因为它在解析时，整个注释都将抛弃，不会影响具体代码），如下面这样就是一个错误的写法： #if #include foo=bar.../#if 2.1.2 注释 freemarker的文档注释与html相似，但它是以FTL 标签，插值或注释的内容将被视为静态文本，这些东西就不会被freemarker所解析，会被按照原样输出出来。 2.1.3 引入外部文件 @s.include value=/public/publis.jsp / 在freemarker版本2.3.15及其以后都可以使用如下方式引入外部文件： @include_page path=/public/publis.jsp /或者使用：#include /copyright_footer.html的方式引入外部文件。 注意：#include /copyright_footer.html#include..包含的模板和包含它的模板共享模板处理状态， 比如数据模型和模板语言变量，而@include_page..开始一个独立的HTTP请求处理。 对于js、css等其他外部资源的引入方式不变，依旧是类似： script type=text/javascript src=./public/work_public.js /script 2.2 freemarker与spring的集成 将freemarker.jar包放到web工程的lib目录中，并在web.xml文件中加入如下的代码： servlet servlet-name/servlet-name servlet-class freemarker.ext.servlet.FreemarkerServlet /servlet-class init-param param-nameTemplatePath/param-name param-value//param-value /init-param init-param param-nameNoCache/param-name param-valuetrue/param-value /init-param init-param param-nameContentType/param-name param-valuetext/html/param-value /init-param init-param param-nametemplate_update_delay/param-name param-value0/param-value /init-param load-on-startup1/load-on-startup /servlet servlet-mapping servlet-namefreemarker/servlet-name url-pattern*.ftl/url-pattern /servlet-mapping 2.3 freemarker中使用struts标签 由于freemarker本身的标签在变量名不存在或变量为null的情况下处理比较复杂（它不允许出现这两种情况的变量，在使用可能出现变量名不存在或null值的变量时，首先需要判断该变量是否存在，否则当出现这两种情况时，freemarker会报解析错误，这