FreeMarker實現網頁靜態化

1、FreeMarker實現網頁靜態化。

　　FreeMarker是一個用Java語言編寫的模板引擎，它基於模板來生成文本輸出。FreeMarker與Web容器無關，即在Web運行時，它並不知道Servlet或HTTP。它不僅可以用作表現層的實現技術，而且還可以用於生成XML，JSP或Java 等。目前企業中:主要用Freemarker做靜態頁面或是頁面展示。

2、使用freemarker需要的jar。

　　a）、把下載到的jar包（freemarker-2.3.23.jar）放到\webapp\WEB-INF\lib目錄下。官方網站：http://freemarker.org/

　　b）、如果使用的是Maven結構,可在pom.xml中引入以下坐標。

<dependency>
  <groupId>org.freemarker</groupId>
  <artifactId>freemarker</artifactId>
  <version>2.3.23</version>
</dependency>

 3、Freemarker原理圖。模板 +  數據模型 = 輸出

4、freemarker的測試案例如下所示：

package com.taotao.freemarker;

import java.io.File;
import java.io.FileWriter;
import java.io.IOException;
import java.io.Writer;
import java.util.HashMap;
import java.util.Map;

import org.junit.Test;

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

/**
 * freemarker網頁靜態化
 * 
 * @ClassName: TaoTaoFreemarker.java
 * @author: biehl
 * @since: 2019年9月21日 下午5:46:49
 * @Copyright: ©2019 biehl 版權所有
 * @version: 0.0.1
 * @Description:
 */
public class StaticPageFreemarker {

    @Test
    public void freemarkerStaticPage() {
        try {
            // 1、創建一個模板文件
            // 2、創建一個Configuration對象
            Configuration configuration = new Configuration(Configuration.getVersion());

            // 3、設置模板所在得路徑
            configuration.setDirectoryForTemplateLoading(
                    new File("D:\\eclipse\\workspace_taotao\\taotao-item-web\\src\\main\\webapp\\WEB-INF\\ftl"));

            // 4、設置模板得字符集，一般使用utf-8
            configuration.setDefaultEncoding("utf-8");

            // 5、使用Configuration對象加載一個模板文件，需要指定模板文件得文件名
            Template template = configuration.getTemplate("hello.ftl");

            // 6、創建一個數據集，可以是pojo也可以是map，推薦使用map
            Map data = new HashMap<>();
            data.put("hello", "hello fremarker!!!");

            // 7、創建一個Writer對象，指定輸出文件的路徑以及文件名
            Writer out = new FileWriter(new File("D:\\biehl\\photo\\out\\hello.txt"));

            // 8、使用模板對象的process方法輸出文件
            template.process(data, out);

            // 9、關閉流
            out.close();
        } catch (IOException e) {
            e.printStackTrace();
        } catch (TemplateException e) {
            e.printStackTrace();
        }

    }
}

相關文件如下所示：

5、fremarker模板的語法學習。

package com.taotao.freemarker;

import java.io.File;
import java.io.FileWriter;
import java.io.IOException;
import java.io.Writer;
import java.util.ArrayList;
import java.util.Date;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

import org.junit.Test;

import com.taotao.pojo.Student;

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

/**
 * freemarker網頁靜態化
 * 
 * @ClassName: TaoTaoFreemarker.java
 * @author: biehl
 * @since: 2019年9月21日 下午5:46:49
 * @Copyright: ©2019 biehl 版權所有
 * @version: 0.0.1
 * @Description:
 */
public class StaticPageFreemarker {

    @Test
    public void freemarkerStaticPage() {
        try {
            // 1、創建一個模板文件
            // 2、創建一個Configuration對象
            Configuration configuration = new Configuration(Configuration.getVersion());

            // 3、設置模板所在得路徑
            configuration.setDirectoryForTemplateLoading(
                    new File("D:\\eclipse\\workspace_taotao\\taotao-item-web\\src\\main\\webapp\\WEB-INF\\ftl"));

            // 4、設置模板得字符集，一般使用utf-8
            configuration.setDefaultEncoding("utf-8");

            // 5、使用Configuration對象加載一個模板文件，需要指定模板文件得文件名
            // Template template = configuration.getTemplate("hello.ftl");
            Template template = configuration.getTemplate("student.ftl");

            // 6、創建一個數據集，可以是pojo也可以是map，推薦使用map
            Map data = new HashMap<>();
            data.put("hello", "hello fremarker!!!");
            Student stu = new Student(1, "小辣椒", 25, "北京市西城區西什庫大街31號院");
            // 注意，對象的key就是模板里面的對應的.前面的對象名稱
            data.put("student", stu);

            // freemarker遍歷集合對象
            List<Student> stuList = new ArrayList<Student>();
            stuList.add(new Student(1008611, "小辣椒1號", 25, "北京市西城區西什庫大街30號院"));
            stuList.add(new Student(1008612, "小辣椒2號", 21, "北京市西城區西什庫大街32號院"));
            stuList.add(new Student(1008613, "小辣椒3號", 22, "北京市西城區西什庫大街33號院"));
            stuList.add(new Student(1008614, "小辣椒4號", 23, "北京市西城區西什庫大街34號院"));
            stuList.add(new Student(1008615, "小辣椒5號", 24, "北京市西城區西什庫大街35號院"));
            stuList.add(new Student(1008616, "小辣椒6號", 20, "北京市西城區西什庫大街36號院"));
            stuList.add(new Student(1008617, "小辣椒7號", 18, "北京市西城區西什庫大街31號院"));
            data.put("stuList", stuList);

            // 日期類型的處理
            data.put("date", new Date());

            // null值得處理
            data.put("val", null);

            // 7、創建一個Writer對象，指定輸出文件的路徑以及文件名
            Writer out = new FileWriter(new File("D:\\biehl\\photo\\out\\student.html"));

            // 8、使用模板對象的process方法輸出文件
            template.process(data, out);

            // 9、關閉流
            out.close();
        } catch (IOException e) {
            e.printStackTrace();
        } catch (TemplateException e) {
            e.printStackTrace();
        }

    }
}

freemarker模板如下所示：

<html>
<head>
    <title>測試頁面</title>
</head>
<body>
<center>
    <!-- 1）、freemarker語法-取pojo的屬性 -->
    學生信息：<br>
    學號：${student.id}<br>
    姓名：${student.name}<br>
    年齡：${student.age}<br>
    家庭住址：${student.address}<br><br><br>
    學生列表：<br>
    <table border="1">
        <tr>
            <th>序號</th>
            <th>學號</th>
            <th>姓名</th>
            <th>年齡</th>
            <th>家庭住址</th>
        </tr>
        <!-- 2）、freemarker語法-list,歷遍集合/數組, -->
        <#list stuList as stu>
        <!-- 邏輯運算符(==、!=、||、&&) -->
        <#if stu_index%2==0>
        <tr bgcolor="yellow">
        <#else>
        <tr bgcolor="purple">
        </#if>
            <!-- 獲得當前迭代的索引x_index -->
            <td>${stu_index}</td>
            <td>${stu.id}</td>
            <td>${stu.name}</td>
            <td>${stu.age}</td>
            <td>${stu.address}</td>
        </tr>
        </#list>
    </table>
    <br><br><br>
    <!--
        默認格式
        1）、date。
            cur_time?date
        2）、datetime。
            cur_time?datetime
        3）、time。
            cur_time?time
        4）、自定義格式。
            cur_time?string("yyyy-MM-dd HH:mm:ss") 
    -->
    年:月:日：${date?date}<br>
    年:月:日 時:分:秒：${date?datetime}<br>
    時:分:秒：${date?time}<br>
    年/月/日：${date?string("yyyy/MM/dd")}<br>
    日期類型的處理：${date?string("yyyy/MM/dd HH:mm:ss")}
    <br><br><br>
    <!-- null值的處理、方式一：null 變 空串 -->
    方式一、null值的處理：${val!}
    <br>
    方式二、為Null時給默認值
    ${val!"我是默認值"}
    <br>
    方式三、使用if判斷null值：
    <#if val??>
    val是有值的.
    <#else>
    val值為null.
    </#if>
    <br><br><br>
    <!-- 將另一個頁面引入本頁面時可用以下命令完成 -->
    include標簽測試：
    <#include "hello.ftl">
</center>    
</body>
</html>

效果如下所示：

6、freemarker與spring整合。由於使用的maven項目，所以引入相應的依賴jar包。

<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-context-support</artifactId>
    <version>4.1.3.RELEASE</version>
</dependency>
<dependency>
    <groupId>org.freemarker</groupId>
    <artifactId>freemarker</artifactId>
    <version>2.3.23</version>
</dependency>

在ApplicationContext.xml中添加如下內容：

<bean id="freemarkerConfig"    class="org.springframework.web.servlet.view.freemarker.FreeMarkerConfigurer">
    <property name="templateLoaderPath" value="/WEB-INF/freemarker/" />
    <property name="defaultEncoding" value="UTF-8" />
</bean>

整合代碼實現如下所示：

package com.taotao.item.controller;

import java.io.File;
import java.io.FileWriter;
import java.io.Writer;
import java.util.HashMap;
import java.util.Map;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;
import org.springframework.web.servlet.view.freemarker.FreeMarkerConfigurer;

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

/**
 * 
 * @ClassName: HtmlGenController.java
 * @author: biehl
 * @since: 2019年9月26日 下午8:15:01
 * @Copyright: ©2019 biehl 版權所有
 * @version: 0.0.1
 * @Description:
 */
@Controller
public class HtmlGenController {

    @Autowired
    private FreeMarkerConfigurer freeMarkerConfigurer;

    @RequestMapping("/genhtml")
    @ResponseBody
    public String genHtml() throws Exception {
        // 生成靜態頁面
        Configuration configuration = freeMarkerConfigurer.getConfiguration();
        Template template = configuration.getTemplate("hello.ftl");
        Map data = new HashMap<>();
        data.put("hello", "spring freemarker test");
        Writer out = new FileWriter(new File("D:/test.html"));
        template.process(data, out);
        out.close();
        // 返回結果
        return "OK";
    }

}

 

 

待續......