FreeMarker模板引擎调研

最新推荐文章于 2020-08-20 10:44:27 发布

GYongJia

最新推荐文章于 2020-08-20 10:44:27 发布

阅读量212

点赞数

分类专栏： Java

本文链接：https://blog.csdn.net/GYongJia/article/details/108100121

版权

Java 专栏收录该内容

21 篇文章 0 订阅

订阅专栏

踩坑记录：

中文不显示问题：https://www.cnblogs.com/yunfeiyang-88/p/10984740.html

FreeMarker调研：http://freemarker.foofun.cn/index.html

FreeMarker基本指令：

if 指令

<#if animals.python.price < animals.elephant.price>
  Pythons are cheaper than elephants today.
<#elseif animals.elephant.price < animals.python.price>
  Elephants are cheaper than pythons today.
<#else>
  Elephants and pythons cost the same today.
</#if>

list 指令

方式一：
<table border=1>
  <#list animals as animal>
    <tr><td>${animal.name}<td>${animal.price} Euros
  </#list>
</table>

方式二：
<#list misc.fruits>
  <ul>
    <#items as fruit>
      <li>${fruit}</li>
    </#items>
  </ul>
</#list>

使用分割符：
<p>Fruits: <#list misc.fruits as fruit>${fruit}<#sep>, </#sep></#list>

include 指令

<html>
<head>
  <title>Test page</title>
</head>
<body>
  <h1>Test page</h1>
  <p>Blah blah...
  <#include "/copyright_footer.html">
</body>
</html>

使用内建函数

user?html 给出 user 的HTML转义版本， 比如 & 会由 &amp; 来代替。
user?upper_case 给出 user 值的大写版本 (比如 "JOHN DOE" 来替代 "John Doe")
animal.name?cap_first 给出 animal.name 的首字母大写版本(比如 "Mouse" 来替代 "mouse")
user?length 给出 user 值中 字符的数量(对于 "John Doe" 来说就是8)
animals?size 给出 animals 序列中 项目 的个数(我们示例数据模型中是3个)

如果在 <#list animals as animal> 和对应的 </#list> 标签中：
animal?index 给出了在 animals 中基于0开始的 animal的索引值
animal?counter 也像 index， 但是给出的是基于1的索引值
animal?item_parity 基于当前计数的奇偶性，给出字符串 "odd" 或 "even"。在给不同行着色时非常有用，比如在 <td class="${animal?item_parity}Row">中。

一些内建函数需要参数来指定行为，比如：
animal.protected?string("Y", "N") 基于 animal.protected 的布尔值来返回字符串 "Y" 或 "N"。
animal?item_cycle('lightRow','darkRow') 是之前介绍的 item_parity 更为常用的变体形式。
fruits?join(", ") 通过连接所有项，将列表转换为字符串， 在每个项之间插入参数分隔符(比如 "orange,banana")
user?starts_with("J") 根据 user 的首字母是否是 "J" 返回布尔值true或false。

处理不存在的变量

如果user不存在用字符串“visitor”填充
<h1>Welcome ${user!"visitor"}!</h1>

如果user存在输出语句，不存在则不输出
<#if user??><h1>Welcome ${user}!</h1></#if>

FTL表达式：http://freemarker.foofun.cn/dgui_template_exp.html

FreeMarkerSDK接入指南：http://freemarker.foofun.cn/pgui_quickstart_all.html

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

public class Test {

    public static void main(String[] args) throws Exception {
        
        /* ------------------------------------------------------------------------ */    
        /* You should do this ONLY ONCE in the whole application life-cycle:        */    
    
        /* Create and adjust the configuration singleton */
        Configuration cfg = new Configuration(Configuration.VERSION_2_3_22);
        cfg.setDirectoryForTemplateLoading(new File("/where/you/store/templates"));
        cfg.setDefaultEncoding("UTF-8");
        cfg.setTemplateExceptionHandler(TemplateExceptionHandler.RETHROW);

        /* ------------------------------------------------------------------------ */    
        /* You usually do these for MULTIPLE TIMES in the application life-cycle:   */    

        /* Create a data-model */
        Map root = new HashMap();
        root.put("user", "Big Joe");
        Map latest = new HashMap();
        root.put("latestProduct", latest);
        latest.put("url", "products/greenmouse.html");
        latest.put("name", "green mouse");

        /* Get the template (uses cache internally) */
        Template temp = cfg.getTemplate("test.ftl");

        /* Merge data-model with template */
        Writer out = new OutputStreamWriter(System.out);
        temp.process(root, out);
        // Note: Depending on what `out` is, you may need to call `out.close()`.
        // This is usually the case for file output, but not for servlet output.
    }
}