FreeMarker学习

最新推荐文章于 2023-05-30 10:50:30 发布

原创最新推荐文章于 2023-05-30 10:50:30 发布 · 192 阅读

1 ·

CC 4.0 BY-SA版权

框架专栏收录该内容

4 篇文章

订阅专栏

一、什么是FreeMarker？

FreeMarker 是一款模板引擎：一种基于模板的、用来生成输出文本(任何来自于 HTML格式的文用本来自动生成源代码)的通用工具。它是为 Java 程序员提供的一个开发包或者说是类库。它不是面向最终用户，而是为程序员提供的嵌入他们开发产品的一款应用程序。

在这里插入图片描述

FreeMarker 背后（确切的说是 MVC 模式的背后）的重要思想就是表现逻辑和业务逻辑相分离。在模板只是处理显示问题，也就是视觉设计问题和格式问题。所准备的显示数据（如用户名等）与 FreeMarker 无关，通常是使用 Java 语言或其他目的语言来编写的。

概括地讲，模板和数据模型是 FreeMarker 所需，并用来生成输出内容的（比如之前展示的 HTML）：模板+数据模型=输出

二、Freemarker创建模板文件：

文本：直接输出的部分；
注释：即<#–…-->格式，注释不会输出；
插值：即$(…)部分，将会输出真实的值来替换花括号内的表达式，这样被称为interpolations 插值；
FTL指令：FreeMarker指令和HTML标记类似，名字前加#予以区分，不会输出；

三、FreeMarker遍历后台传递的list：

3.1、list 指令的一般格式为：

当需要用列表来遍历集合的内容时，list 指令是相当好用的。

<#list sequence as loopVariable>
    repeatThis
</#list>

repeatThis 部分将会在给定的sequence 遍历时的每项中重复，从第一项开始，一个接着一个。
所有的重复中 loopVariable 将持有当前项的值。
这个循环变量仅存在于<#list …>和</#list>标签之间。

<#list sequence as item>
     ... 
</#list>  
        这里：  sequence：表达式将被算作序列或集合 
                     item：循环变量（不是表达式）的名称

3.2、include指令

使用 include 指令，我们可以插入其他文件的内容到当前的模板中。

比方说，我们可以将版权信息单独存放在copyright_footer.html 文件中。

<hr>
<i>
Copyright (c) 2000 <a href="http://www.acmee.com">Acmee
Inc</a>,
<br>
All Rights Reserved.
</i>

当需要用到这个文件时，可以使用 include 指令来实现插入。

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

输出的内容为：

<html>
<head>
<title>Test page</title>
</head>
<body>
<h1>Test page</h1>
<p>Blah blah...
<hr>
<i>
Copyright (c) 2000 <a href="http://www.acmee.com">Acmee
Inc</a>,
<br>
All Rights Reserved.
</i>
</body>
</html>

如果改变了 copyright_footer.html 中的内容，那么访问者就会在所有页面中
看到新的版权声明信息了。

3.3、if，else，elseif 指令

<#if condition>   
    ... 
      <#elseif condition2>  
        ... 
            <#elseif condition3>  
            ... 
          ... 
    <#else>   
    ... 
</#if> 
这里：  condition，condition2 等：表达式将被计算成布尔值

3.4、switch，case，default，break 指令

<#switch value>   
    <#case refValue1>
        ...     
        <#break>   
    <#case refValue2>    
         ...     
        <#break>  
        ...   
        <#case refValueN>     
        ...     
        <#break>   
      <#default>     
      ... 
</#switch> 
这里：  value，refValue1 等：表达式将会计算成相同类型的标量。

描述

<#switch being.size>   
    <#case "small">      
        This will be processed if it is small      
        <#break>   
    <#case "medium">      
        This will be processed if it is medium      
        <#break>  
    <#case "large">      
        This will be processed if it is large      
        <#break>   
        <#default>      
            This will be processed if it is neither 
</#switch>