【免费】FreeMarker设计指南资源-CSDN文库

共1个文件

doc：1个

FreeMarker设计指南

需积分: 0 30 浏览量 2008-10-28 08:14:05 上传评论收藏 28KB RAR 举报

资源详情

资源评论

资源推荐

收起资源包目录

FreeMarker设计指南.rar （1个子文件）

FreeMarker设计指南.doc 210KB

FreeMarker

设计指南 ( 完整整理 )



FreeMarker 设计指南

1、快速入门

（1）模板 + 数据模型 = 输出

 FreeMarker 基于设计者和程序员是具有不同专业技能的不同个体的观念

 他们是分工劳动的：设计者专注于表示——创建 HTML 文件、图片、

Web 页面的其它可视化方面；程序员创建系统，生成设计页面要显示的数据

 经常会遇到的问题是：在 Web 页面（或其它类型的文档）中显示的信息

在设计页面时是无效的，是基于动态数据的

 在这里，你可以在 HTML（或其它要输出的文本）中加入一些特定指令，

FreeMarker 会在输出页面给最终用户时，用适当的数据替代这些代码

 下面是一个例子：

<html>

<head>

<title>Welcome!</title>

</head>

<body>

<h1>Welcome ${user}!</h1>

<p>Our latest product:

<a href="${latestProduct.url}">${latestProduct.name}</a>!

</body>

</html>

 这个例子是在简单的 HTML 中加入了一些由${…}包围的特定代码，这

些特定代码是 FreeMarker 的指令，而包含 FreeMarker 的指令的文件就称为

模板（Template）

 至于 user、latestProduct.url 和 latestProduct.name 来自于数据模

型（data model）

 数据模型由程序员编程来创建，向模板提供变化的信息，这些信息来自

于数据库、文件，甚至于在程序中直接生成

 模板设计者不关心数据从那儿来，只知道使用已经建立的数据模型

 下面是一个可能的数据模型：

(root)

+- user = "Big Joe"

+- latestProduct

+- url = "products/greenmouse.html"

+- name = "green mouse"

 数据模型类似于计算机的文件系统，latestProduct 可以看作是

2、数据模型

（1）基础

 在快速入门中介绍了在模板中使用的三种基本对象类型：scalars、hashes 和

sequences，其实还可以有其它更多的能力：

 scalars：存储单值

 hashes：充当其它对象的容器，每个都关联一个唯一的查询名字

 sequences：充当其它对象的容器，按次序访问

 方法：通过传递的参数进行计算，以新对象返回结果

 用户自定义 FTL 标记：宏和变换器

 通常每个变量只具有上述的一种能力，但一个变量可以具有多个上述能力，如下面的例

子：

(root)

+- mouse = "Yerri"

+- age = 12

+- color = "brown">

 mouse 既是 scalars 又是 hashes，将上面的数据模型合并到下面的模板：

${mouse} <#-- use mouse as scalar -->

${mouse.age} <#-- use mouse as hash -->

${mouse.color} <#-- use mouse as hash -->

 输出结果是：

Yerri

brown

（2）Scalar 变量

 Scalar 变量存储单值，可以是：

 字符串：简单文本，在模板中使用引号（单引号或双引号）括起

 数字：在模板中直接使用数字值

 日期：存储日期/时间相关的数据，可以是日期、时间或日期-时间（Timestamp）；通

常情况，日期值由程序员加到数据模型中，设计者只需要显示它们

 布尔值：true 或 false，通常在<#if …>标记中使用

（3）hashes 、sequences 和集合

 有些变量不包含任何可显示的内容，而是作为容器包含其它变量，者有两种类型：

 hashes：具有一个唯一的查询名字和它包含的每个变量相关联

 sequences：使用数字和它包含的每个变量相关联，索引值从 0 开始

 集合变量通常类似 sequences，除非无法访问它的大小和不能使用索引来获得它的子变

量；集合可以看作只能由<#list …>指令使用的受限 sequences

（4）方法

 方法变量通常是基于给出的参数计算值

 下面的例子假设程序员已经将方法变量 avg 放到数据模型中，用来计算数字平均值：

The average of 3 and 5 is: ${avg(3, 5)}

The average of 6 and 10 and 20 is: ${avg(6, 10, 20)}

The average of the price of python and elephant is: $

{avg(animals.python.price, animals.elephant.price)}

（5）宏和变换器

 宏和变换器变量是用户自定义指令（自定义 FTL 标记），会在后面讲述这些高级特性

（6）节点

 节点变量表示为树型结构中的一个节点，通常在 XML 处理中使用，会在后面的专门章节

中讲

3、模板

（1）整体结构

 模板使用 FTL（FreeMarker 模板语言）编写，是下面各部分的一个组合：

 文本：直接输出

 Interpolation：由${和}，或#{和}来限定，计算值替代输出

 FTL 标记：FreeMarker 指令，和 HTML 标记类似，名字前加#予以区分，

不会输出

 注释：由<#--和-->限定，不会输出

 下面是以一个具体模板例子：

<html>[BR]

<head>[BR]

<title>Welcome!</title>[BR]

</head>[BR]

<body>[BR]

<#--Greettheuserwithhis/hername-->[BR]

<h1>Welcome${user}!</h1>[BR]

<p>Wehavetheseanimals:[BR]

<ul>[BR]

<#listanimalsasbeing>[BR]

<li>${being.name}for${being.price} Euros[BR]

</#list>[BR]

</ul>[BR]

</body>[BR]

</html>

 [BR]是用于换行的特殊字符序列

 注意事项：

 FTL 区分大小写，所以 list 是正确的 FTL 指令，而 List 不是；${name}

和${NAME}是不同的

 Interpolation 只能在文本中使用

 FTL 标记不能位于另一个 FTL 标记内部，例如：

<#if <#include 'foo'>='bar'>...</if>

 注释可以位于 FTL 标记和 Interpolation 内部，如下面的例子：

<h1>Welcome${user <#-- The name of user -->}!</h1>[BR]

<p>Wehavetheseanimals:[BR]

<ul>[BR]

<#list<#-- some comment... --> animals as<#-- again... -->

being>[BR]

...

 多余的空白字符会在模板输出时移除

（2）指令

 在 FreeMarker 中，使用 FTL 标记引用指令

 有三种 FTL 标记，这和 HTML 标记是类似的：

 开始标记：<#directivename parameters>

 结束标记：</#directivename>

评论收藏

内容反馈

xiaowei121xiaowei

粉丝: 1
资源: 18

FreeMarker设计指南

评论0

最新资源

FreeMarker设计指南

评论0

FreeMarker 设计指南

SwitchHosts

安卓期末大作业（AndroidStudio开发），垃圾分类助手app，分为前台后台，代码有注释，均能正常运行

Notepad++安装包

微信小程序源码-合集1.rar

Java第十五届蓝桥杯大赛软件JavaB组真题

2024北森能力测评题库.7z

Java面试八股文2023最新版

Linux Centos7 升级最新版OpenSSH-9.6p1 有脚本（支持离线）

微信小程序商城系统(电商系统)(SpringBoot+Vue3)(至尊版) java毕业设计 源码+sql脚本+论文 完整版

JDK1.8 windows 64位

ruoyi-vue-pro 芋道源码项目的表结构

myeclipse 10.7.1 windows 安装包

jdk-11-windows-x64.zip

ruoyi-vue-pro开发指南PDF下载

教务管理系统——数据库课程设计mysql+java

ja-netfilter-all

2024最强Java面试八股文

基于spring boot的小区物业管理系统源码+论文+答辩ppt

Postman9.12.2中文版

Java面试题大全（备战2021）

图书管理系统(Java实现）[附完整代码]

Javaweb程序设计任务教程课后习题及答案 黑马程序员传智播客

JimuReport v1.5.4版本发布(Windows免安装版)

ide-eval-resetter-2.3.5.jar,重新定义idea使用时间

80个java开发项目经验.pdf

Fork使用教程（Git GUI页面可视化工具）

计算机专业精品毕业设计-JAVA在线考试管理系统

基于Java的CRM客户关系管理系统的设计和实现.zip

最新资源

微信小程序商城系统(电商系统)(SpringBoot+Vue3)(至尊版) java毕业设计源码+sql脚本+论文完整版

Javaweb程序设计任务教程课后习题及答案黑马程序员传智播客