用Java程序生成文本的捷径(二)

<script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> </script> Velocity引擎读取模板文件时，它直接输出文件中所有的文本，但以$字符开头的除外。$符号标识着一个位置，在模板的输出结果中，对象的值应该插入到$符号所指示的位置。例如，Java代码中有一个context.put ("CustName",customer.getCustName())语句，当Velocity模板引擎解析并输出模板的结果时，模板中所有出现$CustName的地方都将插入客户的名字；即，被加入到VelocityContext的对象的toString()方法返回值将替代Velocity变量（模板中以$开头的变量）。 模板引擎中最强大、使用最频繁的功能之一是它通过内建的映像（Reflection）引擎查找对象信息的能力。这个映像引擎允许用一种方便的Java“.”类似的操作符，提取任意加入到VelocityContext的对象的任何公用方法的值，或对象的任意数据成员。映像引擎还带来了另外一个改进：快速引用JavaBean的属性。使用JavaBean属性的时候，我们可以忽略get方法和括号（欲知详细信息，请参考模板引擎的说明文档）。请看下面这个模板的例子。由于在前面的Java代码示例中，我把Customer对象加入到了VelocityContext，所以我可以把模板改写成下面这种形式： 尊敬的先生/女士： $customer.CustName您的帐户余额是 $customer.AccountTotal致礼！某某装饰品公司 除了替换变量之外，象Velocity和WebMacro这类高级引擎还能做其他许多事情。它们有用来比较和迭代的内建指令（尽管比较和迭代功能是两个模板引擎之间的共同点，但它们的语法差异很大，不能完全兼容。在选择模板引擎或者更换模板引擎时，务必注意这一点）。 举一个例子。十二月份，你的老板想要向所有的客户发一个圣诞节问候的email。你可以把这个消息加入到模板，以后再删除它。但这样的话，你得在新年那一天上班工作，以便删除圣诞问候消息。 一种更好的办法是指示模板何时显示圣诞问候消息。为此，你首先要把当前的月份加入到VelocityContext： int month = (new GregorianCalendar()).get(Calendar.MONTH); // 把month值加1，因为它从0开始计算 context.put ("month", new Integer(month 1) ); 现在，你只需在模板中进行比较： 尊敬的先生/女士： $customer.CustName您的帐户余额是 $customer.AccountTotal致礼！某某装饰品公司#if ($month == 12)祝您和您的家人圣诞节快乐！#end #if指令的作用很清楚：对一个逻辑表达式进行测试，从而决定是否在模板输出结果中包含该指令块内的内容。除了简单的等于比较之外，你还可以执行更复杂的比较，但这方面的功能都与特定的模板引擎密切关联，所以这里我不再介绍。 迭代指令和#if指令一样简单。模板引擎支持迭代Java Collections Framework的任意实现，包括Array、List和Iterator。对于JDK 1.2或者更高版本，Java的Vector和ArrayList都实现了List接口，因此它们也适合在模板引擎的迭代指令中使用。 假设我们现在不想输出帐户余额，而是想通过迭代遍历帐户的交易记录，输出详细的报表。Customer对象的getTransactions()方法（参见下载包中完整的示例代码）返回一个List对象，List对象包含零个或者多个Transaction对象。由于List属于Java Collections Framework的一部分，我们可以用#foreach指令迭代其内容。我们不用担心如何定型对象的类型——映像引擎会为我们完成这个任务。从下面这个例子中，我们可以看出迭代的工作过程： 尊敬的先生/女士： $customer.CustName#foreach ($transaction in $customer.Transactions)$transaction.Description $transaction.Amount#end您的帐户余额是 $customer.AccountTotal致礼！某某装饰品公司 #foreach指令的一般格式是“#foreach in ”。#foreach指令迭代list，把list中的每个元素放入item参数，然后解析#foreach块内的内容。对于list内的每个元素，#foreach块的内容都会重复解析一次。从效果上看，它相当于告诉模板引擎说：“把list中的每一个元素依次放入item变量，每次放入一个元素，输出一次#foreach块的内容”。 MVC设计模型 在看下一个例子之前，请回顾一下前面我们所讨论的内容。使用模板引擎最大的好处在于，它分离了代码（或程序逻辑）和表现（输出）。由于这种分离，你可以修改程序逻辑而不必担心邮件消息本身；类似地，你（或公关部门的职员）可以在不重新编译程序的情况下，重新编写邮件消息。 实际上，我们分离了系统的数据模式（Data Model，即提供数据的类）、控制器（Controller，即邮件程序）以及视图（View，即模板）。这种三层体系称为Model-View-Controller模型（MVC）。如果遵从MVC模型，代码分成三个截然不同的层，简化了软件开发过程中所有相关人员的工作（MVC的出现已经有一段时间，参见本文最后的“参考资源”了解更多信息）。 结合模板引擎使用的数据模式可以是任何Java对象，最好是使用Java Collection Framework的对象。控制器只要了解模板的环境（如VelocityContext），一般这种环境都很容易使用。一些关系数据库的“对象-关系”映射工具能够和模板引擎很好地协同，简化JDBC操作；对于EJB，情形也类似。 模板引擎与MVC中视图这一部分的关系更为密切。模板语言的功能很丰富、强大，足以处理所有必需的视图功能，同时它往往很简单，不熟悉编程的人也可以使用它。模板语言不仅使得设计者从过于复杂的编程环境中解脱出来，而且它保护了系统，避免了有意或无意带来危险的代码。例如，模板的编写者不可能编写出导致无限循环的代码，或侵占大量内存的代码。不要轻估这些安全机制的价值；大多数模板编写者不懂得编程，从长远来看，避免他们接触复杂的编程环境相当于节省了你自己的时间。 许多模板引擎的用户相信，在采用模板引擎的方案中，控制器部分和视图部分的明确分离，再加上模板引擎固有的安全机制，使得模板引擎足以成为其他内容发布系统（比如JSP）的替代方案。因此，Java模板引擎最常见的用途是替代JSP也就不足为奇了。 HTML处理 由于人们总是看重模板引擎用来替换JSP的作用，有时他们会忘记模板还有更广泛的用途。到目前为止，模板引擎最常见的用途是处理HTML Web内容。但我还用模板引擎生成过SQL、email、XML甚至Java源代码。在这里我只能涉及模板的部分应用，但你可以从本文最后的参考资源找到更多的例子。 用Java程序生成文本的捷径(一) 用Java程序生成文本的捷径(二) 用Java程序生成文本的捷径(三)