FreeMarker 学习

2022-06-05 19:00:20

一、FreeMarker

FreeMarker是一款模板引擎：即一种基于模板和要改变的数据，并用来生成输出文本（HTML网页、电子邮件、配置文件、源代码等）的通用工具。它不是面向最终用户的，而是一个Java类库，是一款程序员可以嵌入他们所开发产品的组件。（百度百科）

　 FreeMarker不是一个Web应用框架，而适合作为Web应用框架一个组件。

FreeMarker与容器无关，因为它并不知道HTTP或Servlet；FreeMarker同样可以应用于非Web应用程序环境。

优点：

　1. FreeMarker的优点一，可以彻底的分离表现层和业务逻辑。
　　使用JSP 开发过程中发现在页面中大量的存在业务逻辑的代码，使得页面内容凌乱，在后期大量的修改维护过程中就变得非常困难。
　　FreeMarker根本不支持Java脚本代码。
　　FreeMarker的原理就是：模板+数据模型=输出，模板只负责数据在页面中的表现，不涉及任何的逻辑代码，而所有的逻辑都是由数据模型来处理的。用户最终看到的输出是模板和数据模型合并后创建的。

2. FreeMarker的优点二，可以提高开发效率。
　　使用JSP 页面来展示数据的，即所谓的表现层。大家都知道，JSP在第一次执行的时候需要转换成Servlet类，开发阶段进行功能调适时，需要频繁的修改JSP，每次修改都要编译和转换，那么试想一天中我们浪费在程序编译的时间有多少。相对于JSP来说，FreeMarker模板技术不存在编译和转换的问题，所以就不会存在上述问题。而且开发过程中，大家在不必在等待界面设计开发人员完成页面原形后，大家再来开发程序。

缺点：

1.FreeMarker的缺点一，应用FreeMarker模板技术，在修改模板后，可能会看到已经过期的数据。如：生成静态的HTML页面后，如果一旦模板改变，而没有及时更新模板生成的HTML页面的话，用户看到的就是过期的数据。
2.FreeMarker的缺点二，FreeMarker不支持集群应用。为了编成的方便性，把序列化的东西都放到了Session中，如Session，request等，在开发的过程中确实方便，但如果将应用放到集群中，就会出现错误。

二、数据格式

freeMark 的数据格式是树状结构，使用Map封装数据 key必须是string，其他数据类型无法操作。

三、使用

public static void main(String[] args) throws IOException, TemplateException{

        //创建Freemarker配置实例

        Configuration cfg = new Configuration();

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

        //创建数据模型

        Map<String,Object> root = new HashMap<String,Object>();

        root.put("name", "张三");//字符串类型

        root.put("random", new Random().nextInt(100));

        List<Map<String,Object>> listMap=new ArrayList<Map<String,Object>>();

        Map<String,Object> map = new HashMap<String,Object>();

        map.put("name", "A1");

        map.put("name", "A2");

        listMap.add(map);

        root.put("listMap", listMap);

        //加载模板文件

        Template template=cfg.getTemplate("a.ftl");

        //显示生成的数据

         Writer writer=new OutputStreamWriter(System.out);

        // Writer writer  = new OutputStreamWriter(new FileOutputStream("html/index.html"),"UTF-8");

         template.process(root, writer);

         writer.flush();

    }

a.ftl

你好 ${name} 欢迎学习FreeMarker

<#--if 语句 -->

#if 语句

<#if name=="张三">张三</#if>

<#--  if  else-->

# gt 大于   gte 大于等于 

<#if random gt 60 >

      ${random}: 及格

  <#else>

     ${random}: 不及格

</#if>

<#--  if else if else语句测试：    -->

<#if random gte 90>

    ${random}:优秀！

<#elseif random gte 80>

    ${random}:良好！

<#else>

    ${random}: 一般！

</#if>

<#-- 遍历List -->

<#list listMap as map >

    <b>${map.name}</b> <br/>

</#list>

<#-- include -->

<#include "index.ftl" />

<#-- 自定义指令  macro指令-->

<#macro m1>   <#--定义指令m1 -->

    <b>aaabbbccc</b>

    <b>dddeeefff</b>

</#macro>

<@m1 />  <#--调用上面的宏指令 -->

<#-- 定义带参的宏指令：  -->

<#macro m2 a b c >

    ${a}--${b}--${c}

</#macro>

<@m2 a="老高" b="老张" c="老马" />

<#-- nested指令： -->

<#macro border>

  <table border=4 cellspacing=0 cellpadding=4>

      <tr>

          <td>

            <#nested>

          </td>

      </tr>

  </table>

</#macro>

<@border >表格中的内容！ 方式二</@border>

<#--  命名空间  -->

    <#import "b.ftl" as bb  />

    <@bb.copyright date="2010-2011" />

    ${bb.mail}

    <#assign mail="my@163.com"  />

    ${mail} <#-- 引用的是  -->

    <#assign mail="my@126.com" in bb  />

    ${bb.mail}  <#-- 引用的是  -->

b.ftl

<#macro copyright date>

  <p>Copyright (C) ${date} 北京尚学堂.</p>

</#macro>

<#assign mail = "bjsxt@163.com">

index.ftl

<#macro copyright date>

  <p>Copyright (C) ${date}</p>

</#macro>

<#assign mail = "bjsxt@163.com">

三、在WEB项目中使用（官方demo）

public class FreemarkServlet extends HttpServlet{

    private Configuration cfg;

    public void init() {

        cfg=new Configuration();

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

    }

    public void doGet(HttpServletRequest request, HttpServletResponse response)throws ServletException, IOException {

        doPost(request, response);

    }

    public void doPost(HttpServletRequest request, HttpServletResponse response)throws ServletException, IOException {

            Map<String,Object> root = new HashMap<String,Object>();

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

            Template template = cfg.getTemplate("index.ftl");

            Writer out = new BufferedWriter(new OutputStreamWriter(response.getOutputStream(), template.getEncoding()));

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

            try {

                template.process(root, out);

                out.flush();

            } catch (TemplateException e) {

                throw new ServletException( "Error while processing FreeMarker template", e);

            }

        }

}
1、在WEB-INF下建立目录  templates  在里面建文件 index.ftl
<html>
<head>
  <meta charset="UTF-16">
  <title>FreeMarker Example Web Application 1</title>
</head>
<body>
  ${message}
</body>
</html>
2、web.xml 
<?xml version="1.0" encoding="UTF-8"?>  
<web-app version="3.0" xmlns="http://java.sun.com/xml/ns/javaee"  
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee   
    http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"> 
  <servlet>  
      <servlet-name>freeMark</servlet-name>  
      <servlet-class>com.jalja.servlet.FreemarkServlet</servlet-class>  
      <load-on-startup>1</load-on-startup>  
  </servlet>  
  <servlet-mapping>  
      <servlet-name>freeMark</servlet-name>  
      <url-pattern>/freeMark</url-pattern>  
  </servlet-mapping>  
  </web-app>

在WEB-INF下建立目录 templates 在里面建文件 index.ftl

码农公寓

相关文章