ftl编辑器[freemarker]的使用及说明.docVIP

一、准备工作 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。但用户自定义的标签是以@符号开头，如在freemarker中使用struts标签：@s.if test=results!=nullresults.size()!=0 注意FTL标签不可以在其他FTL标签和插值中使用（注释可以在FTL标签和插值中使用，因为它在解析时，整个注释都将抛弃，不会影响具体代码），如下面这样就是一个错误的写法： #if #include foo=bar.../#if 2.1.2 注释 freemarker的文档注释与html相似，但它是以#--和--来分割的。任何介于这两个分隔符（包含分隔符本身）之间内容会被freemarker忽略，就不会输出出来了。其他任何不是FTL 标签，插值或注释的内容将被视为静态文本，这些东西就不会被freemarker所解析，会被按照原样输出出来。 2.1.3 引入外部文件 如果模板文件使用了struts2标签，则可以这样调用： @s.include value=/public/publis.jsp / 在freemarker版本2.3.15及其以后都可以使用如下方式引入外部文件： @include_page path=/public/publis.jsp /或者使用：#include /copyright_footer.html的方式引入外部文件。 注意：#include /copyright_footer.html是为了包含freemarker模板而不会牵涉到servlet容器，使用#include..包含的模板和包含它的模板共享模板处理状态， 比如数据模型和模板语言变量，而@include_page..开始一个独立的HTTP请求处理。 对于js、css等其他外部资源的引入方式不变，依旧是类似： script type=text/javascript src=./public/work_public.js /script注意该路径与ftl文件路径地址无关，而是真正的访问路径。 2.2 freemarker与spring的集成 将freemarker.jar包放到web工程的lib目录中，并在web.xml文件中加入如下的代码： servlet servlet-namefreemarker/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 servle