BlogJava-Terry.B.Li 彬-文章分类-模板

Freemarker中使用OSCache

礼物 — Sat, 07 Aug 2010 07:53:00 GMT

可以使用maven加入oscache依赖，然后在需要使用oscache的freemarker页面上引入标签<#assign oscache=JspTaglibs['http://www.opensymphony.com/oscache']/>，中括号中可以使用路径方式，然后再页面上需要加入oscache的地方使用<@oscache:标记

例如：
<#assign oscache=JspTaglibs['http://www.opensymphony.com/oscache']/>

<#assign fowUrlaa="">
<#if RequestParameters.fowUrl?exists>
<#assign fowUrlaa="${RequestParameters.fowUrl}">

<@oscache.cache key="__oscache_categories" time=300>
${fowUrlaa}

然后再URL上添加参数测试：?fowUrl=12fas11

礼物 2010-08-07 15:53 发表评论

FreeMarker设计指南

礼物 — Wed, 28 Jan 2009 15:20:00 GMT

摘要: 1、快速入门（1）模板 + 数据模型 = 输出 FreeMarker基于设计者和程序员是具有不同专业技能的不同个体的观念他们是分工劳动... 阅读全文

礼物 2009-01-28 23:20 发表评论

用freemarker生产静态页面

礼物 — Wed, 28 Jan 2009 15:17:00 GMT

FreeMarker概述

FreeMarker是一个模板引擎，一个基于模板生成文本输出的通用工具，使用纯Java编写
Template + data model = output
Hello world
FreeMarkerTest.java

 

import java.io.StringWriter;import java.util.HashMap;import java.util.Locale;

 

import freemarker.template.Configuration;import freemarker.template.Template;

 

publicclass FreeMarkerTest {

 

publicstaticvoid main(String[] args){

FreeMarkerTest test = new FreeMarkerTest();

test.sayHello("Hermit");

}

 

publicvoid sayHello(String name){

Configuration freemarkerCfg = new Configuration();

freemarkerCfg.setClassForTemplateLoading(this.getClass(), "/");

 

freemarkerCfg.setEncoding(Locale.getDefault(), "UTF-8");

Template template;

Locale.setDefault(Locale.ENGLISH);

try{

template = freemarkerCfg.getTemplate("Hello.ftl");

template.setEncoding("UTF-8");

HashMap root = newHashMap();

root.put("user", name);

 

StringWriter writer = newStringWriter();

template.process(root, writer);

System.out.println(writer.toString());

}catch(Exception e){

e.printStackTrace();

}}

 

 

 

}

Hello.ftl

 

 

Hello ${user}!

输出

Hello Hermit!

空值的处理

在我们的程序中难免会碰到值为空的时候，如果用一个空值直接去替换模板中的标记，freemarker会毫不犹豫的抛出异常，并把错误信息直接写到输出结果里。为了对付这种情况我们有两种写法

模板

 

Hello ${user!}!

Hello ${user?if_exists}

Hello ${user!'your name'}!

Hello ${user?default('your name')}

程序

 

test.sayHello(null);

输出

 

Hello !

Hello your name!

Hello 

Hello your name

freemarker国际化模板

freemarker支持多语言国际化，只要把模板名称按照java资源文件的写法就可以了,也就是name_语言_国家地区.ftl 如果找不到对应的语言，就会用默认语言的模板。

程序

 

import java.io.StringWriter;import java.util.HashMap;import java.util.Locale;

 

import freemarker.template.Configuration;import freemarker.template.Template;

 

publicclass FreeMarkerTest {

 

publicstaticvoid main(String[] args){

FreeMarkerTest test = new FreeMarkerTest();

test.sayHello("hermit",Locale.CHINA);

test.sayHello("hermit",Locale.ENGLISH);

}

 

publicvoid sayHello(String name,Locale locale){

Configuration freemarkerCfg = new Configuration();

freemarkerCfg.setClassForTemplateLoading(this.getClass(), "/");

 

freemarkerCfg.setEncoding(Locale.getDefault(), "UTF-8");

Template template;

Locale.setDefault(Locale.ENGLISH);

try{

template = freemarkerCfg.getTemplate("Hello.ftl",locale);

template.setEncoding("UTF-8");

HashMap root = newHashMap();

root.put("user", name);

 

StringWriter writer = newStringWriter();

template.process(root, writer);

System.out.println(writer.toString());

}catch(Exception e){

e.printStackTrace();

}

}

  

}

默认语言模版:Hello.ftl

Hello ${user!}! 

中文模版:Hello_zh_CN.ftl 

你好 ${user!}!



输出

你好 hermit!

Hello hermit!

在struts项目中使用freemarker

1、引入freemarker.jar

2、web.xml加入

	

>>freemarker>>

freemarker.ext.servlet.FreemarkerServlet

>

 



>

>TemplatePath>

>/>

>

>

>NoCache>

>true>

>

>

>ContentType>

>text/html>

>

 

>>template_update_delay>>0>



>>>default_encoding>

>utf-8>>

>>locale>>en_US>>

>>number_format>>0.##########>>

 

>1>>

 

>>freemarker>>*.ftl>>

3、一个示例页面

 

</span></span>Say Hello<span style="color: #009900; "><span style="font-weight: bold; color: #000000; ">HTTP-EQUIV="Content-Type"CONTENT="text/html; charset=utf-8">Hello ${user}!

我们完全可以用freemarker的模板取代JSP页面。用freemarker的模板看起更简洁，可读性更强。比如现在struts2的UI标签就是用freemarker做的。

freemarker用struts标签做国际化

示例模板

<#assign  html =JspTaglibs["/WEB-INF/struts-html.tld"]><#assign  bean =JspTaglibs["/WEB-INF/struts-bean.tld"]><#assign  logic =JspTaglibs["/WEB-INF/struts-logic.tld"]></span></span> FreeMarker Struts Example <span style="color: #009900; "><span style="font-weight: bold; color: #000000; ">http-equiv ="Content-type"content ="text/html; charset=utf-8"></ head ><@bean.message key ="hello"  arg0 ="hermit"/>

主要是引入标签的时候要这样写：

<#assign  html =JspTaglibs["/WEB-INF/struts-html.tld"]>

freemarker直接使用资源文件进行多语言国际化

程序

import java.io.StringWriter;import java.util.HashMap;import java.util.Locale;import java.util.ResourceBundle;

 

import freemarker.ext.beans.BeansWrapper;import freemarker.ext.beans.ResourceBundleModel;import freemarker.template.Configuration;import freemarker.template.Template;

 

publicclass FreeMarkerTest {

 

publicstaticvoid main(String[] args){

FreeMarkerTest test = new FreeMarkerTest();

test.sayHello("hermit",Locale.CHINA);

test.sayHello("hermit",Locale.ENGLISH);

}

 

publicvoid sayHello(String name,Locale locale){

Configuration freemarkerCfg = new Configuration();

freemarkerCfg.setClassForTemplateLoading(this.getClass(), "/");

 

freemarkerCfg.setEncoding(Locale.getDefault(), "UTF-8");

Template template;

Locale.setDefault(Locale.ENGLISH);

try{

template = freemarkerCfg.getTemplate("Hello.ftl");

template.setEncoding("UTF-8");

HashMap root = newHashMap();

root.put("user", name);

ResourceBundle RESOURCE_BUNDLE = ResourceBundle.getBundle("ApplicationResources",locale);

ResourceBundleModel rsbm = new ResourceBundleModel(RESOURCE_BUNDLE,new BeansWrapper());

root.put("bundle", rsbm);

StringWriter writer = newStringWriter();

template.process(root, writer);

System.out.println(writer.toString());

}catch(Exception e){

e.printStackTrace();

}}

 

 

 

} 



模板

${bundle("hello","hermit")} 



默认语言资源文件

hello=Hello {0}\! 



中文资源文件 



hello=你好 {0}\!

输出

你好 hermit!

Hello hermit!

关键的地方就是用ResourceBundleModel把ResourceBundle转换一下。

常用的2种加载模板的方式

普通java类根据当前class上下文环境加载模板

cfg.setClassForTemplateLoading(this.getClass(), "/");

在web项目中根据servlet上下文环境加载模板

cfg.setServletContextForTemplateLoading(this.getServlet().getServletContext(), "/");

礼物 2009-01-28 23:17 发表评论

我的第一个FreeMarker程序

礼物 — Tue, 16 Sep 2008 16:00:00 GMT

1、java应用程序中
    我用maven导入FreeMarker的jar包


      freemarker
      freemarker
      2.3.8

package com.test;

import java.io.IOException;
import java.io.StringWriter;
import java.util.HashMap;
import java.util.Map;

import freemarker.cache.ClassTemplateLoader;
import freemarker.template.Configuration;
import freemarker.template.DefaultObjectWrapper;
import freemarker.template.Template;
import freemarker.template.TemplateException;

public class Test {

    /** *//**
     * @param args
     */
    public static void main(String[] args) {
        Configuration configuration = new Configuration();
        configuration.setObjectWrapper(new DefaultObjectWrapper());
        configuration.setTemplateLoader(new ClassTemplateLoader(Test.class, "/com/test"));
        try {
            Template template = configuration.getTemplate("temp.ftl");
            StringWriter writer = new StringWriter();
            Map context = new HashMap();

            context.put("message", "我的第一个FreeMarker程序");

            template.process(context, writer);
            System.out.println(writer.toString());
        } catch (IOException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        } catch (TemplateException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        }
    }

}

这里是用java应用程序，需要加入下面两句（设置模板文件载入）：
方法一：
configuration.setObjectWrapper(new DefaultObjectWrapper());
configuration.setTemplateLoader(new ClassTemplateLoader(Test.class, "/com/test"));

其中"/com/test" 是模板文件所在的文件夹，前面的“/”必须，这里我的模板文件和当前java类在同一路径下，则这样写，如果你的模板文件在src跟目录下，这里只需要写“/”就可以了

context.put("message", "我的第一个FreeMarker程序");
是模板文件中用到的变量，map中的变量可以是javabean，也可以是对象

方法二：
configuration.setServletContextForTemplateLoading(getServletContext(), "WEB-INF/templates");
这里主要针对Servlet的时候，当然在Servlet中也可以用方法一提到的写法
package com.newegg.lab.freemarker.servlet;

import java.io.IOException;
import java.io.StringWriter;
import java.io.Writer;
import java.util.HashMap;
import java.util.Map;

import javax.servlet.ServletException;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

/** *//**
* Servlet implementation class for Servlet: FreemarkerServlet
*
*/
public class FreemarkerServlet extends javax.servlet.http.HttpServlet implements
javax.servlet.Servlet {

private Configuration configuration;

    private Template template;
    /**//*
     * (non-Java-doc)
     *
     * @see javax.servlet.http.HttpServlet#HttpServlet()
     */
    public FreemarkerServlet() {
        super();
    }

    @Override
    public void destroy() {
        // TODO Auto-generated method stub
        configuration = null;
    }

    @Override
    public void init() throws ServletException {
        // TODO Auto-generated method stub
        configuration = new Configuration();
        configuration.setServletContextForTemplateLoading(getServletContext(), "WEB-INF/templates");
//        configuration.setObjectWrapper(new DefaultObjectWrapper());
//        configuration.setTemplateLoader(new ClassTemplateLoader(FreemarkerServlet.class, "/"));
    }

    /**//*
     * (non-Java-doc)
     *
     * @see javax.servlet.http.HttpServlet#doGet(HttpServletRequest request,
     *      HttpServletResponse response)
     */
    protected void doGet(HttpServletRequest request,
            HttpServletResponse response) throws ServletException, IOException {
        // TODO Auto-generated method stub
        this.doPost(request, response);
    }

    /**//*
     * (non-Java-doc)
     *
     * @see javax.servlet.http.HttpServlet#doPost(HttpServletRequest request,
     *      HttpServletResponse response)
     */
    protected void doPost(HttpServletRequest request,
            HttpServletResponse response) throws ServletException, IOException {
        // TODO Auto-generated method stub
        Map root = new HashMap();
        root.put("message", "Hello World!的的的的");

// Get the templat object
Template t = configuration.getTemplate("test.ftl");

        // Prepare the HTTP response:
        // - Use the charset of template for the output
        // - Use text/html MIME-type
        response.setContentType("text/html; charset=" + t.getEncoding());
        Writer out = response.getWriter();

        // Merge the data-model and the template
        try {
            t.process(root, out);

            StringWriter stringWriter = new StringWriter();
            t.process(root, stringWriter);
            System.out.println(stringWriter.toString());
        } catch (TemplateException e) {
            throw new ServletException(
                    "Error while processing FreeMarker template", e);
        }
    }
}

模板文件中需要使用 ${}将java类中在Map对象中声明的变量包围起来就可以了

例如模板文件：



//描述信息是 : ${message}

则得到的结果是：



//描述信息是 : Hello World!的的的的

礼物 2008-09-17 00:00 发表评论

(转)FreeMarker中文参考手册

礼物 — Tue, 16 Sep 2008 13:56:00 GMT

（1）模板 + 数据模型 = 输出

FreeMarker基于设计者和程序员是具有不同专业技能的不同个体的观念他们是分工劳动的：设计者专注于表示——创建HTML文件、图片、Web页面的其它可视化方面；程序员创建系统，生成设计页面要显示的数据。经常会遇到的问题是：在Web页面（或其它类型的文档）中显示的信息在设计页面时是无效的，是基于动态数据的。在这里，你可以在HTML（或其它要输出的文本）中加入一些特定指令，FreeMarker会在输出页面给最终用户时，用适当的数据替代这些代码。

下面是一个例子：



Welcome!


Welcome ${user}!
Our latest product:
${latestProduct.name}!

这个例子是在简单的HTML中加入了一些由${…}包围的特定代码，这些特定代码是FreeMarker的指令，而包含FreeMarker的指令的文件就称为模板（Template）。至于user、latestProduct.url和latestProduct.name来自于数据模型（data model）。数据模型由程序员编程来创建，向模板提供变化的信息，这些信息来自于数据库、文件，甚至于在程序中直接生成。模板设计者不关心数据从那儿来，只知道使用已经建立的数据模型。

下面是一个可能的数据模型：

(root)
|
+- user = "Big Joe"
|
+- latestProduct
|
+- url = "products/greenmouse.html"
|
+- name = "green mouse"

数据模型类似于计算机的文件系统，latestProduct可以看作是目录。

2、数据模型

（1）基础

在快速入门中介绍了在模板中使用的三种基本对象类型：scalars、hashes 和sequences，其实还可以有其它更多的能力：

scalars：存储单值

hashes：充当其它对象的容器，每个都关联一个唯一的查询名字

sequences：充当其它对象的容器，按次序访问

方法：通过传递的参数进行计算，以新对象返回结果

用户自定义FTL标记：宏和变换器

通常每个变量只具有上述的一种能力，但一个变量可以具有多个上述能力，如下面的例子：

(root)
|
+- mouse = "Yerri"
|
+- age = 12
|
+- color = "brown">

mouse既是scalars又是hashes，将上面的数据模型合并到下面的模板：

${mouse}       <#-- use mouse as scalar -->
${mouse.age}   <#-- use mouse as hash -->
${mouse.color} <#-- use mouse as hash -->

输出结果是：

Yerri
12
brown

（2）Scalar变量

Scalar变量存储单值，可以是：

字符串：简单文本，在模板中使用引号（单引号或双引号）括起

数字：在模板中直接使用数字值

日期：存储日期/时间相关的数据，可以是日期、时间或日期-时间（Timestamp）；通常情况，日期值由程序员加到数据模型中，设计者只需要显示它们

布尔值：true或false，通常在<#if …>标记中使用

（3）hashes 、sequences和集合

有些变量不包含任何可显示的内容，而是作为容器包含其它变量，者有两种类型：

hashes：具有一个唯一的查询名字和它包含的每个变量相关联

sequences：使用数字和它包含的每个变量相关联，索引值从0开始

集合变量通常类似sequences，除非无法访问它的大小和不能使用索引来获得它的子变量；集合可以看作只能由<#list …>指令使用的受限sequences

（4）方法

方法变量通常是基于给出的参数计算值。

下面的例子假设程序员已经将方法变量avg放到数据模型中，用来计算数字平均值：

The average of 3 and 5 is: ${avg(3, 5)}
The average of 6 and 10 and 20 is: ${avg(6, 10, 20)}
The average of the price of python and elephant is:
${avg(animals.python.price, animals.elephant.price)}

（5）宏和变换器

宏和变换器变量是用户自定义指令（自定义FTL标记），会在后面讲述这些高级特性

（6）节点

节点变量表示为树型结构中的一个节点，通常在XML处理中使用，会在后面的专门章节中讲

3、模板

（1）整体结构

模板使用FTL（FreeMarker模板语言）编写，是下面各部分的一个组合：

文本：直接输出
Interpolation：由${和}，或#{和}来限定，计算值替代输出
FTL标记：FreeMarker指令，和HTML标记类似，名字前加#予以区分，不会输出
注释：由<#--和-->限定，不会输出

下面是以一个具体模板例子：



Welcome!


<#-- Greet the user with his/her name -->
Welcome ${user}!
We have these animals:

<#list animals as being>
${being.name} for ${being.price} Euros

注意事项：

FTL区分大小写，所以list是正确的FTL指令，而List不是；${name}和${NAME}是不同的

Interpolation只能在文本中使用

FTL标记不能位于另一个FTL标记内部，例如：

<#if <#include 'foo'>='bar'>...

注释可以位于FTL标记和Interpolation内部，如下面的例子：

Welcome ${user <#-- The name of user -->}!
We have these animals:

<#list <#-- some comment... --> animals as <#-- again... --> being>
...

余的空白字符会在模板输出时移除

（2）指令

在FreeMarker中，使用FTL标记引用指令。有三种FTL标记，这和HTML标记是类似的：

开始标记：<#directivename parameters>

结束标记：

空内容指令标记：<#directivename parameters/>

有两种类型的指令：预定义指令和用户定义指令。

用户定义指令要使用@替换#，如<@mydirective>...（会在后面讲述）。

FTL标记不能够交叉，而应该正确的嵌套，如下面的代码是错误的：


<#list animals as being>
${being.name} for ${being.price} Euros
<#if use = "Big Joe">
(except for you)

 <#-- WRONG! -->

如果使用不存在的指令，FreeMarker不会使用模板输出，而是产生一个错误消息。

FreeMarker会忽略FTL标记中的空白字符，如下面的例子：

<#list
animals       as
being
>
${being.name} for ${being.price} Euros

但是，<、（3）表达式

直接指定值

字符串

使用单引号或双引号限定

如果包含特殊字符需要转义，如下面的例子：

${"It's \"quoted\" and
this is a backslash: \\"}
${'It\'s "quoted" and
this is a backslash: \\'}

输出结果是：

It's "quoted" and
this is a backslash: \
It's "quoted" and
this is a backslash: \

下面是支持的转义序列：

转义序列	含义
\"	双引号(u0022)
\'	单引号(u0027)
	反斜杠(u005C)
\n	换行(u000A)
\r	Return (u000D)
\t	Tab (u0009)
\b	Backspace (u0008)
\f	Form feed (u000C)
\l	<
\g	>
\a	&
\{	{
\xCode	4位16进制Unicode代码

有一类特殊的字符串称为raw字符串，被认为是纯文本，其中的\和{等不具有特殊含义，该类字符串在引号前面加r，下面是一个例子：

${r"${foo}"}
${r"C:\foo\bar"}

输出的结果是：

${foo}
C:\foo\bar

数字

直接输入，不需要引号

精度数字使用“.”分隔，不能使用分组符号

目前版本不支持科学计数法，所以“1E3”是错误的

不能省略小数点前面的0，所以“.5”是错误的

数字8、+8、08和8.00都是相同的

布尔值

true和false，不使用引号

序列

由逗号分隔的子变量列表，由方括号限定，下面是一个例子：

<#list ["winter", "spring", "summer", "autumn"] as x>
${x}

输出的结果是：

winter
spring
summer
autumn

列表的项目是表达式，所以可以有下面的例子：

[2 + 2, [1, 2, 3, 4], "whatnot"]

可以使用数字范围定义数字序列，例如2..5等同于[2, 3, 4, 5]，但是更有效率，注意数字范围没有方括号

可以定义反递增的数字范围，如5..2

散列（hash）

由逗号分隔的键/值列表，由大括号限定，键和值之间用冒号分隔，下面是一个例子：

{"name":"green mouse", "price":150}

键和值都是表达式，但是键必须是字符串

获取变量

顶层变量： ${variable}，变量名只能是字母、数字、下划线、$、@和#的组合，且不能以数字开头

从散列中获取数据

可以使用点语法或方括号语法，假设有下面的数据模型：

(root)
|
+- book
|   |
|   +- title = "Breeding green mouses"
|   |
|   +- author
|       |
|       +- name = "Julia Smith"
|       |
|       +- info = "Biologist, 1923-1985, Canada"
|
+- test = "title"

下面都是等价的：

book.author.name
book["author"].name
book.author.["name"]
book["author"]["name"]

使用点语法，变量名字有顶层变量一样的限制，但方括号语法没有该限制，因为名字是任意表达式的结果

从序列获得数据：和散列的方括号语法语法一样，只是方括号中的表达式值必须是数字；注意：第一个项目的索引是0

序列片断：使用[startIndex..endIndex]语法，从序列中获得序列片断（也是序列）；startIndex和endIndex是结果为数字的表达式

特殊变量：FreeMarker内定义变量，使用.variablename语法访问

字符串操作

Interpolation（或连接操作）

可以使用${..}（或#{..}）在文本部分插入表达式的值，例如：

${"Hello ${user}!"}
${"${user}${user}${user}${user}"}

可以使用+操作符获得同样的结果

${"Hello " + user + "!"}
${user + user + user + user}

${..}只能用于文本部分，下面的代码是错误的：

<#if ${isBig}>Wow!
<#if "${isBig}">Wow!

应该写成：

<#if isBig>Wow!

子串

例子（假设user的值为“Big Joe”）：

${user[0]}${user[4]}
${user[1..4]}

结果是（注意第一个字符的索引是0）：

BJ
ig J

序列操作

连接操作：和字符串一样，使用+，下面是一个例子：

<#list ["Joe", "Fred"] + ["Julia", "Kate"] as user>
- ${user}

输出结果是：

- Joe
- Fred
- Julia
- Kate

散列操作

连接操作：和字符串一样，使用+，如果具有相同的key，右边的值替代左边的值，例如：

<#assign ages = {"Joe":23, "Fred":25} + {"Joe":30, "Julia":18}>
- Joe is ${ages.Joe}
- Fred is ${ages.Fred}
- Julia is ${ages.Julia}

输出结果是：

- Joe is 30
- Fred is 25
- Julia is 18

算术运算

＋、－、×、／、％，下面是一个例子：

${x * x - 100}
${x / 2}
${12 % 10}

输出结果是（假设x为5）：

-75
2.5
2

操作符两边必须是数字，因此下面的代码是错误的：

${3 * "5"} <#-- WRONG! -->

使用+操作符时，如果一边是数字，一边是字符串，就会自动将数字转换为字符串，例如：

${3 + "5"}

输出结果是：

使用内建的int（后面讲述）获得整数部分，例如：

${(x/2)?int}
${1.1?int}
${1.999?int}
${-1.1?int}
${-1.999?int}

输出结果是（假设x为5）：

比较操作符

使用=（或==，完全相等）测试两个值是否相等，使用!= 测试两个值是否不相等

=和!=两边必须是相同类型的值，否则会产生错误，例如<#if 1 = "1">会引起错误

Freemarker是精确比较，所以对"x"、"x "和"X"是不相等的

对数字和日期可以使用<、<=、>和>=，但不能用于字符串

由于Freemarker会将>解释成FTL标记的结束字符，所以对于>和>=可以使用括号来避免这种情况，例如<#if (x > y)>

另一种替代的方法是，使用lt、lte、gt和gte来替代<、<=、>和>=

逻辑操作符

&&（and）、||（or）、!（not），只能用于布尔值，否则会产生错误

例子：

<#if x < 12 && color = "green">
We have less than 12 things, and they are green.

<#if !hot> <#-- here hot must be a boolean -->
It's not hot.

内建函数

内建函数的用法类似访问散列的子变量，只是使用“?”替代“.”，下面列出常用的一些函数

- 字符串使用的：

html：对字符串进行HTML编码

cap_first：使字符串第一个字母大写

lower_case：将字符串转换成小写

upper_case：将字符串转换成大写

trim：去掉字符串前后的空白字符

- 序列使用的：

size：获得序列中元素的数目

- 数字使用的：

int：取得数字的整数部分（如-1.9?int的结果是-1）

例子（假设test保存字符串"Tom & Jerry"）：

${test?html}
${test?upper_case?html}

输出结果是：

Tom & Jerry
TOM & JERRY

操作符优先顺序

操作符组	操作符
后缀	[subvarName] [subStringRange] . (methodParams)
一元	+expr、-expr、!
内建	?
乘法	*、 / 、%
加法	+、-
关系	<、>、<=、>=（lt、lte、gt、gte）
相等	==（=）、!=
逻辑and	&&
逻辑or	双竖线
数字范围	..

（4）Interpolation

Interpolation有两种类型：

通用Interpolation：${expr}

数字Interpolation：#{expr}或#{expr; format}

注意：Interpolation只能用于文本部分

通用Interpolation

插入字符串值：直接输出表达式结果

插入数字值：根据缺省格式（由#setting指令设置）将表达式结果转换成文本输出；可以使用内建函数string格式化单个Interpolation，下面是一个例子：

<#setting number_format="currency"/>
<#assign answer=42/>
${answer}
${answer?string}  <#-- the same as ${answer} -->
${answer?string.number}
${answer?string.currency}
${answer?string.percent}

输出结果是：

$42.00
$42.00
42
$42.00
4,200%

插入日期值：根据缺省格式（由#setting指令设置）将表达式结果转换成文本输出；可以使用内建函数string格式化单个Interpolation，下面是一个使用格式模式的例子：

${lastUpdated?string("yyyy-MM-dd HH:mm:ss zzzz")}
${lastUpdated?string("EEE, MMM d, ''yy")}
${lastUpdated?string("EEEE, MMMM dd, yyyy, hh:mm:ss a '('zzz')'")}

输出的结果类似下面的格式：

2003-04-08 21:24:44 Pacific Daylight Time
Tue, Apr 8, '03
Tuesday, April 08, 2003, 09:24:44 PM (PDT)

插入布尔值：根据缺省格式（由#setting指令设置）将表达式结果转换成文本输出；可以使用内建函数string格式化单个Interpolation，下面是一个例子：

<#assign foo=true/>
${foo?string("yes", "no")}

输出结果是：

yes

数字Interpolation的#{expr; format}形式可以用来格式化数字，format可以是：

mX：小数部分最小X位

MX：小数部分最大X位

例子：

<#-- If the language is US English the output is: -->
<#assign x=2.582/>
<#assign y=4/>
#{x; M2}   <#-- 2.58 -->
#{y; M2}   <#-- 4    -->
#{x; m1}   <#-- 2.6 -->
#{y; m1}   <#-- 4.0 -->
#{x; m1M2} <#-- 2.58 -->
#{y; m1M2} <#-- 4.0  -->

4、杂项

（1）用户定义指令

宏和变换器变量是两种不同类型的用户定义指令，它们之间的区别是宏是在模板中使用macro指令定义，而变换器是在模板外由程序定义，这里只介绍宏

基本用法

宏是和某个变量关联的模板片断，以便在模板中通过用户定义指令使用该变量，下面是一个例子：

<#macro greet>
Hello Joe!

作为用户定义指令使用宏变量时，使用@替代FTL标记中的#

<@greet>

如果没有体内容，也可以使用：

<@greet/>

参数

在macro指令中可以在宏变量之后定义参数，如：

<#macro greet person>
Hello ${person}!

可以这样使用这个宏变量：

<@greet person="Fred"/> and <@greet person="Batman"/>

输出结果是：

  Hello Fred!
and   Hello Batman!

宏的参数是FTL表达式，所以下面的代码具有不同的意思：

<@greet person=Fred/>

这意味着将Fred变量的值传给person参数，该值不仅是字符串，还可以是其它类型，甚至是复杂的表达式

可以有多参数，下面是一个例子：

<#macro greet person color>
Hello ${person}!

可以这样使用该宏变量：

<@greet person="Fred" color="black"/>

其中参数的次序是无关的，因此下面是等价的：

<@greet color="black" person="Fred"/>

只能使用在macro指令中定义的参数，并且对所有参数赋值，所以下面的代码是错误的：

<@greet person="Fred" color="black" background="green"/>
<@greet person="Fred"/>

可以在定义参数时指定缺省值，如：

<#macro greet person color="black">
Hello ${person}!

这样<@greet person="Fred"/>就正确了

宏的参数是局部变量，只能在宏定义中有效

嵌套内容

用户定义指令可以有嵌套内容，使用<#nested>指令执行指令开始和结束标记之间的模板片断

例子：

<#macro border>

<#nested>

这样使用该宏变量：

<@border>The bordered text

输出结果：

  
The bordered text

<#nested>指令可以被多次调用，例如：

<#macro do_thrice>
<#nested>
<#nested>
<#nested>

<@do_thrice>
Anything.

输出结果：

  Anything.
Anything.
Anything.

嵌套内容可以是有效的FTL，下面是一个有些复杂的例子： <@border> <@do_thrice> <@greet person="Joe"/> }}} 输出结果： Hello Joe! Hello Joe! Hello Joe! 宏定义中的局部变量对嵌套内容是不可见的，例如： <#macro repeat count> <#local y = "test"> <#list 1..count as x> ${y} ${count}/${x}: <#nested> <@repeat count=3>${y?default("?")} ${x?default("?")} ${count?default("?")} 输出结果： test 3/1: ? ? ? test 3/2: ? ? ? test 3/3: ? ? ? 在宏定义中使用循环变量用户定义指令可以有循环变量，通常用于重复嵌套内容，基本用法是：作为nested指令的参数传递循环变量的实际值，而在调用用户定义指令时，在<@…>开始标记的参数后面指定循环变量的名字例子： <#macro repeat count> <#list 1..count as x> <#nested x, x/2, x==count> <@repeat count=4 ; c, halfc, last> ${c}. ${halfc}<#if last> Last! 输出结果： 1. 0.5 2. 1 3. 1.5 4. 2 Last! 指定的循环变量的数目和用户定义指令开始标记指定的不同不会有问题调用时少指定循环变量，则多指定的值不可见调用时多指定循环变量，多余的循环变量不会被创建（2）在模板中定义变量在模板中定义的变量有三种类型： plain变量：可以在模板的任何地方访问，包括使用include指令插入的模板，使用assign指令创建和替换局部变量：在宏定义体中有效，使用local指令创建和替换循环变量：只能存在于指令的嵌套内容，由指令（如list）自动创建宏的参数是局部变量，而不是循环变量；局部变量隐藏（而不是覆盖）同名的plain变量；循环变量隐藏同名的局部变量和plain变量，下面是一个例子： <#assign x = "plain"> 1. ${x} <#-- we see the plain var. here --> <@test/> 6. ${x} <#-- the value of plain var. was not changed --> <#list ["loop"] as x> 7. ${x} <#-- now the loop var. hides the plain var. --> <#assign x = "plain2"> <#-- replace the plain var, hiding does not mater here --> 8. ${x} <#-- it still hides the plain var. --> 9. ${x} <#-- the new value of plain var. --> <#macro test> 2. ${x} <#-- we still see the plain var. here --> <#local x = "local"> 3. ${x} <#-- now the local var. hides it --> <#list ["loop"] as x> 4. ${x} <#-- now the loop var. hides the local var. --> 5. ${x} <#-- now we see the local var. again --> 输出结果： 1. plain 2. plain 3. local 4. loop 5. local 6. plain 7. loop 8. loop 9. plain2 内部循环变量隐藏同名的外部循环变量，如： <#list ["loop 1"] as x> ${x} <#list ["loop 2"] as x> ${x} <#list ["loop 3"] as x> ${x} ${x} ${x} 输出结果： loop 1 loop 2 loop 3 loop 2 loop 1 模板中的变量会隐藏（而不是覆盖）数据模型中同名变量，如果需要访问数据模型中的同名变量，使用特殊变量global，下面的例子假设数据模型中的user的值是Big Joe： <#assign user = "Joe Hider"> ${user} <#-- prints: Joe Hider --> ${.globals.user} <#-- prints: Big Joe --> （3）名字空间通常情况，只使用一个名字空间，称为主名字空间为了创建可重用的宏、变换器或其它变量的集合（通常称库），必须使用多名字空间，其目的是防止同名冲突创建库下面是一个创建库的例子（假设保存在lib/my_test.ftl中）： <#macro copyright date> Copyright (C) ${date} Julia Smith. All rights reserved. Email: ${mail} <#assign mail = "jsmith@acme.com"> 使用import指令导入库到模板中，Freemarker会为导入的库创建新的名字空间，并可以通过import指令中指定的散列变量访问库中的变量： <#import "/lib/my_test.ftl" as my> <#assign mail="fred@acme.com"> <@my.copyright date="1999-2002"/> ${my.mail} ${mail} 输出结果： Copyright (C) 1999-2002 Julia Smith. All rights reserved. Email: jsmith@acme.com jsmith@acme.com fred@acme.com 可以看到例子中使用的两个同名变量并没有冲突，因为它们位于不同的名字空间可以使用assign指令在导入的名字空间中创建或替代变量，下面是一个例子： <#import "/lib/my_test.ftl" as my> ${my.mail} <#assign mail="jsmith@other.com" in my> ${my.mail} 输出结果： jsmith@acme.com jsmith@other.com 数据模型中的变量任何地方都可见，也包括不同的名字空间，下面是修改的库： <#macro copyright date> Copyright (C) ${date} ${user}. All rights reserved. <#assign mail = "${user}@acme.com"> 假设数据模型中的user变量的值是Fred，则下面的代码： <#import "/lib/my_test.ftl" as my> <@my.copyright date="1999-2002"/> ${my.mail} 输出结果： Copyright (C) 1999-2002 Fred. All rights reserved. Fred@acme.com

礼物 2008-09-16 21:56 发表评论

BlogJava-Terry.B.Li 彬-文章分类-模板

Freemarker中使用OSCache

FreeMarker设计指南

用freemarker生产静态页面

FreeMarker概述

Hello world

空值的处理

freemarker国际化模板

在struts项目中使用freemarker

Hello ${user}!

freemarker用struts标签做国际化

freemarker直接使用资源文件进行多语言国际化

常用的2种加载模板的方式

我的第一个FreeMarker程序

(转)FreeMarker中文参考手册

（1）模板 + 数据模型 = 输出

Welcome ${user}!

2、数据模型

（1）基础

（2）Scalar变量

（3）hashes 、sequences和集合

（4）方法

（5）宏和变换器

（6）节点

3、模板

（1）整体结构

Welcome ${user}!

Welcome ${user <#-- The name of user -->}!

（2）指令

（4）Interpolation

4、杂项

（1）用户定义指令

（2）在模板中定义变量

（3）名字空间