FreeMarker

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"?><projectxmlns="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-appid="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類

packagecom.xxxx.controllter;importjavax.servlet.ServletException;importjavax.servlet.annotation.WebServlet;importjavax.servlet.http.HttpServlet;importjavax.servlet.http.HttpServletRequest;importjavax.servlet.http.HttpServletResponse;importjava.io.IOException;@WebServlet("/f01")publicclassFreeMarker01extendsHttpServlet{@Overrideprotectedvoidservice(HttpServletRequest request,HttpServletResponse response)throwsServletException,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",newDate());

獲取數據

<#--

? ? 數據類型:日期類型

? ? ? ? 在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=newString[]{"周杰倫","林俊杰","陳奕迅","五月天"};request.setAttribute("stars",stars);// List操作List<String>citys=Arrays.asList("上海","北京","杭州","深圳");request.setAttribute("cityList",citys);// JavaBean集合List<User>userList=newArrayList<>();userList.add(newUser(1,"zhangsan",22));userList.add(newUser(2,"lisi",18));userList.add(newUser(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=newHashMap<>();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")publicclassNewsServletextendsHttpServlet{@Overrideprotectedvoidservice(HttpServletRequest request,HttpServletResponse response)throwsServletException,IOException{// 實例化模板配置對象Configuration configuration=newConfiguration();// 設置加載模板的上下文 以及 設置加載模板路徑(模板存放的路徑)configuration.setServletContextForTemplateLoading(getServletContext(),"/template");// 設置模板的編碼格式configuration.setDefaultEncoding("UTF-8");// 加載模板文件,獲取模板對象Template template=configuration.getTemplate("news.ftl");// 設置模型數據Map<String,Object>map=newHashMap<>();map.put("title","特別就業季:穩就業情況如何? 哪些問題待解?");map.put("source","人民日報");map.put("pubTime",newDate());map.put("content","中共中央政治局常務委員會近日召開會議強調,"+"要有針對性地開展援企、穩崗、擴就業工作,"+"做好高校畢業生、農民工等重點群體就業工作,"+"積極幫助個體工商戶紓困。疫情期間,穩就業情況如何?還有哪些問題待解?"+"記者采訪了不同群體,記錄這個特別的就業季。");// 獲取項目所在的根目錄String basePath=request.getServletContext().getRealPath("/");// 設置頁面存放的目錄File htmlFile=newFile(basePath+"/html");// 判斷目錄是否存在if(!htmlFile.exists()){// 如果目錄不存在,則新建目錄htmlFile.mkdir();}// 獲取文件名(隨機生成不重復的文件名)String fileName=System.currentTimeMillis()+".html";// 創建html文件File file=newFile(htmlFile,fileName);// 獲取文件輸出流FileWriter writer=newFileWriter(file);try{// 輸出html? 將模型數據填充到模板中template.process(map,writer);// 輸出成功System.out.println("新聞創建成功!");}catch(TemplateExceptione){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'}

-->

?著作權歸作者所有,轉載或內容合作請聯系作者
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 227,572評論 6 531
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 98,071評論 3 414
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 175,409評論 0 373
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 62,569評論 1 307
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 71,360評論 6 404
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 54,895評論 1 321
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 42,979評論 3 440
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,123評論 0 286
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 48,643評論 1 333
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 40,559評論 3 354
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 42,742評論 1 369
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,250評論 5 356
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 43,981評論 3 346
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,363評論 0 25
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 35,622評論 1 280
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 51,354評論 3 390
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 47,707評論 2 370

推薦閱讀更多精彩內容

  • FreeMarker語言 FreeMarker語言概述 FreeMarker是一個模板引擎,一個基于模板生成文本輸...
    wanggs閱讀 2,045評論 0 6
  • FreeMarker的模板文件并不比HTML頁面復雜多少,FreeMarker模板文件主要由如下4個部分組成: 1...
    年輕小伙程序員閱讀 3,020評論 0 5
  • 目錄 前言 FTL指令規則 插值規則 表達式 FreeMarker的常用指令 高級方法 前言 FreeMarker...
    garyond閱讀 4,766評論 0 8
  • 簡介FreeMarker的模板文件并不比HTML頁面復雜多少,FreeMarker模板文件主要由如下4個部分組成:...
    意淺離殤閱讀 2,000評論 0 3
  • FreeMarker是一款模板引擎:即一種基于模板和要改變的數據,并用來生成輸出文本(HTML網頁、電子郵件、配置...
    弒神指閱讀 631評論 2 0