freemaker超详细 讲解 配置

时间  2019-11-09 标签 freemaker 详细 讲解 配置

原文地址：http://www.javashuo.com/article/p-whemcqnx-t.htmlhtml

 

模板引擎可让程序实现界面与数据分离，业务代码与逻辑代码的分离，这就提高了开发效率，良好的设计也使得代码复用变得更加容易。通常的模板引擎都包含一个模板解析器和一套标记语言，好的模板引擎有简洁的语法规则、强大的功能、高效的渲染效率、详尽的帮助说明与不断的更新与维护。常见的前端模板引擎有：前端

 

经常使用的java后台模板引擎：jsp、FreeMarker、Velocity等。java

 

请不要迷恋速度，为了推广的测试多是片面的，好的模板引擎经得起时间考验，建议你们选择成熟的、经常使用的模板引擎。另外无论先后端的模板引擎原理都差很少，不外乎在模板中定义一些特别的标签后台正则匹配后替换，因此这里就以FreeMarker为例简介一下模板引擎的使用。另外我我的以为ASP.NET MVC中使用的razor模板引擎很是好用，若是java有一款相似的就行了。git

1、FreeMarker简介

FreeMarker是一款模板引擎，即一种基于模板和要改变的数据，并用来生成输出文本(HTML网页，电子邮件，配置文件，源代码等)的通用工具。它不是面向最终用户的，而是一个Java类库，是一款程序员能够嵌入他们所开发产品的组件。
模板编写为FreeMarkerTemplateLanguage(FTL)。它是简单的，专用的语言，不是像PHP那样成熟的编程语言。那就意味着要准备数据在真实编程语言中来显示，好比数据库查询和业务运算，以后模板显示已经准备好的数据。在模板中，你能够专一于如何展示数据，而在模板以外能够专一于要展现什么数据。程序员

 

这种方式一般被称为MVC(模型视图控制器)模式，对于动态网页来讲，是一种特别流行的模式。它帮助从开发人员(Java程序员)中分离出网页设计师(HTML设计师)。设计师无需面对模板中的复杂逻辑，在没有程序员来修改或从新编译代码时，也能够修改页面的样式。github

而FreeMarker最初的设计，是被用来在MVC模式的Web开发框架中生成HTML页面的，它没有被绑定到Servlet或HTML或任意Web相关的东西上。它也能够用于非Web应用环境中。web

特征与亮点：ajax

功能强大的模板语言：有条件的块，迭代，赋值，字符串和算术运算和格式化，宏和函数，编码等更多的功能；spring

多用途且轻量：零依赖，输出任何格式，能够从任何地方加载模板（可插拔），配置选项丰富；sql

智能的国际化和本地化：对区域设置和日期/时间格式敏感。

XML处理功能：将dom-s放入到XML数据模型并遍历它们，甚至处理他们的声明

通用的数据模型：经过可插拔适配器将java对象暴露于模板做为变量树。

FreeMarker是免费的，基于Apache许可证2.0版本发布。

 

得到FreeMarker

官网：http://freemarker.org/

中文帮助文档：https://sourceforge.net/projects/freemarker/files/chinese-manual/

下载FreeMarker jar包：下载地址http://freemarker.org/freemarkerdownload.html

中文网：http://freemarker.foofun.cn/

使用Maven依赖jar包：

<dependency>
  <groupId>org.freemarker</groupId>
  <artifactId>freemarker-gae</artifactId>
  <version>2.3.25-incubating</version>
</dependency>

 

 

FreeMarker用途

生成HTML Web页面，如做为MVC框架的视图

动态页面静态化等

代码生成器

2、第一个FreeMark示例

模板 + 数据模型 = 输出，FreeMarker基于设计者和程序员是具备不一样专业技能的不一样个体的观念，他们是分工劳动的：设计者专一于表示——建立HTML文件、图片、Web页面的其它可视化方面；程序员建立系统，生成设计页面要显示的数据。总之实现了数据与表现的分离。

2.一、新建一个Maven项目

新建一个简单Maven项目，不要选择内置模板，设置jdk版本为1.7。

 

2.二、添加依赖

修改pom.xml配置文件，增长freemark、junit依赖，修改后的pom.xml文件以下：

 

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.zhangguo</groupId>
    <artifactId>FreeMarkerDemo</artifactId>
    <version>0.0.1</version>
    <dependencies>
        <dependency>
            <groupId>org.freemarker</groupId>
            <artifactId>freemarker</artifactId>
            <version>2.3.23</version>
        </dependency>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.10</version>
        </dependency>
    </dependencies>
</project>

2.三、添加存放模板的文件夹

在src/main/java的包下添加一个名为“templates”目录（包），用于存放全部的freemarker模板。

 

 2.四、添加模板

在src/main/java/templates目录下添加名为“product.ftl”的FreeMarker模板，模板的内容以下：

 

----------产品详细----------
产品名称：${name}
产品价格：${price}
设计做者：<#list users as user> ${user} </#list>
------------------------------

模板中通常分为不可变部分与可变部分，如“产品名称：”这些常量内容就是不能够变化的，而${}与<#></#>这些内容是能够根据数据动态变化的。

2.五、解析模板

使用FreeMarker能够读取到模板内容，将数据与模板绑定并渲染出结果，很好的实现了表现与数据分离。新建一个测试类，代码以下：

 

package com.zhangguo.freemarkerdemo;

import java.io.File;
import java.io.OutputStreamWriter;
import java.io.Writer;
import java.util.HashMap;
import java.util.Map;
import freemarker.template.Configuration;
import freemarker.template.Template;

public class Test {

    public static void main(String[] args) throws Exception {
        
        //建立一个freemarker.template.Configuration实例，它是存储 FreeMarker 应用级设置的核心部分
        //指定版本号
        Configuration cfg=new Configuration(Configuration.VERSION_2_3_22);
        //设置模板目录
        cfg.setDirectoryForTemplateLoading(new File("src/main/java/templates"));
        //设置默认编码格式
        cfg.setDefaultEncoding("UTF-8");
        
        //数据
        Map<String, Object> product = new HashMap<>();
        product.put("name", "Huwei P8");
        product.put("price", "3985.7");
        product.put("users", new String[]{"Tom","Jack","Rose"});
        
        //从设置的目录中得到模板
        Template temp = cfg.getTemplate("product.ftl");
        
        //合并模板和数据模型
        Writer out = new OutputStreamWriter(System.out);
        temp.process(product, out);
        
        //关闭
        out.flush();
        out.close();
    }
}

2.六、运行结果

 

3、动态页面静态化

动态页面静态化是指使用服务器后台技术将用户原来请求的动态页面变成静态内容缓存于服务器文件中，好比网站有一篇新闻名为由hot.jsp页面展现，默认状况下每当有客户端从服务器请求该新闻时服务器会解析hot.jsp页面渲染出静态内容响应给客户端，这样有一些问题，首先是每次请求都要解析服务器压力大，其次新闻的内容并无真的存储在hot.jsp文件中而是存储在数据库里，对搜索引擎的爬虫不友好，不便SEO，另外访问动态的内容可能存在安全风险，如sql注入，XSS等网络攻击。解决办法是将hot.jsp页面静态化成一个叫hot.html的文件，服务器再也不执行动态内容直接把静态页面响应给客户端，由于是纯静态的服务器压力会减轻，不担忧网络安全问题；文章的内容直接存储在html文件中，对SEO友好。

3.一、动态页面静态化的优势

a) 利于搜索引擎优化（SEO）

b) 减轻服务器压力

c) 提升了网站的安全性 sql注入

d) 加快了客户端的访问速度 不用编译

3.二、动态页面静态化的问题

a) 页面过时与内容更新问题

若是一个页面的内容须要常常更新，就会要不断的生成新的静态页面，不是全部的页面都适合静态化。

b) 页面生成的问题

何时生成静态页面合适，有客户端第一次请求生成的，有定时生成的，也有后台管理时批量生成的。

c) 页面中部份内容是静态的，部份内容是动态的，如一篇文章的评论，访问次数，这些确定不能静态。我暂时想到的办法是ajax和内嵌框架（iframe）

3.三、实现动态页面静态化

实现动态页面静态化的办法多种多样，这里使用FreeMarker，仅仅提供思路，代码没有封装与优化。

3.3.一、新建一个基于Maven的Web项目

 

 

 

3.3.二、添加依赖

这里没有使用MVC，只需依赖FreeMarker、Servlet与JSP核心包就能够了，修改后的pom.xml文件以下。

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.zhangguo</groupId>
    <artifactId>SpringMVC71</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>war</packaging>
    <dependencies>
        <!-- FreeMarker -->
        <dependency>
            <groupId>org.freemarker</groupId>
            <artifactId>freemarker-gae</artifactId>
            <version>2.3.25-incubating</version>
        </dependency>
        <!-- Servlet核心包 -->
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>javax.servlet-api</artifactId>
            <version>3.0.1</version>
            <scope>provided</scope>
        </dependency>
        <!--JSP -->
        <dependency>
            <groupId>javax.servlet.jsp</groupId>
            <artifactId>jsp-api</artifactId>
            <version>2.1</version>
            <scope>provided</scope>
        </dependency>
    </dependencies>
</project>

依赖成功的结果：

 

 

3.3.三、建立文章POJO类

在src/main/java源代码目录下建立Article.java文件，该类表明文章，代码以下：

 

package com.zhangguo.springmvc71.entities;

/**
 * 文章
 *
 */
public class Article {
    /*
     * 编号
     */
    private int id;
    /*
     * 标题
     */
    private String title;
    /*
     * 内容
     */
    private String content;

    public Article() {
    }

    public Article(int id, String title, String content) {
        super();
        this.id = id;
        this.title = title;
        this.content = content;
    }

    public int getId() {
        return id;
    }

    public void setId(int id) {
        this.id = id;
    }

    public String getTitle() {
        return title;
    }

    public void setTitle(String title) {
        this.title = title;
    }

    public String getContent() {
        return content;
    }

    public void setContent(String content) {
        this.content = content;
    }

    @Override
    public String toString() {
        return "Article [id=" + id + ", title=" + title + ", content=" + content + "]";
    }
}

3.3.四、建立文章业务类

在src/main/java源代码目录下建立ArticleService.java文件，该类表明文章业务，主要提供文章数据，定义了一个文章集合中，初始化时向集合中随意添加了5个文章对象，代码以下：

 

package com.zhangguo.springmvc71.Services;

import java.util.ArrayList;
import java.util.List;
import com.zhangguo.springmvc71.entities.Article;

/**
 * 文章业务类（模拟）
 *
 */
public class ArticleService {
    private static List<Article> articles;

    static {
        articles = new ArrayList<Article>();
        articles.add(new Article(20160701, "不明真相的美国人被UFO惊呆了 实际上是长征7号","据美国《洛杉矶时报》报道，当地时间周三晚(北京时间周四)，在美国中西部的犹他州、内华达州、加利福利亚州，数千人被划过夜空的神秘火球吓到"));
        articles.add(new Article(20160702, "法国巴黎圣母院为教堂恐袭案遇害神父举行大弥撒", "而据美国战略司令部证明，其实这是中国长征七号火箭从新进入大气层，恰好通过加利福利亚附近。"));
        articles.add(new Article(20160703, "日东京知事候选人小池百合子回击石原：浓妆能够", "然而昨晚的美国人民可不明真相，有些人甚至怀疑这些火球是飞机解体，还有些人猜想是流星雨。"));
        articles.add(new Article(20160704, "日资慰安妇基金在首尔成立 韩国示威者闯入抗议","美国战略司令部发言人表示，到目前为止尚未任何受损报告，他说相似物体一般在大气中就会消失，这也解释了为什么出现一道道光痕，这一切都并未形成什么威胁。"));
        articles.add(new Article(20160705, "中日关系正处十字路口日应寻求减小与华冲突","中国长征七号火箭6月25日在海南文昌航天发射中心首次发射，并成功升空进入轨道。有学者指出长征七号第二级火箭一直在地球低轨运行，一个月后从新进入大气层。"));
    }

    /**
     * 全部的文章
     */
    public List<Article> getArticles() {
        return articles;
    }
    
    /*
     * 得到文章经过文章编号
     */
    public Article getArticle(int id) {
        for (Article article : articles) {
            if (article.getId() == id) {
                return article;
            }
        }
        return null;
    }
}
复制代码

3.3.五、添加模板

在src/main/java源代码目录的templates包下添加两个模板，一个名为newsList.ftl用于生成新闻列表，另外一个名为news.ftl用于生成单篇新闻，newsList.ftl文件内容以下：

<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>新闻焦点</title>
</head>
<body>
    <div id="container">
    <h2>新闻焦点</h2>
    <#setting number_format="#">
    <ul>
        <#list articles as article>
        <li>
            <a href="news/${article.id}.html">${article.title}</a>
        </li>
        </#list>
    </ul>
    </div>
    <style>
       #container{
          font-family:"microsoft yahei";
          width:800px;
          margin:0 auto;
       }
       a{
         color:#333;
         text-decoration:none;
       }
       li{
         height:26px;
         line-height:26px;
       }
    </style>
</body>
</html>

文件中使用了FreeMarker标记，具体语法能够看第四点；news.ftl文件内容以下：

<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>${article.title}</title>
</head>
<body>
    <div id="container">
    <h2>${article.title}</h2>
    <p>
         ${article.content}
    </p>
    </div>
    <style>
       #container{
          font-family:"microsoft yahei";
          width:800px;
          margin:0 auto;
       }
    </style>
</body>
</html>

3.3.六、添加Servlet生成静态页

新增一个名为News的Servlet类，当Servlet收到客户端请求时会查看系统中是否存在index.html（新闻列表）静态页面，若是存在直接转发，若是不存在则生成新闻列表静态页面及子页面。建立好的Servlet代码以下所示：

package com.zhangguo.springmvc71.actions;

import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.OutputStreamWriter;
import java.io.Writer;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import com.zhangguo.springmvc71.Services.ArticleService;
import com.zhangguo.springmvc71.entities.Article;
import freemarker.template.Configuration;
import freemarker.template.Template;
import freemarker.template.TemplateException;

/**
 *新闻列表
 */
@WebServlet("/News")
public class News extends HttpServlet {
    private static final long serialVersionUID = 1L;
    
    ArticleService articleService=new ArticleService();
    protected void doGet(HttpServletRequest request, HttpServletResponse response) throws IOException, ServletException{
        //设置编码格式与MIME类型
        response.setContentType("text/html; charset=UTF-8");
        
        //首页新闻列表路径
        String indexPath=request.getServletContext().getRealPath("/index.html");
        
        //文件是否存在
        File file=new File(indexPath);
        if(!file.exists()){
            //若是新闻列表不存在，生成新闻列表
            
            //建立一个freemarker.template.Configuration实例，它是存储 FreeMarker 应用级设置的核心部分
            //指定版本号
            Configuration cfg=new Configuration(Configuration.VERSION_2_3_22);
            //得到模板文件路径
            String templatePath=this.getClass().getClassLoader().getResource("/templates").getPath();
            //设置模板目录
            cfg.setDirectoryForTemplateLoading(new File(templatePath));
            //设置默认编码格式
            cfg.setDefaultEncoding("UTF-8");
            
            //数据
            Map<String, Object> articleData = new HashMap<>();
            List<Article> articles=articleService.getArticles();
            articleData.put("articles", articles);
            
            //从设置的目录中得到模板
            Template template = cfg.getTemplate("newsList.ftl");
            
            //合并模板和数据模型
            try {
                //将数据与模板渲染的结果写入文件中
                Writer writer=new OutputStreamWriter(new FileOutputStream(file), "UTF-8");
                template.process(articleData, writer);
                writer.flush();
                
                articleData.clear();
                template = cfg.getTemplate("news.ftl");
                //生成单个新闻文件
                for (Article article : articles) {
                    articleData.put("article", article);
                    //单个新闻文件
                    file=new File(request.getServletContext().getRealPath("/news/"+article.getId()+".html"));
                    //文件输出流写入器
                    writer=new OutputStreamWriter(new FileOutputStream(file), "UTF-8");
                    //将模板+数据生成的结果写入文件中，获得一个静态文件
                    template.process(articleData, writer);
                    writer.flush();
                }
                writer.close();
            } catch (TemplateException e) {
                e.printStackTrace();
            }
        }
        //若是新闻单页下存在，生成新闻单页
        request.getRequestDispatcher("index.html").forward(request, response);
    }

    protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        doGet(request, response);
    }

}

从代码中能够看出生成的单篇文章所有存放在news目录下，要记得在webapp根目录下建立news目录。这里只是示例代码，若是要在项目中应用，应该把FreeMarker，文件操做的内容分Servlet分开。另外web.xml文件中添加index.html为第1个欢迎页，这样作的目的是当首页被生成时直接让服务器响应index.html。web.xml文件以下：

 

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns="http://java.sun.com/xml/ns/javaee"
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
    id="WebApp_ID" version="3.0">
    <welcome-file-list>
        <welcome-file>index.html</welcome-file>
        <welcome-file>index.jsp</welcome-file>
    </welcome-file-list>
</web-app>

index.jsp直接转发到News Servlet中，文件内容以下：

 

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<jsp:forward page="News"></jsp:forward>

3.3.七、运行结果

 

 

 

 

 

3.3.八、小结

再次强调这只是一个示例；另外你可能会想到FreeMarker在这里的做用感受不大，若是咱们使用一些特别的标记嵌套在静态的页面中，而后后台替换其实一样能够作到，确实这样也能够，但对于复杂的内容FreeMarker替换的方式要更加优雅，效率要更高，若是你使用jsp做为模板效果也是同样的，只是他们的侧重点不同而已，有点想念razor了。

4、FreeMarker模板语法

要编写复杂的模板须要熟悉FreeMarker语法规则，官网有详细说明，中文帮助也比较详细了，下面这些内容是从网上收罗来的，感谢网友的分享，通过整理与修改的内容以下。建议直接看官网的文档。

4.0、模板文件的4个组成部分

FreeMarker模板文件主要由以下4个部分组成:

1,文本:直接输出的部分

2,注释:<#-- ... -->格式部分,不会输出

3,插值:即${...}或#{...}格式的部分,将使用数据模型中的部分替代输出

4,FTL指令:FreeMarker指定,和HTML标记相似,名字前加#予以区分,不会输出

下面是一个FreeMarker模板的例子,包含了以上所说的4个部分

 

<html>
<head>
<title>Welcome!</title>
</head>
<body>
<#--下面是文本将直接输出-->
Hello FreeMarker
<#-- 注释部分 -->
<#-- 下面使用插值 -->
<h1>Welcome ${user} !</h1>
<u1>
<#-- 使用FTL指令 -->
<#list animals as being>
   <li>${being.name} for ${being.price} Euros
<#list>
<u1>
</body>
</html>

 

 

4.一、FTL指令规则

在FreeMarker中,使用FTL标签来使用指令,FreeMarker有3种FTL标签,这和HTML标签是彻底相似的.
1.开始标签:<#指令名 参数> 如<#list users as user>
2.结束标签:</#指令名> 如</#list>
3.单标签:<#指令名 参数/>

实际上,使用标签时前面的符号#也可能变成@,若是该指令是一个用户指令而不是系统内建指令时,应将#符号改为@符号.
使用FTL标签时,应该有正确的嵌套,而不是交叉使用,这和XML标签的用法彻底同样.若是全用不存在的指令,FreeMarker不会使用模板输出,而是产生一个错误消息.FreeMarker会忽略FTL标签中的空白字符.值得注意的是< , /> 和指令之间不容许有空白字符.

4.二、 插值规则

FreeMarker的插值有以下两种类型:

一、通用插值${expr};

二、数字格式化插值:#{expr}或#{expr;format}

能够简单理解为输出表达式

4.2.1 通用插值

对于通用插值,又能够分为如下4种状况:

一、插值结果为字符串值:直接输出表达式结果

二、插值结果为数字值:根据默认格式(由#setting指令设置)将表达式结果转换成文本输出.可使用内建的字符串函数格式化单个插值,以下面的例子:

<#setting number_format="currency"/> <#-- 设置数字格式为货币 -->

<#assign answer=42/>  <#-- 赋值 -->

${answer} <#-- 输出 -->

${answer?string} <#-- 输出格式为字符类型，与上面相同-->

${answer?string.number} <#-- 输出格式为数字类型-->

${answer?string.currency} <#-- 输出格式为货币类型-->

${answer?string.percent} <#-- 输出格式为百分比类型-->

输出结果是:

$42.00

$42.00

42

$42.00

4,200%

3,插值结果为日期值:根据默认格式(由#setting指令设置)将表达式结果转换成文本输出.可使用内建的字符串函数格式化单个插值,以下面的例子:

${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')'")}

输出结果是:

2008-04-08 08:08:08 Pacific Daylight Time

Tue, Apr 8, '03

Tuesday, April 08, 2003, 08:08:08 PM (PDT)

4,插值结果为布尔值:根据默认格式(由#setting指令设置)将表达式结果转换成文本输出.可使用内建的字符串函数格式化单个插值,以下面的例子:

<#assign foo=true/>
${foo?string("yes", "no")}
输出结果是:
yes

4.2.2 数字格式化插值

数字格式化插值可采用#{expr;format}形式来格式化数字,其中format能够是:
mX:小数部分最小X位
MX:小数部分最大X位
以下面的例子:
<#assign x=2.582/>
<#assign y=4/>
#{x; M2}
#{y; M2}
#{x; m2}
#{y; m2}
#{x; m1M2}
#{x; m1M2} 

输出结果：

2.58 
4 
2.58 
4.00 
2.58 
2.58

4.三、表达式

表达式是FreeMarker模板的核心功能,表达式放置在插值语法${}之中时,代表须要输出表达式的值;表达式语法也可与FreeMarker标签结合,用于控制输出.实际上FreeMarker的表达式功能很是强大,它不只支持直接指定值,输出变量值,也支持字符串格式化输出和集合访问等功能.

4.3.一、直接指定值

使用直接指定值语法让FreeMarker直接输出插值中的值,而不是输出变量值.直接指定值能够是字符串,数值,布尔值,集合和MAP对象.

1,字符串
直接指定字符串值使用单引号或双引号限定,若是字符串值中包含特殊字符须要转义,看下面的例子:
我的文件保存在盘"个人文件保存在C:盘"{'我名字是\"annlee\"'}
输出结果是: 
个人文件保存在C:\盘
我名字是"annlee"

FreeMarker支持以下转义字符:
\";双引号(u0022)
\';单引号(u0027)
\\;反斜杠(u005C)
\n;换行(u000A)
\r;回车(u000D)
\t;Tab(u0009)
\b;退格键(u0008)
\f;Form feed(u000C)
\l;<
\g;>
\a;&
\{;{
\xCode;直接经过4位的16进制数来指定Unicode码,输出该unicode码对应的字符.

若是某段文本中包含大量的特殊符号,FreeMarker提供了另外一种特殊格式:能够在指定字符串内容的引号前增长r标记,在r标记后的文件将会直接输出.看以下代码:
r"$foo"{r"C:\foo\bar"}
输出结果是:
${foo}
C:\foo\bar

二、数值
表达式中的数值直接输出,不须要引号.小数点使用"."分隔,不能使用分组","符号.FreeMarker目前还不支持科学计数法,因此"1E3"是错误的.在FreeMarker表达式中使用数值须要注意如下几点:
一、数值不能省略小数点前面的0,因此".5"是错误的写法
二、数值8 , +8 , 8.00都是相同的

三、布尔值
直接使用true和false,不使用引号.

四、集合
集合以方括号包括,各集合元素之间以英文逗号","分隔,看以下的例子:
<#list ["星期一", "星期二", "星期三", "星期四", "星期五", "星期六", "星期天"] as week>
${week}
</#list>
输出结果是:
星期一
星期二
星期三
星期四
星期五
星期六
星期天

除此以外,集合元素也能够是表达式,例子以下:
[2 + 2, [1, 2, 3, 4], "whatnot"]

还可使用数字范围定义数字集合,如2..5等同于[2, 3, 4, 5],可是更有效率.注意,使用数字范围来定义集合时无需使用方括号,数字范围也支持反递增的数字范围,如5..2

5,Map对象
Map对象使用花括号包括,Map中的key-value对之间以英文冒号":"分隔,多组key-value对之间以英文逗号","分隔.下面是一个例子:
{"语文":78, "数学":80}
Map对象的key和value都是表达式,可是key必须是字符串

4.3.二、输出变量值

FreeMarker的表达式输出变量时,这些变量能够是顶层变量,也能够是Map对象中的变量,还能够是集合中的变量,并可使用点(.)语法来访问Java对象的属性.下面分别讨论这些状况

一、顶层变量
所谓顶层变量就是直接放在数据模型中的值,例若有以下数据模型:
Map root = new HashMap();   //建立数据模型
root.put("name","annlee");   //name是一个顶层变量

对于顶层变量,直接使用来输出变量值变量名只能是字母数字下划线variableName来输出变量值,变量名只能是字母,数字,下划线,,@和#的组合,且不能以数字开头号.为了输出上面的name的值,可使用以下语法:
${name}

二、输出集合元素
若是须要输出集合元素,则能够根据集合元素的索引来输出集合元素,集合元素的索引以方括号指定.假设有索引:
["星期一","星期二","星期三","星期四","星期五","星期六","星期天"].该索引名为week,若是须要输出星期三,则可使用以下语法:
${week[2]}   //输出第三个集合元素

此外,FreeMarker还支持返回集合的子集合,若是须要返回集合的子集合,则可使用以下语法:
week[3..5]   //返回week集合的子集合,子集合中的元素是week集合中的第4-6个元素

三、输出Map元素
这里的Map对象能够是直接HashMap的实例,甚至包括JavaBean实例,对于JavaBean实例而言,咱们同样能够把其当成属性为key,属性值为value的Map实例.为了输出Map元素的值,可使用点语法或方括号语法.假若有下面的数据模型:
Map root = new HashMap();
Book book = new Book();
Author author = new Author();
author.setName("annlee");
author.setAddress("gz");
book.setName("struts2");
book.setAuthor(author);
root.put("info","struts");
root.put("book", book);

为了访问数据模型中名为struts2的书的做者的名字,可使用以下语法:
book.author.name    //所有使用点语法
book["author"].name
book.author["name"]    //混合使用点语法和方括号语法
book["author"]["name"]   //所有使用方括号语法

使用点语法时,变量名字有顶层变量同样的限制,但方括号语法没有该限制,由于名字能够是任意表达式的结果.

4.3.三、字符串操做

FreeMarker的表达式对字符串操做很是灵活,能够将字符串常量和变量链接起来,也能够返回字符串的子串等.

字符串链接有两种语法:
一、使用${..}或#{..}在字符串常量部分插入表达式的值,从而完成字符串链接.
二、直接使用链接运算符+来链接字符串

例若有以下数据模型:
Map root = new HashMap();

root.put("user","annlee");
下面将user变量和常量链接起来:
使用第一种语法来连接"hello,$user!"//使用第一种语法来链接{"hello, " + user + "!"} //使用+号来链接
上面的输出字符串都是hello,annlee!,能够看出这两种语法的效果彻底同样.

值得注意的是,{..}只能用于文本部分,不能用于表达式,下面的代码是错误的: <#if{..}只能用于文本部分,不能用于表达式,下面的代码是错误的: <#if{isBig}>Wow!</#if>
<#if "${isBig}">Wow!</#if>
应该写成:<#if isBig>Wow!</#if>

截取子串能够根据字符串的索引来进行,截取子串时若是只指定了一个索引值,则用于取得字符串中指定索引所对应的字符;若是指定两个索引值,则返回两个索引中间的字符串子串.假若有以下数据模型:
Map root = new HashMap();

root.put("book","struts2,freemarker");
能够经过以下语法来截取子串:
book[0]{book[4]}   //结果是st
${book[1..4]}     //结果是trut

4.3.四、集合链接运算符

这里所说的集合运算符是将两个集合链接成一个新的集合,链接集合的运算符是+,看以下的例子:
<#list ["星期一","星期二","星期三"] + ["星期四","星期五","星期六","星期天"] as week>
${week}
</#list>
输出结果是:星期一 星期二 星期三 星期四 星期五 星期六 星期天

4.3.五、Map链接运算符

Map对象的链接运算符也是将两个Map对象链接成一个新的Map对象,Map对象的链接运算符是+,若是两个Map对象具备相同的key,则右边的值替代左边的值.看以下的例子:
<#assign scores = {"语文":86,"数学":78} + {"数学":87,"Java":93}>
语文成绩是语文数学成绩是scores.语文数学成绩是{scores.数学}
Java成绩是${scores.Java}

输出结果是:

语文成绩是86
数学成绩是87
Java成绩是93

4.3.六、算术运算符

FreeMarker表达式中彻底支持算术运算,FreeMarker支持的算术运算符包括:+, - , * , / , % 看以下的代码:
<#assign x=5>
x∗x−100{ x /2 }
${ 12 %10 }
输出结果是:

-75
2.5
2

在表达式中使用算术运算符时要注意如下几点:
一、运算符两边的运算数字必须是数字
二、使用+运算符时,若是一边是数字,一边是字符串,就会自动将数字转换为字符串再链接,如:${3 + "5"},结果是:35

使用内建的int函数可对数值取整,如:
<#assign x=5>
(x/2)?int{ 1.1?int }
1.999?int{ -1.1?int }
${ -1.999?int }
结果是:

2
1
1
-1
-1

4.3.七、比较运算符

表达式中支持的比较运算符有以下几个:
1,=或者==:判断两个值是否相等.
2,!=:判断两个值是否不等.
3,>或者gt:判断左边值是否大于右边值
4,>=或者gte:判断左边值是否大于等于右边值
5,<或者lt:判断左边值是否小于右边值
6,<=或者lte:判断左边值是否小于等于右边值

注意:=和!=能够用于字符串,数值和日期来比较是否相等,但=和!=两边必须是相同类型的值,不然会产生错误,并且FreeMarker是精确比较,"x","x ","X"是不等的.其它的运行符能够做用于数字和日期,但不能做用于字符串,大部分的时候,使用gt等字母运算符代替>会有更好的效果,由于FreeMarker会把>解释成FTL标签的结束字符,固然,也可使用括号来避免这种状况,如:<#if (x>y)>

4.3.八、逻辑运算符

逻辑运算符有以下几个:
逻辑与:&&
逻辑或:||
逻辑非:!
逻辑运算符只能做用于布尔值,不然将产生错误

4.3.九、内建函数

FreeMarker还提供了一些内建函数来转换输出,能够在任何变量后紧跟?,?后紧跟内建函数,就能够经过内建函数来轮换输出变量.下面是经常使用的内建的字符串函数:
html:对字符串进行HTML编码
cap_first:使字符串第一个字母大写
lower_case:将字符串转换成小写
upper_case:将字符串转换成大写
trim:去掉字符串先后的空白字符

下面是集合的经常使用内建函数
size:获取序列中元素的个数

下面是数字值的经常使用内建函数
int:取得数字的整数部分,结果带符号

例如:
<#assign test="Tom & Jerry">
test?html{test?upper_case?html}
结果是:

Tom &amp; Jerry
TOM &amp; JERRY

4.3.十、空值处理运算符

FreeMarker对空值的处理很是严格,FreeMarker的变量必须有值,没有被赋值的变量就会抛出异常,由于FreeMarker未赋值的变量强制出错能够杜绝不少潜在的错误,如缺失潜在的变量命名,或者其余变量错误.这里所说的空值,实际上也包括那些并不存在的变量,对于一个Java的null值而言,咱们认为这个变量是存在的,只是它的值为null,但对于FreeMarker模板而言,它没法理解null值,null值和不存在的变量彻底相同.

为了处理缺失变量,FreeMarker提供了两个运算符:
!:指定缺失变量的默认值
??:判断某个变量是否存在

其中,!运算符的用法有以下两种:
variable!或variable!defaultValue,第一种用法不给缺失的变量指定默认值,代表默认值是空字符串,长度为0的集合,或者长度为0的Map对象.

使用!指定默认值时,并不要求默认值的类型和变量类型相同.使用??运算符很是简单,它老是返回一个布尔值,用法为:variable??,若是该变量存在,返回true,不然返回false

示例：

${tom!"tom is missed"}
<#if !jack??>jack is missed</#if>

输出：

tom is missed
jack is missed

4.3.十一、运算符的优先级

FreeMarker中的运算符优先级以下(由高到低排列):
1,一元运算符:!
2,内建函数:?
3,乘除法:*, / , %
4,加减法:- , +
5,比较:> , < , >= , <= (lt , lte , gt , gte)
6,相等:== , = , !=
7,逻辑与:&&
8,逻辑或:||
9,数字范围:..

实际上,咱们在开发过程当中应该使用括号来严格区分,这样的可读性好,出错少

4.四、FreeMarker的经常使用指令

FreeMarker的FTL指令也是模板的重要组成部分,这些指令可实现对数据模型所包含数据的抚今迭代,分支控制.除此以外,还有一些重要的功能,也是经过FTL指令来实现的.

4.4.一、if指令

这是一个典型的分支控制指令,该指令的做用彻底相似于Java语言中的if,if指令的语法格式以下:
<#if condition>...
<#elseif condition>...
<#elseif condition>...
<#else> ...
</#if>

例子以下:
<#assign age=23>
<#if (age>60)>老年人
<#elseif (age>40)>中年人
<#elseif (age>20)>青年人
<#else> 少年人
</#if>
输出结果是:青年人
上面的代码中的逻辑表达式用括号括起来主要是由于里面有>符号,因为FreeMarker会将>符号当成标签的结束字符,可能致使程序出错,为了不这种状况,咱们应该在凡是出现这些符号的地方都使用括号.

4.4.二、switch , case , default , break指令

这些指令显然是分支指令,做用相似于Java的switch语句,switch指令的语法结构以下:
<#switch value>
<#case refValue>...<#break>
<#case refValue>...<#break>
<#default>...
</#switch>

示例：

<#assign level=1>
<#switch level>
<#case 1>A级<#break>
<#case 2>B级<#break>
<#case 3>C级<#break>
<#default>未知级别
</#switch>

输出：

A级

4.4.三、list, break指令

list指令是一个迭代输出指令,用于迭代输出数据模型中的集合,list指令的语法格式以下:
<#list sequence as item>
...
</#list>
上面的语法格式中,sequence就是一个集合对象,也能够是一个表达式,但该表达式将返回一个集合对象,而item是一个任意的名字,就是被迭代输出的集合元素.此外,迭代集合对象时,还包含两个特殊的循环变量:
item_index:当前变量的索引值
item_has_next:是否存在下一个对象
也可使用<#break>指令跳出迭代

示例:

<#list ["星期一", "星期二", "星期三", "星期四", "星期五", "星期六", "星期天"] as week>
weekindex+1.{week}<#if week_has_next>,</#if>
<#if week="星期四"><#break></#if>
</#list>

输出结果:

1.星期一,
2.星期二,
3.星期三,
4.星期四,

4.4.四、include指令

include指令的做用相似于JSP的包含指令,用于包含指定页.include指令的语法格式以下:
<#include filename [options]>
在上面的语法格式中,两个参数的解释以下:
filename:该参数指定被包含的模板文件
options:该参数能够省略,指定包含时的选项,包含encoding和parse两个选项,其中encoding指定包含页面时所用的解码集,而parse指定被包含文件是否做为FTL文件来解析,若是省略了parse选项值,则该选项默认是true.

4.4.五、import指令

该指令用于导入FreeMarker模板中的全部变量,并将该变量放置在指定的Map对象中,import指令的语法格式以下:
<#import "/lib/common.ftl" as com>
上面的代码将导入/lib/common.ftl模板文件中的全部变量,交将这些变量放置在一个名为com的Map对象中.

4.4.六、noparse指令

noparse指令指定FreeMarker不处理该指定里包含的内容,该指令的语法格式以下:
<#noparse>...</#noparse>

看以下的例子:
<#noparse>
<#list books as book>
   <tr><td>做者book.name<td>做者:{book.author}
</#list>
</#noparse>
输出以下:
<#list books as book>
   <tr><td>做者book.name<td>做者:{book.author}
</#list>

4.4.七、escape , noescape指令

escape指令致使body区的插值都会被自动加上escape表达式,但不会影响字符串内的插值,只会影响到body内出现的插值,使用escape指令的语法格式以下:
<#escape identifier as expression>...
<#noescape>...</#noescape>
</#escape>

看以下的代码:
<#escape x as x?html>
First name:firstNameLastname:{lastName}
Maiden name:{maidenName} </#escape> 上面的代码等同于: First name:{maidenName} </#escape> 上面的代码等同于: First name:{firstName?html}
Last name:lastName?htmlMaidenname:{maidenName?html}

escape指令在解析模板时起做用而不是在运行时起做用,除此以外,escape指令也嵌套使用,子escape继承父escape的规则,以下例子:
<#escape x as x?html>
Customer Name:{customerName} Items to ship; <#escape x as itemCodeToNameMap[x]>{customerName} Items to ship; <#escape x as itemCodeToNameMap[x]>{itemCode1}
   itemCode2{itemCode3}
   {itemCode4} </#escape> </#escape> 上面的代码相似于: Customer Name:{itemCode4} </#escape> </#escape> 上面的代码相似于: Customer Name:{customerName?html}
Items to ship;
itemCodeToNameMap[itemCode1]?html{itemCodeToNameMap[itemCode2]?html}
itemCodeToNameMap[itemCode3]?html{itemCodeToNameMap[itemCode4]?html}

对于放在escape指令中全部的插值而言,这此插值将被自动加上escape表达式,若是须要指定escape指令中某些插值无需添加escape表达式,则应该使用noescape指令,放在noescape指令中的插值将不会添加escape表达式.

4.4.八、assign指令

assign指令在前面已经使用了屡次,它用于为该模板页面建立或替换一个顶层变量,assign指令的用法有多种,包含建立或替换一个顶层变量,或者建立或替换多个变量等,它的最简单的语法以下:<#assign name=value [in namespacehash]>,这个用法用于指定一个名为name的变量,该变量的值为value,此外,FreeMarker容许在使用assign指令里增长in子句,in子句用于将建立的name变量放入namespacehash命名空间中.

assign指令还有以下用法:<#assign name1=value1 name2=value2 ... nameN=valueN [in namespacehash]>,这个语法能够同时建立或替换多个顶层变量,此外,还有一种复杂的用法,若是须要建立或替换的变量值是一个复杂的表达式,则可使用以下语法格式:<#assign name [in namespacehash]>capture this</#assign>,在这个语法中,是指将assign指令的内容赋值给name变量.以下例子:
<#assign weeks>
<#list ["星期一", "星期二", "星期三", "星期四", "星期五", "星期六", "星期天"] as n>
{n} </#list> </#assign>{n} </#list> </#assign>{weeks}
上面的代码将产生以下输出:星期一 星期二 星期三 星期四 星期五 星期六 星期天

虽然assign指定了这种复杂变量值的用法,可是咱们也不要滥用这种用法,以下例子:<#assign x>Hello {user}!</#assign>,以上代码改成以下写法更合适:<#assign x="Hello{user}!</#assign>,以上代码改成以下写法更合适:<#assign x="Hello{user}!">

4.4.九、setting指令

该指令用于设置FreeMarker的运行环境,该指令的语法格式以下:<#setting name=value>,在这个格式中,name的取值范围包含以下几个:
locale:该选项指定该模板所用的国家/语言选项
number_format:指定格式化输出数字的格式
boolean_format:指定两个布尔值的语法格式,默认值是true,false
date_format,time_format,datetime_format:指定格式化输出日期的格式
time_zone:设置格式化输出日期时所使用的时区

4.4.十、macro , nested , return指令

macro能够用于实现自定义指令,经过使用自定义指令,能够将一段模板片断定义成一个用户指令,使用macro指令的语法格式以下:
<#macro name param1 param2 ... paramN>
...
<#nested loopvar1, loopvar2, ..., loopvarN>
...
<#return>
...
</#macro>
在上面的格式片断中,包含了以下几个部分:
name:name属性指定的是该自定义指令的名字,使用自定义指令时能够传入多个参数
paramX:该属性就是指定使用自定义指令时报参数,使用该自定义指令时,必须为这些参数传入值
nested指令:nested标签输出使用自定义指令时的中间部分
nested指令中的循环变量:这此循环变量将由macro定义部分指定,传给使用标签的模板
return指令:该指令可用于随时结束该自定义指令.

看以下的例子:
<#macro book>   //定义一个自定义指令
j2ee
</#macro>
<@book />    //使用刚才定义的指令
上面的代码输出结果为:j2ee

在上面的代码中,可能很难看出自定义标签的用处,由于咱们定义的book指令所包含的内容很是简单,实际上,自定义标签可包含很是多的内容,从而能够实现更好的代码复用.此外,还能够在定义自定义指令时,为自定义指令指定参数,看以下代码:
<#macro book booklist>     //定义一个自定义指令booklist是参数
<#list booklist as book>
   ${book}
</#list>
</#macro>
<@book booklist=["spring","j2ee"] />   //使用刚刚定义的指令
上面的代码为book指令传入了一个参数值,上面的代码的输出结果为:spring j2ee

不只如此,还能够在自定义指令时使用nested指令来输出自定义指令的中间部分,看以下例子:
<#macro page title>
<html>
<head>
   <title>FreeMarker示例页面 - title?html</title></head><body><h1>{title?html}</h1>
   <#nested>      //用于引入用户自定义指令的标签体
</body>
</html>
</#macro>
上面的代码将一个HTML页面模板定义成一个page指令,则能够在其余页面中如此page指令:
<#import "/common.ftl" as com>     //假设上面的模板页面名为common.ftl,导入页面
<@com.page title="book list">
<u1>
<li>spring</li>
<li>j2ee</li>
</ul>
</@com.page>

从上面的例子能够看出,使用macro和nested指令能够很是容易地实现页面装饰效果,此外,还能够在使用nested指令时,指定一个或多个循环变量,看以下代码:
<#macro book>
<#nested 1>      //使用book指令时指定了一个循环变量值
<#nested 2>
</#macro>
<@book ;x> ${x} .图书</@book>
当使用nested指令传入变量值时,在使用该自定义指令时,就须要使用一个占位符(如book指令后的;x).上面的代码输出文本以下:
1 .图书    2 .图书

在nested指令中使用循环变量时,可使用多个循环变量,看以下代码:

<#macro repeat count>
<#list 1..count as x> 
<#nested x, x/2, x==count>
</#list>
</#macro>

<@repeat count=4 ;c,halfc,last>
c.{halfc}<#if last> Last! </#if>
</@repeat>


输出结果:

1. 0.5
2. 1
3. 1.5
4. 2 Last!

return指令用于结束macro指令,一旦在macro指令中执行了return指令,则FreeMarker不会继续处理macro指令里的内容,看以下代码:
<#macro book>
spring
<#return>
j2ee
</#macro>
<@book />
上面的代码输出:spring,而j2ee位于return指令以后,不会输出。

5、示例下载

点击下载

github下载或预览代码

联系我们 沪ICP备13005482号-10