0基础人群-freemaker模板技术中需要了解的数值和类型

2015-07-29 22:57:42 暂无评论阳光倾城模板引擎 1,050

这部分对于程序员来说可以直接跳过这，它和程序语言中的数值类型是相似的。
你所知道的来自于每天所使用的数字，比如 16，0.5 等这些用语就是数值的示例，也就
是数字。在计算机语言中，这些用语有着更广泛的含义，比如数值并不一定是数字值，看下
面这个数据模型：
(root)
|
+- user = “Big Joe”
|
+- today = Jul 6, 2007
|
+- todayHoliday = false
|
+- lotteryNumbers
| |
| +- (1st) = 20
| |
| +- (2st) = 14
| |
| +- (3rd) = 42
| |
| +- (4th) = 8
| |
| +- (5th) = 15
|
+- cargo
      |
      +- name = “coal”
      |
      +- weight = 40
我们说变量 user 的数值是” Big Joe”（字符串），today 的数值是 Jul 6,2007（日期），
todayHoilday 的数值是 false（布尔值，是/否，这样的值）。lotteryNumbers 的
数值是包含 20，14，42，8，15 的序列。在这种意义上，lotteryNumbers 是多值的，
它包含多个数值（如其中的第二项是 14），但是 lotteryNumbers 本身还是单值。它像
一个装有很多东西的盒子，整个盒子被看做是独立的。最后有一个数值 cargo，它是一个
哈希表（也可以看做是盒子）。所以数值就是存储在变量中的（在 user ，cargo 或
cargo.name 中）东西。但是不需要存储的数值也可以称之为数值，比如这里的数字 100：

当模板被执行时，计算的临时结果也称为数值，比如 20+120（它会打印 120）：

${cargo.weight / 2 + 100}

这最后一种的解释：两个数 40（货物的重量）和 2 相除的结果是 20，这是一个新计算
出的数值。把它和 100 相加，那么 120 就出来了，接着就打印出来了（${…}），接着模板
继续向下执行直到所有结果都计算出来。
现在你应该能体会到数值这个词的含义了，不仅仅是数字的值。

什么是类型

数值中非常重要的一个概念就是类型。比方说，变量 user 的类型是字符串，
lotteryNumbers 的类型是序列。数值的类型非常重要，因为它决定了这些数值可以在
哪里使用的最大限度。比如${user/2}就是错误的，但是${cargo.weight/2}就能
计算出结果 20，除法仅对数字值有效，而不能作用于字符串。仅当 cargo 是一个哈希表

条件 condition 只能是布尔值等。
注意：
这里说一点点术语：称 “布尔”或“布尔值”或“布尔类型”都是相同的含义。
数值同时也可以含有多种类型，尽管这样很少使用。看下面这个数据模型 mouse，就
又是字符串又是哈希表。

(root)
|
+- mouse = “Yerri”
     |
     +- age = 12
     |
     +- color = “brown”

如果用上面的数据模型合并到模板中，就该这么来写：

输出：

Yerri
12
brown

数据模型是哈希表

注意观察每个你已经知道的数据模型：被”(root)”标识的内容就是哈希表类型的数值（比如HashMap、HashTable）。
当书写如 user 这样的代码，那就意味着想要把”user ”变量存储在哈希表的根上。而如果代
码是：root.user，也没有名为”root”的变量，那么这就没有任何作用。
某些人也许会被这种数据模型的例子所困惑，也就是说，根哈希表包含更多的哈希表或
序列（如 lotteryNumbers 和 cargo）。其他就没有更特殊的了。哈希表包含其他变量，那些变
量包含数值，数值可以是字符串，数字等，当然也可以是哈希表或序列。最初我们解释过，
就像字符串和数字，序列或哈希表也是数值。

支持的类型

  标量：
   字符串
   数字
   布尔值
   日期
  容器：
   哈希表
   序列
   集
  子程序：
   方法和函数
   用户自定义指令
  其它/很少使用：
   节点

标量是最基本，最简单的数值类型，它们可以是：
 字符串：简单的文本，例如：产品的名称。
如果想在模板中直接给出字符串的值，而不是使用数据模型中的变量，那么将文本
写在引号内即可，比如”green mouse”或者'green mouse'。

数字：例如：产品的价格。整数和非整数是不区分的，只有单一的数字类型。比如
使用了计算器，计算 3/2 的结果是 1.5 而不是 1。
如果要在模板中直接给出数字的值，可以这么来写： 150， -90.05，或者 0.001。
（关于语法的更多细节请看后续章节）
 布尔值：布尔值代表了逻辑上的对或错（是或否）。例如：用户到底是否登录了。

尔值。
在模板中可以使用保留字 true 和 false 来指定布尔值。
 日期：日期变量可以存储和日期/时间相关的数据。一共有三种变化。
 精确到天的日期（通常指的是“日期”），比如 April 4, 2003
 每天的时间（不包括日期部分），比如 10:19:18 PM。时间的存储精确到毫秒。
 日期-时间（也称作“时间戳”），比如 April 4, 2003 10:19:18 PM。时间部分的
存储精确到毫秒。
不幸的是，受到 Java 平台的限制，FreeMarker 是不能决定日期的部哪分来使用（也就
是说，是日期-时间格式，每天的时间格式等）。这个问题的解决方法是高级主题了，后面的
章节将会讨论到。
在模板中直接定义日期数值是可以的，但这也是高级主题，后面的章节将会讨论到。
要记住，FreeMarker 区别字符串，数字和布尔值，所以字符串”150”和数字 150 是完全
不同的两种数值。数字持有的是数字的值，布尔值表达的是逻辑上的对或错。字符串可以是
任意字符的序列。

容器

这些值存在的目的是为了包含其他变量，它们仅仅作为容器。被包含的变量通常是子变
量。容器的类型有：
 哈希表：每个子变量都可以通过一个唯一的名称来查找，这个名称是不受限制的字
符串。哈希表并不确定其中子变量的顺序，也就是说没有第一个变量，第二个变量
这样的说法，变量仅仅是通过名称来访问的。（就像 Java 语言中的 HashMap 一样，
是实现了 Hash 算法的 Map，不记录内部元素的顺序，仅仅通过名称来访问。译者
注）
 序列：每个子变量通过一个整数来标识。第一个子变量的标识符是 0 ，第二个是 1，
第三个是 2，这样来类推，而且子变量是有顺序的。这些数字通常被称为是子变量
的索引。序列通常比较密集，也就是所有的索引，包括最后一个子变量的，它们和
子变量都是相关联的，但不是绝对必要的。子变量的数值类型也并不需要完全一致。
 集: 从模板设计者角度来看，集是有限制的序列。不能获取集的大小，也不能通过
索引取出集中的子变量，但是它们仍然可以通过 list 指令来遍历。
要注意一个数值也可有多种类型，对于一个数值可能存在哈希表和序列这两种类型，这
时，该变量就支持索引和名称两种访问方式。不过容器基本是当作哈希表或者序列来使用的，
而不是两者同时使用。
尽管存储在哈希表，序列（集）中的变量可以是任意类型的，这些变量也可以是哈希表，
序列（集）。这样就可以构建任意深度的数据结构。

数据模型本身（最好说成是它的根）也是哈希表。

子程序

方法和函数
一个值是方法或函数的时候那么它就可以计算其他值，结果取决于传递给它的参数。
这部分是对程序员来说的：方法/函数是第一类值，就像函数化的编程语言。也就是说
函数/方法也可以是其他函数或方法的参数或者返回值，并可以把它们定义成变量。
假设程序员在数据模型中放置了一个方法变量 avg，那么它就可以被用来计算数字的
平均值。给定 3 和 5 作为参数，访问 avg 时就能得到结果 4。
方法的使用后续章节会有解释，下面这个示例会帮助我们理解方法的使用：

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  a python and an elephant is:
${avg(animals.python.price, animals.elephant.price)}

输出如下：

The average of 3 and 5 is: 4
The average of 6 and 10 and 20 is: 12
The average of the price of a python and an elephant is:
4999.5

那么方法和函数有什么区别呢？这是模板作者所关心的，它们没有关系，但也不是一点
关系都没有。方法是来自于数据模型（它们反射了 Java 对象的方法），就是Java等高级语言的反射机制在起作用，而函数是定义在模板
内的（使用了函数指令-这也是高级主题），但二者可以用同一种方式来使用。

用户自定义指令

用户自定义指令（换句话说，就是 FreeMarker 的标签）这种类型的值也是一种子程序，
一种可以复用的模板代码段。但这也是高级主题，我们在后续章节中会详细解释。
这部分是对程序员来说的：用户自定义指令（比如宏），也是第一类值，就像函数/方法
一样。
这里仅仅对用户自定义指令有一个认识即可（如果现在还不能理解可以先忽略它）。假
设现在有一个变量，box，它的值是用户自定义的指令，用来打印一些特定的 HTML 信息，
这个指令定义了一个标题和其中的信息。

函数/ 方法和用户自定义指令的比较
这部分内容也是对高级用户来说的（如果你还不能理解可以先忽略它）。如果要使用函
数/方法或自定义指令去实现一些东西的时候，二者之间的选择是两难的。按经验来说，
如果能够实现，请先用自定义指令而不要用函数/方法。指令的特征如下：
 输出（返回值）的是标记（HTML,XML 等）。主要原因是函数的返回结果可以自动
进行 XML 转义（这是因为${…}的特性），而用户自定义指令的输出则不是（这是

 副作用也是很重要的原因，它没有返回值。例如一个指令的目的是往服务器日志中
添加一个条目。（事实上你不能得到自定义指令的返回值，但有些反馈的类型是有
可能设置非本地变量的）
 会进行流程的控制（就像 list 或 if 指令那样），但是不能在函数/方法上这么做。
在模板中，FreeMarker 不知道的 Java 对象的方法通常是可以作为方法来使用的，而不
用考虑 Java 对象方法本身的特性，因为在这里没有其他的选择。

节点
节点变量代表了树状结构中的一个节点，而且通常是配合 XML 格式来处理的，这是专
业而且更高级的主题。
这里我们仅对高级用户进行一个概要说明：节点和存储在其他节点中的序列很相似，通
常也被当作为子节点。节点存储它所在的容器节点的引用，也就是父节点。节点的主要作用
是拓扑信息。其它数据必须通过使用多类型的值来存储。就像一个值可以同时是一个节点和
一个数字，这样它存储的数字可以作为如支付额来使用。除了拓扑信息，节点也可以存储一
些元信息（即 metadata，译者注）：如节点名称，它的类型（字符串），命名空间（作为字
符串）。若一个节点象征 XHTML 文档中的 h1 元素，那么它的名字可以是”h1”，类型可以
是”element”，命名空间可以是”https://www.w3.org/1999/xhtml”。但对于
数据模型设计者来说，这些元信息，还有如何来使用它们又有什么意义呢。检索拓扑信息和
元信息的方法将会在后续章节中来说明（这里你可以先不用理解它们）。

声明: 除非转自他站（如有侵权，请联系处理）外，本文采用 BY-NC-SA 协议进行授权 | 智乐兔
转载请注明：转自《0基础人群-freemaker模板技术中需要了解的数值和类型》
本文地址：https://www.zhiletu.com/archives-3002.html
关注公众号：