`

freemarker使用方法讲解

阅读更多

FreeMarker简介

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

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

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

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

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

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

<html><br>

<head><br>

<title>Welcome!</title><br>

</head><br>

<body><br>

<#-- 注释部分 --><br>

<#-- 下面使用插值 -->

<h1>Welcome $ {user} !</h1><br>

<p>We have these animals:<br>

<u1><br>

<#-- 使用FTL指令 -->

<#list animals as being><br>

   <li>$ {being.name} for $ {being.price} Euros<br>

<#list><br>

<u1><br>

</body><br>

</html>

java程序中使用FreeMarker

FreeMarker的模板就是一个.ftl文本文件,在该文件中使用了一些FreeMarker的特别标记,这些标记会动态显示,或者控制程序输出,如下面的模板文件代码:

$ {name},你好!$ {msg}

这里类似于$ {}的就是动态的内容,称作"插值".

为了使用FreeMarker来将数据模型中的值合并到模板文件中,可按如下步骤进行:

1,创建Configuration实例,该实例负责管理FreeMarker的模板加载路径,负责生成模板实例

2,使用Configuration实例来生成Template实例,同进需要指定使用的模板文件

3,填充数据模型,数据模型就是一个Map对象

4,调用Template实例的process方法完成合并.

下面是一个使用FreeMarker创建输出的Java程序,程序源代码如下:

package lee;

import java.util.*;

import java.io.*;

import freemarker.template.*;

public class HelloFreeMarker

{

    private Configuration cfg;

    public void init() throws Exception

{

        //初始化FreeMarker配置

        //创建一个Configuration实例

        cfg = new Configuration();

        //设置FreeMarker的模版文件位置

        cfg.setDirectoryForTemplateLoading(new File("templates"));

    }

   

public void process()throws Exception

{

        Map root = new HashMap();

        root.put("name", "FreeMarker!");

   root.put("msg" , "您已经完成了第一个FreeMarker的示例");

        Template t = cfg.getTemplate("test.ftl");

        t.process(root, new OutputStreamWriter(System.out));

}

public static void main(String[] args)throws Exception

{

   HelloFreeMarker hf = new HelloFreeMarker();

   hf.init();

   hf.process();

}

}

上面的代码创建了一个Map实例,这个Map将作为模板文件的数据模型,我们要使用FreeMarker必须导入freemarker.jar文件,FreeMarker的官网是http://freemarker.sourceforge.net/,虽然FreeMarker可以在Java程序中使用,但大部分时候还是用来生成HTML页面.

Web应用中使用FreeMarker

Web应用中使用FreeMarker跟在Java程序中使用并没有太大的区别.下面是一个在Web中使用的例子,用来生成HTML页面的模板文件内容如下:

<html>

<head>

<title>FreeMarkerHelloWorld</title>

</head>

<body>

$ {message}

</body>

</html>

我们在Web应用中使用FreeMarker,应该让Servlet来合并模板和数据,因此,Servlet负责创建Configuration实例,并负责合并模板和数据,下面是Servlet源代码:

package lee;

import java.util.*;

import java.io.*;

import javax.servlet.*;

import javax.servlet.http.*;

import freemarker.template.*;

public class HelloServlet extends HttpServlet

{

    private Configuration cfg;

    public void init()

{

        //初始化FreeMarker配置

        //创建一个Configuration实例

        cfg = new Configuration();

        //设置FreeMarker的模版文件位置

        cfg.setServletContextForTemplateLoading(getServletContext(), "WEB-INF/templates");

    }

   

    public void service(HttpServletRequest request, HttpServletResponse response)

        throws ServletException, IOException

{       

        //建立数据模型

        Map root = new HashMap();

        root.put("message", "Hello FreeMarker!");    

        //取得模版文件

        Template t = cfg.getTemplate("test.ftl");       

        // 开始准备生成输出

        // - 使用模版文件的charset作为本页面的charset

        // - 使用text/html MIME-type

        response.setContentType("text/html; charset=" + t.getEncoding());

        Writer out = response.getWriter();

       

        //合并数据模型和模版,并将结果输出到out

        try

   {

            t.process(root, out);

        }

   catch (TemplateException e)

   {

            throw new ServletException("处理Template模版中出现错误", e);

        }

    }

}

可以看到这个Servlet类的代码与普通的Java程序中使用FreeMarker大致一样,区别有两个:1,设置FreeMarker加载模板的方法不一样,Servlet中设置加载的方法是setServletContextForTemplateLoading,第一个参数是本web应用的ServletContext,第二个参数是模板文件的路径.;2,结果必须输出到HttpServletResponse,才能被浏览器加载.

配置Servletweb.xml文件中的代码如下:

<web-app>

<servlet>

   <servlet-name>hello</servlet-name>

   <servlet-class>lee.HelloServlet</servlet-class>

</servlet>

<servlet-mapping>

   <servlet-name>hello</servlet-name>

   <url-pattern>/hello</url-pattern>

</servlet-mapping>

</web-app>

 

转载请注明出处: 程序员之家  http://www.sunxin.org/

分享到:
评论

相关推荐

    超强freemarker使用总结,有示例有讲解,可做快速查询手册!!

    接下来我们通过一个具体的示例来理解 Freemarker 的使用方法: ```html &lt;title&gt;Welcome! &lt;!-- 注释部分 --&gt; &lt;h1&gt;Welcome ${user}! &lt;p&gt;We have these animals: ${being.name} for ${being.price} Euros...

    FreeMarker使用手册20191218.pdf

    指令部分包括if、else、elseif、switch、case、list、import、noparse、compress、assign、global、local、setting、macro、function、stop等指令的使用方法。 手册还为开发者提供了在Servlet中使用FreeMarker的...

    freemarker操作手册-完整freemarker教程

    本教程将深入讲解Freemarker的核心概念、语法和实际应用,帮助你全面掌握这个模板语言。 1. **Freemarker简介** - Freemarker是一个开源的、轻量级的模板引擎,其核心功能是将数据模型与HTML模板结合,生成最终的...

    FreeMarker设计指南.ppt

    FreeMarker是一款强大的、开源的模板引擎,...这份“FreeMarker设计指南.ppt”应该会涵盖这些内容,并可能深入讲解每个知识点的应用实例和最佳实践。如果你希望深入学习FreeMarker,这个教程文件将是一个很好的起点。

    FreeMarker实例教程,手把手教你FreeMarker的方方面面

    ### FreeMarker实例教程知识点详解 ...以上知识点覆盖了FreeMarker的主要方面,通过本教程的学习,读者不仅能够掌握FreeMarker的基本使用方法,还能够深入了解其高级特性,为日后解决复杂的Web开发问题打下坚实的基础。

    Freemarker分页

    4. **Freemarker模板**:在Freemarker模板中,你可以使用Struts2提供的`&lt;s:iterator&gt;`标签遍历当前页的数据,同时使用自定义的Freemarker宏或Struts2的`&lt;s:url&gt;`标签生成分页链接。例如,可以创建一个`pagination....

    freemarker学习资料汇总

    此外,还可能讲解Freemarker的模板设计原则和调试方法。 5. **Freemarker教程_中文版.pdf**: 这是另一份中文版的教程,内容可能与前面的文档有所重叠,但可能会提供不同的视角或更详尽的解释。它可能包含...

    使用freemarker 导出word供别人下载

    本示例将详细讲解如何使用Freemarker来导出Word文档,并提供供他人下载的功能。 首先,理解Freemarker的核心概念。Freemarker是一个基于模板的Java库,它与后台数据模型结合,用于生成输出文本。模板是包含动态内容...

    FreeMarker 手册

    FreeMarker的手册是一个详细的指南,它不仅介绍了FreeMarker的基本概念和使用方法,还深入到了高级主题,如自定义指令、命名空间、空白处理等。通过手册的学习,开发者可以掌握如何创建配置实例、定义数据模型、获取...

    SpringBoot+JPA+Freemarker 生成动态SQL

    结合SpringBoot和JPA,我们可以创建一个服务,该服务使用JPA的Repository接口与数据库进行交互,并通过Freemarker生成动态SQL。具体步骤如下: 1. **设置项目**:创建一个SpringBoot项目,添加Spring Data JPA和...

    FreeMarker 中文教程 用于 FreeMarker 2.3.19

    ### FreeMarker 中文教程知识点概览 #### 一、FreeMarker 概述 ...通过以上知识点的概览,读者可以全面了解 FreeMarker 的基本概念、使用方法及高级特性,为后续深入学习和应用 FreeMarker 奠定坚实的基础。

    freemarker入门文档及例子

    1. 用户列表展示:一个简单的例子,展示如何使用Freemarker遍历用户列表并显示用户信息,如用户名、邮箱等。 2. 动态生成邮件:另一个实例可能是创建一个模板,动态地根据用户数据生成个性化的电子邮件内容,如问候...

    Freemarker教程(中文版)

    教程还会深入讲解Freemarker的高级特性,如宏、指令、模板继承和布局等,这些都是构建复杂模板结构的关键。 学习Freemarker时,实践是检验理解的最佳方式。尝试创建简单的项目,用Freemarker实现动态页面,逐步熟悉...

    MyEclipse安装freemarker插件

    5. **使用Freemarker**:现在你可以在MyEclipse中创建和编辑Freemarker模板文件(`.ftl`扩展名)。IDE将提供语法高亮、代码提示、错误检查等增强功能,大大提高开发效率。 6. **更新插件**:随着时间推移,插件可能...

    FreeMarker_Manual_zh_CN

    ### FreeMarker知识点详解 #### 一、FreeMarker概述 **FreeMarker** 是一款用Java编写的强大且功能...以上内容涵盖了FreeMarker的核心知识点和技术细节,旨在帮助读者全面理解和掌握FreeMarker的使用方法及最佳实践。

    struts2和freemarker整合

    4. **模板配置**:讲解如何配置FreeMarker,例如设置默认编码、定义自定义函数库等。 5. **高级特性**:涵盖如条件表达式、模板继承、国际化支持等进阶主题。 **Struts2与FreeMarker的整合** Struts2框架允许开发者...

    使用freeMarker模板和Spring boot后端API接口实现查询用户列表的功能。

    下面,我将详细讲解这个过程中的关键知识点。 1. **FreeMarker模板**: FreeMarker是一个Java模板引擎,它能够将数据模型(如Java对象)和HTML模板结合,生成最终的HTML页面。FreeMarker设计的目标是将呈现逻辑从...

    FreeMarker中文版word文档

    #### 四、FreeMarker的基本语法与使用方法 - **变量引用**:在模板中引用变量通常采用`$variableName`的形式。 - **表达式计算**:FreeMarker支持基本的数学运算符(如+、-、*、/)以及其他逻辑运算符。 - **条件...

    springboot集成freemarker和shiro框架

    1. 在FreeMarker模板中使用Shiro标签库:在.ftl文件顶部引入Shiro标签库: ```html ${'@org.apache.shiro.web.tags.ShiroTagLibHandler@getTagLibUri()'}"&gt; ${shiro}" as shiro/&gt; ``` 2. 使用Shiro标签:在模板中...

    freemarker与Struts2.0的dome

    - Freemarker支持MVC设计模式,可以使用`&lt;#assign&gt;`将Model数据绑定到变量,`&lt;#include&gt;`引入Controller生成的部分,保持模板的清晰和可维护性。 7. **异常处理** - 当Freemarker模板中出现错误时,Struts2会捕获...

Global site tag (gtag.js) - Google Analytics