`
no_bao
  • 浏览: 315856 次
  • 性别: Icon_minigender_1
  • 来自: 济南
社区版块
存档分类
最新评论

FreeMarker模板引擎基础应用

阅读更多
    FreeMarker是一个模板引擎,一个基于模板生成文本输出的通用工具,使用纯Java编写,
模板用servlet提供的数据动态地生成 HTML,模板语言是强大的直观的,编译器速度快,
输出接近静态HTML页面的速度。

一.Freemarker模板应用事例。
1.创建模板文件,在/resource/template目录下建立freemarkerLocal.ftl文件。
Java代码 
------------------普通变量获取------------------- 
${user} 
---------获取Map中属性-------------- 
${latestProduct.url} 
${latestProduct.name} 
-------自定义的indexOf方法变量------- 
<#assign x = "something"> 
${indexOf("met", x)} 
${indexOf("foo", x)} 
------自定义的转换器变量(转换小写为大写,以标签形式展现)---------------- 
blah1 
<@upperCase> 
blah2 
blah3 
</@upperCase> 
blah4 
---------------共享变量的获取,在Configuration中设置--------------- 
<@to_upper> 
${company} 
</@to_upper> 

2.代码解析模板文件输出。
Java代码 
public class FreemarkerLocalTest { 
     
    public static void main(String[] args) throws Exception { 
        /* 一般在应用的整个生命周期中你仅需要执行一下代码一次*/ 
        /* 创建一个合适的configuration */ 
        Configuration cfg = new Configuration(); 
         
        // 设置模板加载的方式 
        cfg.setDirectoryForTemplateLoading( 
                new File("D:/myspace/freemarker/resource/template")); 
        // 方式二(从Web上下文获取) 
        // void setServletContextForTemplateLoading(Object servletContext, String path); 
         
        // 设置模板共享变量,所有的模板都可以访问设置的共享变量 
        cfg.setSharedVariable("to_upper", new UpperCaseTransform()); 
        cfg.setSharedVariable("company","FooInc."); 
         
        // 指定模板如何查看数据模型 
        cfg.setObjectWrapper(new DefaultObjectWrapper());            
         
        // 如果从多个位置加载模板,可采用以下方式 
        /**
        FileTemplateLoader ftl1 = new FileTemplateLoader(new File("/tmp/templates"));
        FileTemplateLoader ftl2 = new FileTemplateLoader(new File("/usr/data/templates"));
        ClassTemplateLoader ctl = new ClassTemplateLoader(getClass(),"");
        TemplateLoader[] loaders = new TemplateLoader[] { ftl1, ftl2,ctl };
        MultiTemplateLoader mtl = new MultiTemplateLoader(loaders);
        cfg.setTemplateLoader(mtl);**/ 
         
        /* 而以下代码你通常会在一个应用生命周期中执行多次*/ 
        /*获取或创建一个模版*/ 
        Template temp = cfg.getTemplate("freemarkerLocal.ftl"); 
         
        /*创建一个数据模型Create a data model */ 
        Map root = new HashMap(); 
        root.put("user", "Big Joe"); 
        Map latest = new HashMap(); 
        root.put("latestProduct", latest); 
        latest.put("url", "products/greenmouse.html"); 
        latest.put("name", "green mouse"); 
         
        // 方法变量,indexOf为自己定义的方法变量 
        root.put("indexOf", new IndexOfMethod()); 
         
        // 转换器变量 
        root.put("upperCase", new UpperCaseTransform());     
         
        /* 合并数据模型和模版*/ 
        Writer out = new OutputStreamWriter(System.out); 
        temp.process(root, out); 
        out.flush(); 
    } 


3.自定义的方法变量类IndexOfMethod
Java代码 
public class IndexOfMethod implements TemplateMethodModel { 
     
    public Object exec(List args) throws TemplateModelException {        
        if (args.size() != 2) { 
            throw new TemplateModelException("Wrong arguments"); 
        } 
        // 返回第一个字符串首次出现在第二个字符串的位置 
        return new SimpleNumber(((String) args.get(1)) 
                                .indexOf((String) args.get(0))); 
    } 


4.自定义的转换器变量类UpperCaseTransform
Java代码 
/**
* 转换器变量,自定义自己的转换器标签
*/ 
import freemarker.template.TemplateTransformModel; 
 
public class UpperCaseTransform implements TemplateTransformModel { 
     
    // 转换器接口方法,将会转换标签之间的内容,首先把标签之间的内容读取到Writer对象中, 
    // 再由Writer对象对其中的内容施行转换处理,转换后的内容会再次存储到Writer 中 
    public Writer getWriter(Writer out, Map args) { 
        return new UpperCaseWriter(out); 
    } 
    private class UpperCaseWriter extends Writer { 
        private Writer out; 
 
        UpperCaseWriter(Writer out) { 
            this.out = out; 
        } 
        public void write(char[] cbuf, int off, int len) throws IOException { 
            out.write(new String(cbuf, off, len).toUpperCase()); 
        } 
 
        public void flush() throws IOException { 
            out.flush(); 
        } 
        // 不用调用out.close,到达结束标签close会自动被调用 
        public void close() { 
             
        } 
    } 


二.自动生成代码应用

1.创建模板文件,在/resource/template目录下建立codeModel.ftl文件。
Java代码 
package com.order.model;  
 
public class ${class} {  
 
  <#list properties as prop> 
    private ${prop.type} ${prop.name}; 
  </#list> 
 
  <#list properties as prop> 
    public ${prop.type} get${prop.name?cap_first}(){ 
      return ${prop.name}; 
    } 
    public void set${prop.name?cap_first}(${prop.type} ${prop.name}){ 
      this.${prop.name} = ${prop.name}; 
    } 
  </#list> 
 


2.应用代码生成模板文件。
Java代码 
public class GenerateCodeTest { 
 
    public static void main(String args[]) throws IOException, 
                                                  TemplateException { 
        Configuration cfg = new Configuration(); 
        cfg.setDirectoryForTemplateLoading(new File( 
                "D:/myspace/freemarker/resource/template/")); 
        cfg.setObjectWrapper(new DefaultObjectWrapper()); 
 
        /* 获取模板文件 */ 
        Template template = cfg.getTemplate("codeModel.ftl"); 
 
        /* 模板数据 */ 
        Map<String, Object> root = new HashMap<String, Object>(); 
        root.put("class", "Order"); 
        Collection<Map<String, String>> properties = new HashSet<Map<String, String>>(); 
        root.put("properties", properties); 
 
        /* 字段1 orderId */ 
        Map<String, String> orderId = new HashMap<String, String>(); 
        orderId.put("name", "orderId"); 
        orderId.put("type", "Long"); 
        properties.add(orderId); 
 
        /* 字段2 orderName */ 
        Map<String, String> orderName = new HashMap<String, String>(); 
        orderName.put("name", "orderName"); 
        orderName.put("type", "String"); 
        properties.add(orderName); 
 
        /* 字段3 money */ 
        Map<String, String> money = new HashMap<String, String>(); 
        money.put("name", "money"); 
        money.put("type", "Double"); 
        properties.add(money); 
 
        /* 生成输出到控制台 */ 
        Writer out = new OutputStreamWriter(System.out); 
        template.process(root, out); 
        out.flush(); 
 
        /* 生成输出到文件 */ 
        File fileDir = new File("D:/generateCodeFile"); 
        // 创建文件夹,不存在则创建 
        org.apache.commons.io.FileUtils.forceMkdir(fileDir); 
        // 指定生成输出的文件 
        File output = new File(fileDir + "/Order.java"); 
        Writer writer = new FileWriter(output); 
        template.process(root, writer); 
        writer.close(); 
    } 

三.JSP调用模板文件输出。

1.首先创建模板文件,在WEB-INF/templates目录下建立test.ftl文件。
Java代码 
Hello,${name}! 
2.解析模板文件类,传入pageContext参数。
Java代码 
public class FreemarkerTest { 
     
    public void execute(PageContext pageContext) throws Exception 
    {         
        Configuration cfg = new Configuration();         
        // 设置模板的路径 
        cfg.setServletContextForTemplateLoading(pageContext.getServletContext(),  
                                                "WEB-INF/templates");         
        Map root = new HashMap(); 
        root.put("name", "Tom");         
        // 获取模板文件 
        Template t = cfg.getTemplate("test.ftl");         
        Writer out = pageContext.getResponse().getWriter();         
        t.process(root, out); 
    } 

3.创建JSP文件调用输出。
Html代码 
<%@ page language="java" contentType="text/html; charset=GB2312" 
    pageEncoding="GB2312"%> 
<%@page import="com.freemarker.test.FreemarkerTest;"%> 
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"  
    "http://www.w3.org/TR/html4/loose.dtd"> 
<html> 
    <head> 
        <meta http-equiv="Content-Type" content="text/html; charset=GB2312"> 
        <title>HelloWorld</title> 
    </head> 
    <body> 
        <% 
            FreemarkerTest c1 = new FreemarkerTest(); 
            c1.execute(pageContext); 
        %> 
    </body> 
</html> 
四.Servlet调用模板文件生成html文件进行页面展示。

1.创建模板文件,在WebRoot/index目录下建立test.ftl文件。
Java代码 
<html> 
<body> 
   用户名:${userName}<br> 
   邮&nbsp;&nbsp;箱:${email} 
</body> 
</html> 

2.创建Servlet文件解析模板文件并生成html文件进行页面输出。
Java代码 
public class FreemarkerServletTest extends HttpServlet { 
 
    public FreemarkerServletTest() { 
           super(); 
    } 
    public void destroy() { 
       super.destroy();  
    } 
    public void doGet(HttpServletRequest request, HttpServletResponse response) 
        throws ServletException, IOException { 
        doPost(request, response); 
    } 
    public void doPost(HttpServletRequest request, HttpServletResponse response) 
        throws ServletException, IOException { 
       //生成html后的文件 
       String path = getServletContext().getRealPath("/") + "index.htm"; 
       System.out.println(path); 
       try { 
        freemarker(request, "test.ftl", path, "index"); 
       } catch (Exception e) { 
        e.printStackTrace(); 
       } 
       //跳转到刚生成的html文件中 
       request.getRequestDispatcher("/index.htm").forward(request, response); 
    } 
 
    /**
    * 生成静态文件
    * @param request
    * @param ftl ftl文件
    * @param html 生成html后的文件
    * @param file 存放ftl文件的路径
    * @throws Exception
    */ 
    public void freemarker(HttpServletRequest request,String ftl, 
                        String html,String file) throws Exception { 
       Configuration cfg = new Configuration();     
       // 设置加载模板的路径 
       cfg.setServletContextForTemplateLoading(getServletContext(),"/" + file); 
       cfg.setEncoding(Locale.getDefault(), "GB18030"); 
       
       //获得模板并设置编码 
       Template tep = cfg.getTemplate(ftl); 
       tep.setEncoding("GB18303"); 
        
       //新建输出,生成html文件 
       Writer out = new BufferedWriter(new OutputStreamWriter(new FileOutputStream(html),"GB18030")); 
       //设置值 
       Map map = new HashMap(); 
       map.put("userName", "wxj"); 
       map.put("email", "jxauwxj@126.com"); 
       // 解析并输出 
       tep.process(map, out); 
    } 
 
    public void init() throws ServletException {         
    } 


3.web.xml文件进行servlet配置。
Xml代码 
<servlet>    
    <servlet-name>FreemarkerServletTest</servlet-name> 
    <servlet-class>com.servlet.FreemarkerServletTest</servlet-class> 
</servlet> 
 
<servlet-mapping> 
    <servlet-name>FreemarkerServletTest</servlet-name> 
    <url-pattern>/servlet/FreemarkerServletTest</url-pattern> 
</servlet-mapping> 

4.页面访问如下Url:
  http://localhost:8080/freemarkerWeb/servlet/FreemarkerServletTest  
输出结果如下:
Java代码 
用户名:wxj 
邮  箱:jxauwxj@126.com 

同时会在部署环境的目录下生成index.htm文件。
分享到:
评论

相关推荐

    freeMarker模板文件附件.zip

    1. **FreeMarker模板语言基础** FreeMarker是基于模板的,它与Java代码分离,使得视图层的开发更加独立。模板文件通常以`.ftl`为扩展名,其中包含了控制结构(如条件语句、循环)和变量引用,用于动态生成输出。 2...

    FreeMarker模板基本语法

    ### FreeMarker模板基本语法 #### 一、FreeMarker概述与基本用法 ...它通过将数据模型与表现层分离的方式...上述介绍仅涵盖了FreeMarker模板引擎的一部分基础内容,更多的高级特性还需要开发者在实践中不断探索和学习。

    Java利用Freemarker模板自动生成dto、dao、rowmapper、bo、service代码

    本主题涉及的核心技术是使用Freemarker模板引擎来生成DTO(Data Transfer Object)、DAO(Data Access Object)、RowMapper、BO(Business Object)和服务层代码。这些组件在Spring框架中扮演着重要角色。 1. **...

    springboot如何使用Freemarker模版引擎

    通过以上步骤,你可以在SpringBoot应用中成功集成并使用Freemarker模板引擎。这只是一个基础的介绍,实际开发中,你可以根据项目需求配置更多的Freemarker特性和功能,如缓存管理、日期格式化等,以满足复杂的应用...

    FreeMarker模板语言API

    FreeMarker是一个强大的、开源的模板引擎,主要用于生成动态HTML、XML或其他格式的文本输出,尤其在Web应用开发中被广泛使用。它与Java语言紧密结合,但模板设计者并不需要了解Java,只需要熟悉FreeMarker的模板语言...

    freemarker_servlet_demo

    Freemarker是一个强大的Java模板引擎,常用于Web开发中生成动态HTML页面。Servlet是Java Web应用中的核心组件,负责处理HTTP请求并返回响应。在"freemarker_servlet_demo"这个示例中,我们将深入探讨如何结合...

    基于Freemarker模板的代码生成器前台页面模板文件

    Freemarker是一个强大的开源模板引擎,常用于Java应用程序中生成动态HTML、XML或其他文本格式的输出。它允许开发者使用简单的标记语言来控制页面布局和内容展示,与后端业务逻辑相分离,极大地提高了开发效率。在...

    Java模板引擎 FreeMarker

    FreeMarker是一个强大的、开源的Java模板引擎,常用于Web应用中的动态内容生成,尤其是在MVC架构中,作为视图层的技术。它与JSP、JSTL等技术不同,FreeMarker是模型和视图完全分离的,使得开发者可以专注于业务逻辑...

    Struts2与FreeMarker模板

    #### FreeMarker模板引擎 FreeMarker是一个用Java编写的模板引擎,它可以生成任何文本格式的输出。FreeMarker将模板和数据模型分离,使得开发者能够专注于业务逻辑的处理,而设计师则专注于页面的表现形式。...

    初试FreeMarker模板的一些问题

    这篇名为“初试FreeMarker模板的一些问题”的博客可能涵盖了在学习和使用FreeMarker过程中遇到的基础问题和解决方法。 1. **模板语言基础** FreeMarker使用模板语言来定义如何将数据模型渲染成可读的输出。模板由...

    FreeMarker应用实例和PPT

    FreeMarker是一款强大的、开源的模板引擎,主要用于生成动态HTML、XML或其他格式的文本。它在Web开发中,尤其是在Struts2框架中,被广泛用于视图层的实现,以分离业务逻辑与展示逻辑,实现MVC(Model-View-...

    Java模板引擎Freemarker教程.docx

    FreeMarker是一个用于生成输出文本的模板引擎,其应用广泛,特别是在Java应用程序中作为视图层的一部分。它支持多种类型的输出文本,包括HTML、XML、JavaScript、邮件、CSV等。FreeMarker通过将数据模型与模板结合来...

    FreeMarker的基础知识整理

    FreeMarker模板的特殊部分包括插值,如`${expression}`,它可以根据表达式的类型(字符串、数字、日期/时间或布尔值)进行不同的处理: - **文本插值**:在HTML文本中,FreeMarker会自动转义特殊字符。可以通过`...

    freemarker java模板技术 很详细的注释

    - **分离视图和逻辑**: Freemarker模板与Java代码分离,使得开发人员可以专注于业务逻辑,而设计师可以专注于页面设计。 - **高性能**: Freemarker编译模板为高效的Java代码,执行效率高。 - **灵活性**: 支持...

    java源码:Java模板引擎 FreeMarker.tar.gz

    FreeMarker是一个强大的、开源的Java模板引擎,常用于Web应用中的动态内容生成,尤其是在MVC架构中,作为视图层的实现技术。它与JSP类似,但更专注于分离业务逻辑和显示逻辑,使得开发者可以编写更加清晰、独立于...

    struts2和freemarker整合

    Struts2是一个基于MVC(Model-View-Controller)架构模式的开源框架,用于构建动态、数据驱动的Web应用程序,而FreeMarker则是一个模板引擎,它允许开发者将业务逻辑与视图层分离,使得前端展示更加灵活和高效。...

    freemarker实例下载

    "springdemo"这个文件名暗示了该实例可能基于Spring框架,因为Spring提供了对Freemarker模板引擎的集成和支持。 1. **Freemarker基础** - Freemarker模板语言(FTL):是一种简单的文本标记语言,用于定义动态内容...

    18.[视频]使用模板(thymeleaf-freemarker)【从零开始学Spring Boot】

    Spring Boot是一个快速开发框架,它简化了在Java应用中集成各种组件的过程,包括模板引擎。模板引擎允许开发者用一种声明式的方式编写动态HTML页面,从而实现前后端分离。 Thymeleaf是一个现代服务器端Java模板引擎...

    freemarker入门文档及例子

    通过阅读“freemarker学习”和“freemarkerѧϰ”这两个文件,你可以深入了解Freemarker的语法和实际应用场景,逐步掌握这个强大的模板引擎。不断练习和实践,你将在不久的将来成为一名熟练的Freemarker开发者,能够...

Global site tag (gtag.js) - Google Analytics