FreeMarker

一紙油傘發表於2020-12-01

FreeMarker

主要內容

在這裡插入圖片描述

FreeMarker 概述

FreeMarker概念

FreeMarker 是一款模板引擎：即一種基於模板和要改變的資料，並用來生成輸出文字(HTML網頁，電子郵件，配置檔案，原始碼等)的通用工具。是一個Java類庫。

FreeMarker 被設計用來生成 HTML Web 頁面，特別是基於 MVC 模式的應用程式，將檢視從業務邏輯中抽離處理，業務中不再包括檢視的展示，而是將檢視交給 FreeMarker 來輸出。雖然 FreeMarker 具有一些程式設計的能力，但通常由 Java 程式準備要顯示的資料，由 FreeMarker 生成頁面，通過模板顯示準備的資料（如下圖）:

FreeMarker不是一個Web應用框架，而適合作為Web應用框架一個元件。

FreeMarker與容器無關，因為它並不知道HTTP或Servlet。FreeMarker同樣可以應用

於非Web應用程式環境。

FreeMarker更適合作為Model2框架（如Struts）的檢視元件，你也可以在模板中使用

JSP標記庫。

FreeMarker特性

通用目標

能夠生成各種文字：HTML、XML、RTF、Java 原始碼等等

易於嵌入到你的產品中：輕量級；不需要 Servlet 環境

外掛式模板載入器：可以從任何源載入模板，如本地檔案、資料庫等等

你可以按你所需生成文字：儲存到本地檔案；作為 Email 傳送；從 Web 應用程式傳送它返回給 Web 瀏覽器

強大的模板語言

所有常用的指令：include、if/elseif/else、迴圈結構

在模板中建立和改變變數

幾乎在任何地方都可以使用複雜表示式來指定值

命名的巨集，可以具有位置引數和巢狀內容

名字空間有助於建立和維護可重用的巨集庫，或將大工程分成模組，而不必擔心名字衝突

輸出轉換塊：在巢狀模板片段生成輸出時，轉換HTML轉義、壓縮、語法高亮等等；你可以定義自己的轉換

通用資料模型

FreeMarker不是直接反射到Java物件，Java物件通過外掛式物件封裝，以變數方式在模板中顯示

你可以使用抽象（介面）方式表示物件（JavaBean、XML文件、SQL查詢結果集等等），告訴模板開發者使用方法，使其不受技術細節的打擾

為Web準備

在模板語言中內建處理典型Web相關任務（如HTML轉義）的結構

能夠整合到Model2 Web應用框架中作為JSP的替代

支援JSP標記庫

為MVC模式設計：分離視覺化設計和應用程式邏輯；分離頁面設計員和程式設計師

智慧的國際化和本地化

字符集智慧化（內部使用UNICODE）

數字格式本地化敏感

日期和時間格式本地化敏感

非US字符集可以用作標識（如變數名）

多種不同語言的相同模板

強大的XML處理能力

<#recurse> 和 <#visit> 指令（2.3版本）用於遞迴遍歷XML樹。在模板中清楚和直接的訪問XML物件模型。開源論壇 JForum 就是使用了 FreeMarker 做為頁面模板。

FreeMarker環境搭建

新建 Maven Web專案

配置座標依賴和部署外掛

pom.xml

<?xml version="1.0" encoding="UTF-8"?>

<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.xxxx</groupId>
  <artifactId>freemarker</artifactId>
  <version>1.0-SNAPSHOT</version>
  <packaging>war</packaging>

  <name>freemarker Maven Webapp</name>
  <!-- FIXME change it to the project's website -->
  <url>http://www.example.com</url>

  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
  </properties>

  <dependencies>
    <!-- freemarker的座標依賴 -->
    <dependency>
      <groupId>org.freemarker</groupId>
      <artifactId>freemarker</artifactId>
      <version>2.3.23</version>
    </dependency>
    <!-- servlet-api的座標依賴 -->
    <dependency>
      <groupId>javax.servlet</groupId>
      <artifactId>javax.servlet-api</artifactId>
      <version>3.0.1</version>
    </dependency>

  </dependencies>

  <build>
    <finalName>freemarker</finalName>
    <!--
        外掛地址：
          Tomcat
            http://tomcat.apache.org/maven-plugin-2.2/
          Jetty
            https://www.eclipse.org/jetty/documentation/current/jetty-maven-plugin.html
    -->
    <plugins>
      <!-- 配置jetty外掛 -->
      <plugin>
        <groupId>org.eclipse.jetty</groupId>
        <artifactId>jetty-maven-plugin</artifactId>
        <version>9.2.1.v20140609</version>
      </plugin>
    </plugins>

  </build>
</project>

修改配置檔案 web.xml

在專案的webapp/WEB-INF目錄下的web.xml檔案中，新增freemarker 相關 servlet 配置

<?xml version="1.0" encoding="UTF-8"?>
<web-app id="WebApp_ID" 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">
  <!-- FreeMarker 的Servlet配置 -->
  <servlet>
    <servlet-name>freemarker</servlet-name>
    <servlet-class>freemarker.ext.servlet.FreemarkerServlet</servlet-class>
    <init-param>
      <!-- 模板路徑 -->
      <param-name>TemplatePath</param-name>
      <!-- 預設在webapp目錄下查詢對應的模板檔案 -->
      <param-value>/</param-value>
    </init-param>
    <init-param>
      <!-- 模板預設的編碼：UTF-8 -->
      <param-name>default_encoding</param-name>
      <param-value>UTF-8</param-value>
    </init-param>
  </servlet>
  <!-- 處理所有以.ftl結尾的檔案；ftl是freemarker預設的檔案字尾 -->
  <servlet-mapping>
    <servlet-name>freemarker</servlet-name>
    <url-pattern>*.ftl</url-pattern>
  </servlet-mapping>
</web-app>

編寫Servlet類

package com.xxxx.controllter;

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 java.io.IOException;

@WebServlet("/f01")
public class FreeMarker01 extends HttpServlet {
    @Override
    protected void service(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        // 新增資料
        request.setAttribute("msg","Hello FreeMarker!");
        // 請求轉發跳轉到ftl檔案中
        request.getRequestDispatcher("template/f01.ftl").forward(request,response);
    }
}

新建模板檔案 ftl

在webapp目錄下新建template資料夾，建立f01.ftl檔案

啟動專案

訪問專案

瀏覽器位址列輸入：http://localhost:8989/f01

FreeMarker 資料型別

Freemarker 模板中的資料型別由如下幾種：

布林型：等價於 Java 的 Boolean 型別，不同的是不能直接輸出，可轉換為字串輸出
日期型：等價於 java 的 Date 型別，不同的是不能直接輸出，需要轉換成字串再輸出
數值型：等價於 java 中的 int,float,double 等數值型別

有三種顯示形式：數值型(預設)、貨幣型、百分比型
字元型：等價於 java 中的字串，有很多內建函式
sequence 型別：等價於 java 中的陣列，list，set 等集合型別
hash 型別：等價於 java 中的 Map 型別

布林型別

在Servlet中設定布林型別的資料

// 布林型別
request.setAttribute("flag", true);

獲取資料

<#--
    資料型別：布林型別
        在freemarker中布林型別不能直接輸出；如果輸出要先轉成字串
        方式一：?c
        方式二：?string 或 ?string("true時的文字","false時的文字")
-->
${flag?c} <br>
${flag?string} <br>
${flag?string("yes","no")} <br>

日期型別

在Servlet中設定日期型別的資料

// 日期型別
request.setAttribute("createDate",new Date());

獲取資料

<#--
    資料型別：日期型別
        在freemarker中日期型別不能直接輸出；如果輸出要先轉成日期型或字串
        1. 年月日          ?date
        2. 時分秒          ?time
        3. 年月日時分秒     ?datetime
        4. 指定格式        ?string("自定義格式")
                           y：年  M：月  d：日
                           H：時  m：分  s：秒
-->
<#-- 輸出日期格式 -->
${createDate?date} <br>  
<#-- 輸出時間格式 -->
${createDate?time} <br> 
<#-- 輸出日期時間格式 -->
${createDate?datetime} <br>   
<#-- 輸出格式化日期格式 -->
${createDate?string("yyyy年MM月dd日 HH:mm:ss")} <br>

數值型別

在Servlet設定數值型的資料

// 數值型別
request.setAttribute("age",18); // 數值型
request.setAttribute("salary",10000); // 數值型
request.setAttribute("avg",0.545); // 浮點型

獲取資料

<#--
    資料型別：數值型別
        在freemarker中數值型別可以直接輸出；
        1. 轉字串
            普通字串       ?c
            貨幣型字串     ?string.currency
            百分比型字串   ?string.percent
        2. 保留浮點型數值指定小數位（#表示一個小數位）
            ?string["0.##"]
-->
<#-- 直接輸出數值型 -->
${age} <br>
${salary} <br>
<#-- 將數值轉換成字串輸出 -->
${salary?c} <br>
<#-- 將數值轉換成貨幣型別的字串輸出 -->
${salary?string.currency} <br>
<#-- 將數值轉換成百分比型別的字串輸出 -->
${avg?string.percent} <br>
<#-- 將浮點型數值保留指定小數位輸出 （##表示保留兩位小數） -->
${avg?string["0.##"]} <br>

字串型別

在Servlet中設定字串型別的資料

// 字串型別
request.setAttribute("msg","Hello ");
request.setAttribute("msg2","freemarker");

獲取資料

<#--
    資料型別：字串型別
        在freemarker中字串型別可以直接輸出；
        1. 擷取字串（左閉右開） ?substring(start,end)
        2. 首字母小寫輸出  ?uncap_first
        3. 首字母大寫輸出  ?cap_first
        4. 字母轉小寫輸出  ?lower_case
        5. 字母轉大寫輸出  ?upper_case
        6. 獲取字串長度  ?length
        7. 是否以指定字元開頭（boolean型別） ?starts_with("xx")?string
        8. 是否以指定字元結尾（boolean型別） ?ends_with("xx")?string
        9. 獲取指定字元的索引  ?index_of("xx")
        10. 去除字串前後空格 ?trim
        11. 替換指定字串  ?replace("xx","xx")
-->
<#-- 直接輸出 -->
${msg} - ${msg2} <br>
${msg?string} - ${msg2?string} <br>
<#-- 1. 擷取字串（左閉右開） ?substring(start,end) -->
${msg2?substring(1,4)} <br>
<#-- 2. 首字母小寫輸出  ?uncap_first -->
${msg?uncap_first} <br>
<#-- 3. 首字母大寫輸出  ?cap_first -->
${msg2?cap_first} <br>
<#-- 4. 字母轉小寫輸出  ?lower_case -->
${msg?lower_case} <br>
<#-- 5. 字母轉大寫輸出  ?upper_case -->
${msg?upper_case} <br>
<#-- 6. 獲取字串長度  ?length -->
${msg?length} <br>
<#-- 7. 是否以指定字元開頭（boolean型別） ?starts_with("xx")?string -->
${msg?starts_with("H")?string} <br>
<#-- 8. 是否以指定字元結尾（boolean型別） ?ends_with("xx")?string -->
${msg?ends_with("h")?string} <br>
<#-- 9. 獲取指定字元的索引  ?index_of("xxx") -->
${msg?index_of("e")} <br>
<#-- 10. 去除字串前後空格 ?trim -->
${msg?trim?length} <br>
<#-- 11. 替換指定字串  ?replace("xx","xxx") -->
${msg?replace("o","a")}<br>

字串空值情況處理

FreeMarker 的變數必須賦值，否則就會丟擲異常。而對於 FreeMarker 來說，null 值和不存在的變數是完全一樣的，因為 FreeMarker 無法理解 null 值。

FreeMarker 提供兩個運算子來避免空值：

① ! ：指定缺失變數的預設值

${value!}：如果value值為空，則預設值是空字串

${value!“預設值”}：如果value值為空，則預設值是字串"預設值"

② ?? ：判斷變數是否存在

如果變數存在，返回 true，否則返回 false

${(value??)?string}

<#-- 如果值不存在，直接輸出會報錯 -->
<#--${str}-->
<#-- 使用!，當值不存在時，預設顯示空字串 -->
${str!}<br>
<#-- 使用!"xx"，當值不存在時，預設顯示指定字串 -->
${str!"這是一個預設值"}<br>
<#-- 使用??，判斷字串是否為空；返回布林型別。如果想要輸出，需要將布林型別轉換成字串 -->
${(str??)?string}<br>

sequence 型別

在Servlet中設定序列型別的資料

// 序列型別 （陣列、List、Set）
// 陣列操作
String[] stars = new String[]{"周杰倫","林俊杰","陳奕迅","五月天"};
request.setAttribute("stars",stars);

// List操作
List<String> citys = Arrays.asList("上海","北京","杭州","深圳");
request.setAttribute("cityList",citys);

// JavaBean集合
List<User> userList = new ArrayList<>();
userList.add(new User(1,"zhangsan",22));
userList.add(new User(2,"lisi",18));
userList.add(new User(3,"wangwu",20));
request.setAttribute("userList",userList);

獲取資料

<#--
    資料型別：序列型別 （陣列、List、Set）
        通過list指令輸出序列
            <#list 序列名 as 元素名>
                ${名稱}
            </#list>
        獲取序列的長度        ${序列名?size}
        獲取序列元素的下標     ${元素名?index}
        獲取第一個元素        ${序列名?first}
        獲取最後一個元素      ${序列名?last}

        倒序輸出    	 序列名?reverse
        升序輸出    	 序列名?sort
        降序輸出    	 序列名?sort?reverse
        指定欄位名排序    序列名?sort_by("欄位名")
           注：一般是JavaBean集合，對應的欄位名需要提供get方法
-->
<#-- 陣列操作 -->
<#list stars as star>
    下標：${star?index} -- 名字：${star} <br>
</#list>
陣列的長度：${stars?size}  <br>
<#-- 獲取第一個元素 -->
第一個元素：${stars?first} <br>
<#-- 獲取最後一個元素 -->
最後一個元素：${stars?last} <br>
<hr>

<#-- List操作 -->
<#list cityList as city >
    ${city} <br>
</#list>
List的size：${cityList?size} <br>
<#-- 倒序輸出 -->
<#list cityList?reverse as city >
    ${city} -
</#list>
<br>

<#-- 升序輸出 -->
<#list cityList?sort as city >
    ${city} -
</#list>
<br>
<#-- 降序輸出 -->
<#list cityList?sort?reverse as city >
    ${city} -
</#list>
<hr>

<#-- JavaBean集合 -->
<#list userList as user>
    編號：${user.userId}&nbsp;&nbsp;
    姓名：${user.uname}&nbsp;&nbsp;
    年齡：${user.uage}&nbsp;&nbsp;
    <br>
</#list>

<#-- 按照指定欄位名排序 -->
<#list userList?sort_by("uage") as user>
    ${user.uname} |
</#list>

hash 型別

在Servlet中設定hash型別的資料

// Map操作
Map<String,String> cityMap = new HashMap<>();
cityMap.put("sh","上海");
cityMap.put("bj","北京");
cityMap.put("sz","深圳");
request.setAttribute("cityMap",cityMap);

獲取資料

<#--
    資料型別：hash型別
         key遍歷輸出
            <#list hash?keys as key>
                ${key} -- ${hash[key]}
            </#list>
         value遍歷輸出
            <#list hash?values as value>
                ${value}
            </#list>
-->
<#-- key遍歷輸出 -->
<#list cityMap?keys as key>
    ${key} -- ${cityMap[key]} <br>
</#list>

<#-- value遍歷輸出 -->
<#list cityMap?values as value>
    ${value} |
</#list>

FreeMarker 常見指令

assign 自定義變數指令

使用 assign 指令你可以建立一個新的變數，或者替換一個已經存在的變數。

<#--
    assign 自定義變數指令
        語法：
            <#assign 變數名=值>
            <#assign 變數名=值 變數名=值> （定義多個變數）
-->
<#assign str="hello">
${str} <br>
<#assign num=1 names=["zhangsan","lisi","wangwu"] >
${num} -- ${names?join(",")}

if elseif else 邏輯判斷指令

可以使用 if， elseif 和 else 指令來條件判斷是否滿足某些條件。

<#--
    if, else, elseif 邏輯判斷指令
        格式：
            <#if condition>
              ...
            <#elseif condition2>
              ...
            <#elseif condition3>
              ...
            <#else>
              ...
            </#if>
        注：
            1. condition, condition2等：將被計算成布林值的表示式。
            2. elseif 和 else 指令 是可選的。
-->
<#assign score = 80>
<#if score < 60>
    你個小渣渣！
    <#elseif score == 60>
        分不在高，及格就行！
    <#elseif score gt 60 && score lt 80>
        哎喲不錯哦！
    <#else>
        你很棒棒哦！
</#if>
<br>

<#-- 判斷資料是否存在 -->
<#assign list="">
<#if list??>
    資料存在
    <#else>
        資料不存在
</#if>

list 遍歷指令

可以使用 list 指令來對序列進行遍歷。

<#--
    list指令
        格式1：
            <#list sequence as item>

            </#list>
        格式2：
            <#list sequence as item>

            <#else>
                當沒有選項時，執行else指令
            </#list>
        注：
            1. else 部分是可選的
            2. sequence： 想要迭代的項，可以是序列或集合的表示式
            3. item： 迴圈變數 的名稱
            4. 當沒有迭代項時，才使用 else 指令， 可以輸出一些特殊的內容而不只是空在那裡
-->
<#assign users = ["張三","李四","王五"]>
<#-- 遍歷序列 -->
<#list users as user>
    ${user}
</#list>

<br>
<#--判斷資料不為空，再執行遍歷 （如果序列不存在，直接遍歷會報錯）-->
<#if users2??>
    <#list users2 as user>
        ${user}
    </#list>
</#if>
<br>

<#assign users3 = []>
<#-- 當序列沒有資料項時，使用預設資訊 -->
<#list users3 as user>
    ${user}
    <#else>
        當前沒有資料！
</#list>

macro 自定義指令

可以使用 macro 指令來自定義一些自定義指令。

<#--
    macro 自定義指令 （巨集）
        1. 基本使用
            格式：
                <#macro 指令名>
                    指令內容
                </#macro>
            使用：
                <@指令名></@指令名>
        2. 有引數的自定義指令
            格式：
                 <#macro 指令名 引數名1 引數名2>
                    指令內容
                </#macro>
            使用：
                <@指令名 引數名1=引數值1 引數名2=引數值2></@指令名>

        注：
            1. 指令可以被多次使用。
            2. 自定義指令中可以包含字串，也可包含內建指令
-->
<#-- 定義基本的自定義指令 -->
<#macro address>
    © 1999–2015 The FreeMarker Project. All rights reserved.
</#macro>
<#-- 使用指令 -->
<@address></@address> <br>
<@address></@address>
<hr>

<#-- 定義有引數的自定義指令 -->
<#macro queryUserByName uname>
    通過使用者名稱查詢使用者資訊 - ${uname}
</#macro>
<#-- 使用指令，並傳遞引數 -->
<@queryUserByName uname="admin"></@queryUserByName> <br>

<#-- 定義有多個引數的自定義指令 -->
<#macro queryUserByParams uname uage>
    通過多個餐宿查詢使用者資訊 - ${uname} - ${uage}
</#macro>
<#-- 使用指令，並傳遞多個引數 -->
<@queryUserByParams uname="admin" uage=18></@queryUserByParams> <br>
<hr>

<#-- 自定義指令中包含內建指令 -->
<#macro cfb>
    <#list 1..9 as i>
        <#list 1..i as j>
            ${j}*${i}=${j*i}&nbsp;
        </#list>
        <br>
    </#list>
</#macro>
<@cfb></@cfb>
<@cfb></@cfb>

<#-- 動態資料 -->
<#macro cfb2 num>
    <#list 1..num as i>
        <#list 1..i as j>
            ${j}*${i}=${j*i}&nbsp;
        </#list>
        <br>
    </#list>
</#macro>
<@cfb2 num=5></@cfb2>

nested 佔位指令

nested 指令執行自定義指令開始和結束標籤中間的模板片段。巢狀的片段可以包含模板中任意合法的內容。

<#--
    nested 佔位指令
        nested 相當於佔位符,一般結合macro指令一起使用。
        可以將自定義指令中的內容通過nested指令佔位，當使用自定義指令時，會將佔位內容顯示。
-->
<#macro test>
    這是一段文字！
    <#nested>
    <#nested>
</#macro>
<@test><h4>這是文字後面的內容！</h4></@test>

import 匯入指令

import 指令可以引入一個庫。也就是說，它建立一個新的名稱空間，然後在那個名稱空間中執行給定路徑的模板。可以使用引入的空間中的指令。

commons.ftl

<#macro cfb>
    <#list 1..9 as i>
        <#list 1..i as j>
            ${j}*${i}=${j*i}&nbsp;
        </#list>
        <br>
    </#list>
</#macro>

在其他ftl頁面中通過import匯入commons.ftl的名稱空間，使用該名稱空間中的指令

test.ftl

<#-- 匯入名稱空間 -->
<#import "commons.ftl" as common>
<#-- 使用名稱空間中的指令 -->
<@common.cfb></@common.cfb>

include 包含指令

可以使用 include 指令在你的模板中插入另外一個 FreeMarker 模板檔案。被包含模板的輸出格式是在 include 標籤出現的位置插入的。被包含的檔案和包含它的模板共享變數，就像是被複制貼上進去的一樣。

<#--包含指令(引入其他頁面檔案) include-->
<#--html檔案-->
<#include "test.html"> 

<#--freemarker檔案-->
<#include "test.ftl"> 

<#--text檔案-->
<#include "test.txt">

FreeMarker 頁面靜態化

通過上述介紹可知 Freemarker 是一種基於模板的、用來生成輸出文字的通用工具,所以
我們必須要定製符合自己業務的模板，然後生成自己的 html 頁面。Freemarker 是通過
freemarker.template.Configuration 這個物件對模板進行載入的（它也處理建立和快取預
解析模板的工作），然後我們通過 getTemplate 方法獲得你想要的模板，有一點要記住
freemarker.template.Configuration 在你整個應用必須保證唯一例項。

定義模板

news.ftl

<#-- 新聞標題 -->
<h1>${title}</h1>
<p>
    新聞來源：${source} &nbsp; 釋出時間：${pubTime?sring("yyyy-MM-dd HH:mm")}
</p>
<#-- 新聞內容 -->
<p>
    ${content}
</p>

載入模板


@WebServlet("/news")
public class NewsServlet extends HttpServlet {
    @Override
    protected void service(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        // 例項化模板配置物件
        Configuration configuration = new Configuration();
        // 設定載入模板的上下文 以及 設定載入模板路徑（模板存放的路徑）
        configuration.setServletContextForTemplateLoading(getServletContext(),"/template");
        // 設定模板的編碼格式
        configuration.setDefaultEncoding("UTF-8");
        // 載入模板檔案，獲取模板物件
        Template template = configuration.getTemplate("news.ftl");

         // 設定模型資料
        Map<String,Object> map = new HashMap<>();
        map.put("title", "特別就業季：穩就業情況如何? 哪些問題待解?");
        map.put("source", "人民日報");
        map.put("pubTime", new Date());
        map.put("content", "中共中央政治局常務委員會近日召開會議強調，" +
                "要有針對性地開展援企、穩崗、擴就業工作，" +
                "做好高校畢業生、農民工等重點群體就業工作，" +
                "積極幫助個體工商戶紓困。疫情期間，穩就業情況如何？還有哪些問題待解？" +
                "記者採訪了不同群體，記錄這個特別的就業季。");

        // 獲取專案所在的根目錄
        String basePath = request.getServletContext().getRealPath("/");
        // 設定頁面存放的目錄
        File htmlFile = new File(basePath + "/html");
        // 判斷目錄是否存在
        if (!htmlFile.exists()) {
            // 如果目錄不存在，則新建目錄
            htmlFile.mkdir();
        }
        // 獲取檔名（隨機生成不重複的檔名）
        String fileName = System.currentTimeMillis() + ".html";
        // 建立html檔案
        File file = new File(htmlFile, fileName);
        // 獲取檔案輸出流
        FileWriter writer = new FileWriter(file);
        try {
            // 輸出html  將模型資料填充到模板中
            template.process(map, writer);
            // 輸出成功
            System.out.println("新聞建立成功！");
        } catch (TemplateException e) {
            e.printStackTrace();
        } finally {
            writer.flush();
            writer.close();
        }
    }
}

生成對應的html檔案

瀏覽器位址列輸入：

http://localhost:8989/news

生成的檔案存放在當前專案的webapp目錄下的html目錄中。

FreeMarker 運算子

算術運算子

<!--
    算術運算
        +、-、*、/、%
-->
<#assign a1 = 8 a2 = 2 >
${a1} + ${a2} = ${a1 + a2} <br/>
${a1} - ${a2} = ${a1 - a2} <br/>
${a1} * ${a2} = ${a1 * a2} <br/>
${a1} / ${a2} = ${a1 / a2} <br/>
${a1} % ${a2} = ${a1 % a2} <br/>
<!--字串運算-->
${"hello" + "," + "freemarker"}

邏輯運算子

<#--
    邏輯運算子
     &&、||、!
-->

比較運算子

<#--
    比較運算子
        > (gt): 大於號，推薦使用 gt
        < (lt)： 小於號，推薦使用 lt
        >= (gte): 大於等於， 推薦是用 gte
        <= (lte): 小於等於，推薦使用 lte
        == ： 等於
        != : 不等於
-->

空值運算子

<#--
    空值運算子
     1. ??:判斷是否為空，返回布林型別
        如果不為空返回 false， 如果為空返回 true，不能直接輸出
        ${(name??)?string}
     2. !: 設定預設值，如果為空，則設定預設值
         1. 設定預設為空字串：
         ${name!}
         2. 設定指定預設值
         ${name!'zhangsan'}
-->

FreeMarker入門
2018-07-30
itextpdf freemarker渲染
2020-11-13
freemarker初次使用
2020-10-12
FreeMarker模板引擎
2021-07-09
freemarker 生成前端檔案
2024-04-13
前端
Java模板引擎之FreeMarker
2018-04-24
Java
關於FreeMarker模板注入
2021-11-12
freemarker 生成 Java 程式碼
2021-04-23
Java
springboot模版thymeleaf+freemarker
2020-11-29
Spring Boot
FreeMarker 之快速入門Demo
2018-07-05
java Freemarker 模版引擎工具類
2022-01-07
Java
Spring Boot 整合 FreeMarker 例項
2021-11-30
Spring Boot
spring原始碼分析之freemarker整合
2019-03-25
Spring原始碼
Spring Boot （三）模板引擎FreeMarker整合
2018-08-30
Spring Boot
從官方文件去學習之FreeMarker
2019-02-26
Java整合FreeMarker匯出Pdf檔案
2024-06-11
Java
FreeMarker對應各種資料結構解析
2019-01-07
資料結構
Spring Boot 最佳實踐（三）模板引擎FreeMarker整合
2018-08-30
Spring Boot
我是如何使用freemarker生成Word檔案的?
2020-09-14
使用freemarker將echarts圖片儲存到word中
2018-04-03
Echarts
Java使用FreeMarker模版技術動態生成word實踐
2022-06-14
Java
實現一個程式碼自動生成（一）：模板引擎Freemarker
2019-07-22
Spring Boot 整合 Freemarker，50 多行配置是怎麼省略掉的？
2019-07-05
Spring Boot
Freemarker的迴圈通過assign指令引入計數變數
2018-04-13
變數
SpringBoot2 整合FreeMarker模板，完成頁面靜態化處理
2020-07-20
Spring Boot
MyEclipse10中兩種FreeMarker外掛的安裝與配置
2020-04-04
Eclipse
freemarker根據靜態模板和動態模板生成PDF與Word
2020-11-26
Spring Boot 揭祕與實戰（七）實用技術篇 – FreeMarker 模板引擎
2019-02-21
Spring Boot
freemarker生成複雜樣式圖片並無檔案損壞的excel
2021-05-30
Excel
痞子衡嵌入式：MCUXpresso IDE下高度靈活的FreeMarker連結檔案模板機制
2022-11-26
UXIDE
Spring boot入門（三）：整合AdminLTE(Freemarker)，結合generate程式碼生成器，利用DataTable和PageHelper分頁
2019-02-28
Spring Boot
java企業官網原始碼自適應響應式 freemarker 靜態引擎模組設計方案
2021-11-10
Java原始碼
Apache struts2 Freemarker標籤遠端命令執行_CVE-2017-12611(S2-053)漏洞復現
2019-07-17
Apache

FreeMarker

FreeMarker

主要內容

FreeMarker 概述

FreeMarker概念

FreeMarker特性

通用目標

強大的模板語言

通用資料模型

為Web準備

智慧的國際化和本地化

強大的XML處理能力

FreeMarker環境搭建

新建 Maven Web專案

配置座標依賴和部署外掛

修改配置檔案 web.xml

編寫Servlet類

新建模板檔案 ftl

啟動專案

訪問專案

FreeMarker 資料型別

布林型別

日期型別

數值型別

字串型別

sequence 型別

hash 型別

FreeMarker 常見指令

assign 自定義變數指令

if elseif else 邏輯判斷指令

list 遍歷指令

macro 自定義指令

nested 佔位指令

import 匯入指令

include 包含指令

FreeMarker 頁面靜態化

定義模板

載入模板

生成對應的html檔案

FreeMarker 運算子

算術運算子

邏輯運算子

比較運算子

空值運算子

相關文章