2. 程式人生 > >Freemarker使用教程——入門篇

Freemarker使用教程——入門篇

阿新 • • 發佈：2019-01-23

一.簡介

FreeMarker 是一個模板引擎，一個基於模板生成文字輸出的通用工具，使用純 Java 編寫，FreeMarker 被設計用來生成 HTML Web 頁面，特別是基於 MVC 模式的應用程式，雖然 FreeMarker 具有一些程式設計的能力，但通常由 Java 程式準備要顯示的資料，由FreeMarker 生成頁面，通過模板顯示準備的資料

FreeMarker 不是一個 Web 應用框架，而適合作為 Web 應用框架一個元件。FreeMarker 與容器無關，因為它並不知道 HTTP 或 Servlet；FreeMarker 同樣可以應用於非Web應用程式環境，FreeMarker 更適合作為 Model2 框架（如 Struts）的檢視元件，你也可以在模板中使用 JSP標記庫。另外，FreeMarker是免費的。

2.應用場景

比較適合運用在訪問量大（或頁面資料量大），但是資料很少與後臺進行互動（即對實時性要求不是很高的）的頁面，比如商品網站上的商品詳情頁等。

3.前期準備

要想使用freemarker，首先必須要有freemarker的jar包，這個網際網路上隨處可以下載，這邊就不多說

<dependency>
<groupId>freemarker</groupId>
<artifactId>freemarker</artifactId>
<version>2.3.9</version>
</dependency>


4.入門demo

(1)建立一個testFreemarker類

import java.io.File;
import java.io.FileWriter;
import java.io.Writer;
import java.util.HashMap;
import java.util.Map;
import freemarker.template.Configuration;
import freemarker.template.Template;


/**
 * @作者：JackHisen(GWD)
 * @專案名：freemarker
 * @時間：2017-7-25 下午2:39:45
 * @version 1.0
 */
public class testFreemarker {
	public static void main(String[] args) throws Exception {
		String dir="H:\\Java-EE Workspace\\freemarker\\src\\com\\gwd\\freemarker";
		Configuration conf = new Configuration();
		//載入模板檔案(模板的路徑)
		conf.setDirectoryForTemplateLoading(new File(dir));
		// 載入模板
		Template template = conf.getTemplate("/freemarker-demo.ftl");
		// 定義資料
		
		Map root = new HashMap();
                root.put("world", "Hello World");
		// 定義輸出
		Writer out = new FileWriter(dir + "/freemarker.html");
		template.process(root, out);
		System.out.println("轉換成功");
		out.flush();
		out.close();
	}
}

專案目錄如下，其中freemarker.html檔案是執行main函式後自動生成的，freemarker-demo.ftl為模板

(2)freemarker模板中寫入內容

(3)生成的html頁面：


5.其他資料型別

1.實體bean

（1）建立Person類

public class Person {
	private int id;
	private String name;
	public int getId() {
		return id;
	}
	public void setId(int id) {
		this.id = id;
	}
	public String getName() {
		return name;
	}
	public void setName(String name) {
		this.name = name;
	}
}
（2）testFreemarker
public class testFreemarker {
	public static void main(String[] args) throws Exception {
		String dir="H:\\Java-EE Workspace\\freemarker\\src\\com\\gwd\\freemarker";
		Configuration conf = new Configuration();
		//載入模板檔案(模板的路徑)
		conf.setDirectoryForTemplateLoading(new File(dir));
		// 載入模板
		Template template = conf.getTemplate("/freemarker-demo.ftl");
		// 定義資料
		
		Person person=new Person();
		person.setId(1);
		person.setName("小明");
		Map root = new HashMap();
		root.put("person", person);
		// 定義輸出
		Writer out = new FileWriter(dir + "/freemarker.html");
		template.process(root, out);
		System.out.println("轉換成功");
		out.flush();
		out.close();
	}
}

（3）Freemarker模板 
${person.id}
${person.name}

（4）生成的html頁面


2.List集合

（1）testFreemarker

public class testFreemarker {
	public static void main(String[] args) throws Exception {
		String dir="H:\\Java-EE Workspace\\freemarker\\src\\com\\gwd\\freemarker";
		Configuration conf = new Configuration();
		//載入模板檔案(模板的路徑)
		conf.setDirectoryForTemplateLoading(new File(dir));
		// 載入模板
		Template template = conf.getTemplate("/freemarker-demo.ftl");
		// 定義資料
		
		Person p1=new Person();
		p1.setId(1);
		p1.setName("小明");
		Person p2=new Person();
		p2.setId(2);
		p2.setName("小華");
		List<Person> person=new ArrayList<Person>();
		person.add(p1);
		person.add(p2);
		Map root = new HashMap();
		root.put("person", person);
		// 定義輸出
		Writer out = new FileWriter(dir + "/freemarker.html");
		template.process(root, out);
		System.out.println("轉換成功");
		out.flush();
		out.close();
	}
}

（2）模板 
<#list person as p>
${p.id}/${p.name}
</#list>

（3）生成的html檔案

3.Map集合

1.testFreemarker

public class testFreemarker {
	public static void main(String[] args) throws Exception {
		String dir="H:\\Java-EE Workspace\\freemarker\\src\\com\\gwd\\freemarker";
		Configuration conf = new Configuration();
		//載入模板檔案(模板的路徑)
		conf.setDirectoryForTemplateLoading(new File(dir));
		// 載入模板
		Template template = conf.getTemplate("/freemarker-demo.ftl");
		// 定義資料
		
		Map root = new HashMap();
		Map mxs = new HashMap();
		mxs.put("fbb","范冰冰");
		mxs.put("lbb","李冰冰");

		root.put("mxs",mxs);

		// 定義輸出
		Writer out = new FileWriter(dir + "/freemarker.html");
		template.process(root, out);
		System.out.println("轉換成功");
		out.flush();
		out.close();
	}
}

2.模板（兩種寫法） 
${mxs.fbb}/${mxs.lbb}


<#list mxs?keys as k>
   ${mxs[k]}
</#list>

3.生成的html


4.List<Map>集合

1.testFreemarker

public class testFreemarker {
	public static void main(String[] args) throws Exception {
		String dir="H:\\Java-EE Workspace\\freemarker\\src\\com\\gwd\\freemarker";
		Configuration conf = new Configuration();
		//載入模板檔案(模板的路徑)
		conf.setDirectoryForTemplateLoading(new File(dir));
		// 載入模板
		Template template = conf.getTemplate("/freemarker-demo.ftl");
		// 定義資料
		
		Map root = new HashMap();
		List<Map> maps = new ArrayList<Map>();
		Map pms1 = new HashMap();
		pms1.put("id1", "范冰冰");
		pms1.put("id2", "李冰冰");
		Map pms2 = new HashMap();
		pms2.put("id1", "曾志偉");
		pms2.put("id2", "何炅");
		maps.add(pms1);
		maps.add(pms2);
		root.put("maps", maps);

		// 定義輸出
		Writer out = new FileWriter(dir + "/freemarker.html");
		template.process(root, out);
		System.out.println("轉換成功");
		out.flush();
		out.close();
	}
}
2.模板（2種） 
<#list maps as m>
	${m.id1}/${m.id2}
</#list>


<#list maps as m>
	<#list m?keys as k>
		${m[k]}
	</#list>
</#list>

3.生成的html

5.獲得當前迭代的索引

(1)testFreemarker

public class testFreemarker {
	public static void main(String[] args) throws Exception {
		String dir="H:\\Java-EE Workspace\\freemarker\\src\\com\\gwd\\freemarker";
		Configuration conf = new Configuration();
		//載入模板檔案(模板的路徑)
		conf.setDirectoryForTemplateLoading(new File(dir));
		// 載入模板
		Template template = conf.getTemplate("/freemarker-demo.ftl");
		// 定義資料
		
		Map root = new HashMap();
		Person p1=new Person();
		p1.setId(1);
		p1.setName("李冰冰");
		Person p2=new Person();
		p2.setId(2);
		p2.setName("范冰冰");
		Person p3=new Person();
		p3.setId(3);
		p3.setName("沙冰冰");
		List<Person> list = new ArrayList<Person>();
		list.add(p1);
		list.add(p2);
		list.add(p3);
		root.put("persons", list);

		// 定義輸出
		Writer out = new FileWriter(dir + "/freemarker.html");
		template.process(root, out);
		System.out.println("轉換成功");
		out.flush();
		out.close();
	}
}

(2)模板 
<#list persons as p>
	${p_index}
</#list>

(3)生成的html檔案


（6）在模板中進行賦值

（1）testFreemarker

package com.gwd.freemarker;

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

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


/**
 * @作者：JackHisen(GWD)
 * @專案名：freemarker
 * @時間：2017-7-25 下午2:39:45
 * @version 1.0
 */
public class testFreemarker {
	public static void main(String[] args) throws Exception {
		String dir="H:\\Java-EE Workspace\\freemarker\\src\\com\\gwd\\freemarker";
		Configuration conf = new Configuration();
		//載入模板檔案(模板的路徑)
		conf.setDirectoryForTemplateLoading(new File(dir));
		// 載入模板
		Template template = conf.getTemplate("/freemarker-demo.ftl");
		// 定義資料
		
		Map root = new HashMap();
		
		root.put("world","hello world");

		// 定義輸出
		Writer out = new FileWriter(dir + "/freemarker.html");
		template.process(root, out);
		System.out.println("轉換成功");
		out.flush();
		out.close();
	}
}

（2）模板 
<#assign x="${world}" />
${x}

<#assign x>
   <#list ["星期一", "星期二", "星期三", "星期四", "星期五", "星期六", "星期天"] as n>
      ${n}
   </#list>
</#assign>
${x}

(3)生成的html

7.if語句

(1)申明：一般情況下模板中的資料來源於後臺，但是這邊為了方便演示，所以資料都在模板中寫死了，後臺testFreemarker可以同上，但實際上map可以為空，只要確保能生成html頁面即可

(2)模板

<#list ["星期一", "星期二", "星期三", "星期四", "星期五", "星期六", "星期天"] as n>
<#if n != "星期一">
   ${n}
</#if>
</#list>


(3)生成的html檔案


8.else語句

(1)模板

<#list ["星期一", "星期二", "星期三", "星期四", "星期五", "星期六", "星期天"] as n>
<#if (n_index == 1) || (n_index == 3)>
   ${n} --紅色
<#else>
${n} --綠色
</#if>
</#list>

(2)生成的html

9.格式化日期

(1)testFreemarker

public class testFreemarker {
	public static void main(String[] args) throws Exception {
		String dir="H:\\Java-EE Workspace\\freemarker\\src\\com\\gwd\\freemarker";
		Configuration conf = new Configuration();
		//載入模板檔案(模板的路徑)
		conf.setDirectoryForTemplateLoading(new File(dir));
		// 載入模板
		Template template = conf.getTemplate("/freemarker-demo.ftl");
		// 定義資料
		
		Map root = new HashMap();
		
		root.put("cur_time",new Date());
			
		// 定義輸出
		Writer out = new FileWriter(dir + "/freemarker.html");
		template.process(root, out);
		System.out.println("轉換成功");
		out.flush();
		out.close();
	}
}

(2)日期模板 
${cur_time?date}
生成html

(3)日期時間模板

${cur_time?datetime}
生成html

(4)時間模板

${cur_time?time}

生成html

10.對null的處理

(1)testFreemarker

public class testFreemarker {
	public static void main(String[] args) throws Exception {
		String dir="H:\\Java-EE Workspace\\freemarker\\src\\com\\gwd\\freemarker";
		Configuration conf = new Configuration();
		//載入模板檔案(模板的路徑)
		conf.setDirectoryForTemplateLoading(new File(dir));
		// 載入模板
		Template template = conf.getTemplate("/freemarker-demo.ftl");
		// 定義資料
		
		Map root = new HashMap();
		
		root.put("world",null);
			
		// 定義輸出
		Writer out = new FileWriter(dir + "/freemarker.html");
		template.process(root, out);
		System.out.println("轉換成功");
		out.flush();
		out.close();
	}
}

(2)null為空模板 
${world!}         ——前面有個null
生成html


(3)為null時給預設值模板

${world!"如果world為null，我就會顯示"}
生成的html

11.巨集定義

(1)普通巨集定義

模板：

<#macro table u>
${u} 
</#macro>
<@table u="這個是巨集定義" />

生成的html

(2)擴充套件巨集定義

模板：

<#macro table u>
 ${u}
<#nested/>
</#macro>
<@table u=8 >我是擴充套件的巨集定義</@table>
生成的html


相關推薦

Freemarker使用教程——入門篇

一.簡介 FreeMarker 是一個模板引擎，一個基於模板生成文字輸出的通用工具，使用純 Java 編寫，FreeMarker 被設計用來生成 HTML Web 頁面，特別是基於 MVC 模式的應用程式，雖然 FreeMarker 具有一些程式設計的能力，但通常由 Jav

Android Studio2.2.3 使用教程-入門篇

android最近學習下Android APK的內容，保持學習的一些文章：Android Studio 2.2.3工具使用：http://blog.csdn.net/qq_16313365/article/details/52537397待續本文出自 “專註嵌入式多媒體技術” 博客，請務必保留此出處http:

【helloworld】-微信小程序開發教程-入門篇【3】

window 學習 視圖 小程序教程 href htm mtv 傳送門 lar 1. 開篇導言 本節目標：通過上一節的講解，相信大家對小程序框架MINA有了初步了解。接下來將會對其進行深入介紹。 目標用戶：無編程經驗，但對微信小程序感興趣的同學。 學習目標：了解M

【helloworld】-微信小程序開發教程-入門篇【4】

頁面 lob 分享圖片 簡化 指定 ram 圖層 備註 family 1. 開篇導言 本節目標：通過上一節的講解，相信大家對小程序框架MINA的目錄結構和配置有了一定的了解。接下來將會講解視圖層，邏輯層及其之間的交互。 目標用戶：無編程經驗，但對微信小程序感興趣的

【helloworld】-微信小程序開發教程-入門篇【1】

基本 微信小程序開發 AI 彈出對話框 頁面 com 基本使用 alt 案例演示 1. 開篇導言 本節目標：旨在演示如何用開發者工具構建並運行簡單的 helloworld 應用。 目標用戶：無編程經驗，但對微信小程序感興趣的同學。 學習目標：開發者工具的基本使用流程

【helloworld】-微信小程序開發教程-入門篇【5】

總結 mta top eight page ota 技術分享 小程序 attach 1. 開篇導言 本節目標：通過之前的講解，相信大家對於微信小程序本身有了一定的認識。本篇將專註於講解IDE的調試功能。 目標用戶：無編程經驗，但對微信小程序感興趣的同學。 學習目標

JavaWeb安全性教程入門篇 -- 偷天換日使用者的會話資訊(劫持session)

        好久沒有更新部落格了,這段時間打算有空就更新下關於java web專案安全方面的教程文章,包括簡單的說明下hacker是如何滲透入侵我們的專案,基於鄙人的技術是比較菜,所以如有說的不正確的,或者大神覺得我寫的文章太過淺顯,請多多包涵包涵下,多多指導下吾等菜鳥,

Android Studio2.0使用教程-入門篇

1.大體認知 1.1模式         AS是基於idea，而idea和eclipse有大的區別，有好處也有不好的地方，在一段時間裡，idea被認為是開發java最好用強大的ide工具，所以AS新建的時候有new application和new module開發。id

CodeIgniter 入門教程第一篇：信息發布

per 所有 控制 知識點 image doc ref har 提交 一、MVC CodeIgniter 采用MVC架構即：控制層、模型層和視圖層。 對應Application下面的文件夾 （圖1）： 所有新建文件以.php結尾 視圖層

Maven教程--入門就看這一篇就夠了

第1章：Maven概述/1.1 Maven的概念 第1章：Maven概述/1.2 Maven的功能 第1章：Maven概述/1.3 與其它構建相比/1.3.1 Make 第1章：Maven概述/1.3 與其它構建相比/1.3.2 Ant 第2章：Maven的安裝/2.1

Vue 框架-01- 入門篇 圖文教程

Vue 框架-01- 入門篇 圖文教程 Vue 官網：https://cn.vuejs.org/ 關於 Vue 的基礎大家可以在官網的【起步】去學習，本系列文章主要針對例項專案應用 一、Vue 的安裝與使用 1.線上引用： <!-- 直接引用 -->

Spring Boot -01- 快速入門篇（圖文教程）

Spring Boot -01- 快速入門篇（圖文教程） 今天開始不斷整理 Spring Boot 2.0 版本學習筆記，大家可以在部落格看到我的筆記，然後大家想看視訊課程也可以到【慕課網】手機 app，去找【Spring Boot 2.0 深度實踐】的課程，令人開心的是，課程完全免費！ 什麼是 Spri

ESP32系列教程：《入門篇：ESP32開發環境搭建》--Windows下使用VScode搭建ESP32開發環境

github地址：https://github.com/xiaolongba/wireless-tech 如何搭建ESP32開發環境 前言 ESP32是樂鑫在其上一代ESP8266一炮而紅之後,推出的第二代高性價比的產品,ESP32在上一代的基礎上增加了藍芽4.2的功能,加上

易學筆記--python教程--入門就看這一篇就夠了

易學筆記 十年IT經驗個人學習筆記分享: 開發語言：C/C++/JAVA/PYTHON/GO/JSP WEB架構：Servlets/springMVC/springBoot/springClound 容器架構:Docker容器/Docker叢集/Docker與微服務整合/

BAT指令碼編寫教程簡單入門篇

批處理檔案最常用的幾個命令： echo表示顯示此命令後的字元  echo on  表示在此語句後所有執行的命令都顯示命令列本身 echo off 表示在此語句後所有執行的命令都不顯示命令列本身@與ec

一篇很全面的freemarker教程

以下內容全部是網上收集： FreeMarker的模板檔案並不比HTML頁面複雜多少,FreeMarker模板檔案主要由如下4個部分組成: 1,文字:直接輸出的部分 2,註釋:<#-- ... -->格式部分,不會輸出 3,插值:即

ESP32系列教程：《入門篇：建立第一個熱點》

[github原始碼地址] (https://github.com/xiaolongba/wireless-tech/tree/master/%E8%BD%AF%E4%BB%B6/%E7%BA%A2%E6%97%AD%E6%97%A0%E7%BA%BF%E5%BC%80%E5%8F%91%E6%

ESP32系列教程：《入門篇：ESP32開發環境搭建優化》，windows下開發速度堪比Linux

github教程地址： 優化一：https://github.com/xiaolongba/wireless-tech/blob/master/%E8%BD%AF%E4%BB%B6/%E7%BA%A2%E6%97%AD%E6%97%A0%E7%BA%BF%E5%BC%80%E5%8F%91%

一篇很全的FreeMarker教程

copy自http://demojava.iteye.com/blog/800204 以下內容全部是網上收集：  FreeMarker的模板檔案並不比HTML頁面複雜多少,FreeMarker模板檔案主要由如下4個部分組成:  1,文字:直接輸出的部分 

DirectX11入門教程——第二篇：DirectX11的基礎知識

本系列系作者原創，可隨便轉發但一定要註明出處 剛才明明說盡量不跳章的，為啥一進來就變成第二章，這裡首先用幾句話說明一下原因：因為第一章我想留給更基礎更概念的GPU發展史和管線描述。在此對不起大家了。不過我保證這個系列初步成型後絕對不跳章 2010年5月微軟釋出了Direct