freemark手册，入门文档资源-CSDN文库

共4个文件

doc：3个

chm：1个

freemark

入门文档

4星 · 超过85%的资源需积分: 9 114 浏览量 2010-04-30 19:47:03 上传评论收藏 890KB RAR 举报

资源推荐

资源详情

资源评论

收起资源包目录

freemarker.rar （4个子文件）

freemarker

freemarker.chm 826KB

Freemark 开发指南初稿.doc 94KB

FreeMarker设计指南.doc 199KB

freemarker模板的使用.doc 167KB

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>

评论收藏

内容反馈

killeraction

2013-07-31

入门足够了~
ahmian

2011-10-10

不错，文档很详细。

河马大爷

粉丝: 1
资源: 35

freemark 手册，入门文档

最新资源

freemark 手册，入门文档

Freemark基础入门+深入

freemark文档

freemark手册

freemark开发指南(入门)

freemark使用手册中文版

freemark学习文档

freemark学习资料（入门基础）

Freemark学习中文文档

Freemark 中文手册 0分

FreeMark Jar包 包括 中文 官方文档

test_Freemark freemark的基础入门小程序

freemark 概述 教程 5分钟入门 pdf

freemark操作手册

FreeMarker 快速入门 上手

FreeMarker使用手册_html_freemarker_

FreeMarker手册

freemark资料及eclipse的freemark插件

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

SwitchHosts

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

Notepad++安装包

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

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

Java面试八股文2023最新版

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

JDK1.8 windows 64位

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

myeclipse 10.7.1 windows 安装包

ja-netfilter-all

最新资源

FreeMark Jar包包括中文官方文档

freemark 概述教程 5分钟入门 pdf

FreeMarker 快速入门上手