freemarker的常見指令有哪些--樂字節前端

時間  2020-07-29
標籤 freemarker 常見 指令 哪些 字節 前端 欄目 FreeMarker 简体版
原文   原文鏈接

FreeMarker 常見指令

assign 自定義變量指令

​ 使用 assign 指令你能夠建立一個新的變量， 或者替換一個已經存在的變量。html

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

>若有疑問，可加我私人VX[ kengwanglaoxue ],更多Java學習資料關注公衆號【樂字節】獲取

### if  elseif  else 邏輯判斷指令

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

```F#
<#--
    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 指令來對序列進行遍歷。web

```F#
<#--
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>app

<#assign users3 = []>
<#-- 當序列沒有數據項時，使用默認信息 -->
<#list users3 as user>
${user}
<#else>
當前沒有數據！
</#list>webapp

### macro 自定義指令 

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

```F#
<#--
    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 指令執行自定義指令開始和結束標籤中間的模板片斷。嵌套的片斷能夠包含模板中任意合法的內容。ide

```F#
<#--
nested 佔位指令
nested 至關於佔位符,通常結合macro指令一塊兒使用。
能夠將自定義指令中的內容經過nested指令佔位，當使用自定義指令時，會將佔位內容顯示。
-->
<#macro test>
這是一段文本！
<#nested>
<#nested>
</#macro>
<@test><h4>這是文本後面的內容！</h4></@test>工具

### import 導入指令

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

commons.ftl

```F#
<#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

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

### include 包含指令

​   可使用 `include` 指令在你的模板中插入另一個 FreeMarker 模板文件 。 被包含模板的輸出格式是在 `include` 標籤出現的位置插入的。 被包含的文件和包含它的模板共享變量，就像是被複制粘貼進去的同樣。

```F#
<#--包含指令(引入其餘頁面文件) 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

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

### 加載模板

```java
@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 運算符

算術運算符

```F#
<!--
算術運算
+、-、、/、%
-->
<#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"}

### 邏輯運算符

```F#
<#--
    邏輯運算符
     &&、||、!
-->

比較運算符

```F#
<#--
比較運算符

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

 
 
 
 
空值運算符
 
 
```F#
<#--
空值運算符
 
 
     
  
  1. ??:判斷是否爲空，返回布爾類型
    若是不爲空返回 false， 若是爲空返回 true，不能直接輸出
    ${(name??)?string}
    2.  
  
  2. !: 設置默認值，若是爲空，則設置默認值 
   
       
    
    1. 設置默認爲空字符串：
      ${name!}
      2.  
    
    2. 設置指定默認值
      ${name!'zhangsan'}
      --> 
      3.  
   
    3.  
 
 
 
image
 



        

            

        	





    

		

            
相關文章

            

                

                

                    

                

            


            
相關標籤/搜索

            
        


    

        

            

        

        

        
        

        

        

    




	

    





    

    	

    

        每日一句
    

    
    
    	每一个你不满意的现在，都有一个你没有努力的曾经。
    







    

    


    



    

        本站公眾號
    

    

           歡迎關注本站公眾號,獲取更多信息

        
    




    

    




	


	







    

        聯繫我們
        最近搜索
        最新文章
        
        沪ICP备13005482号-10

            MyBatis教程
            SQL 教程
            MySQL教程
            Java 教程
            Thymeleaf 教程
            Hibernate教程
            Spring教程 
            Redis教程