用Java程序生成文本的捷径(转)[@more@]大多数程序都需要输出一些文本，比如邮件消息、HTML文件或控制台输出。但是，计算机本质上只能处理二进制数据，程序员必须让软件来生成可理解的文本。在这篇文章中，我要介绍的是在生成和输出文本时，为何使用模板引擎能够节省时间。你将了解模板的优点，如何针对不同的情形创建高效的模板。和 System.println说再见！ 虽然程序员可以很轻松地编写出输出文字信息的代码（因为这毕竟是从Hello World范例学到的第一件事情），但通常而言，程序员不是写作或组织文字信息（如邮件）的最佳人选。因此，我们常常让市场部门或公关部门去做那些事情。但遗憾的是，即使对于最普通的邮件，编写者也常常依赖程序输出来完成任务。无论是对于邮件编写者还是程序员，这种合作方式都很容易带来误解和造成失误。 请看一个例子：一个Java程序从某个数据源收集一些客户信息，通过email给公司的每一个客户发送帐户余额信息。下面是完成这个任务的Java程序（完整的示例程序代码可以从本文最后下载）： for (int i=0; i { Customer customer = (Customer)customers.get(i); StringBuffer message = new StringBuffer(); message.append ("尊敬的先生/女士： "); message.append (customer.getCustName()); message.append ("
"); message.append ("
"); message.append ("您的帐户余额是 "); message.append (customer.getAccountTotal()); message.append ("
"); message.append ("
"); message.append ("致礼！"); message.append ("
"); message.append ("某某装饰品公司"); // 发送email mm.sendMail (customer.getFirstName(), customer.getEmail(), "Account", message.toString()); } 上面的例子可谓发送消息最差劲的方法之一。由于消息嵌入到了程序代码之中，如果没有程序员的帮助，其他人几乎不可能对消息进行编辑。同时，即使对于专业的程序员，如果他不了解代码，要进行编辑也很困难。如果你预见了这些麻烦，把代码写成下面这种形式： static public final String STR_HELLO="尊敬的先生/女士： "; static public final String STR_MESSAGE="您的帐户余额是 "; static public final String STR_BEY="致礼！
某某装饰品公司"; 如果说上述代码使得消息编辑更容易，那么这种帮助也不会很多。很难要求一个不搞程序设计的人理解static和final的含义。此外，如果要改变消息的结构，上面这种代码也不够灵活。例如，人们可能要求你在邮件消息中加入更多来自数据源的信息，这时，你就得修改构造邮件的代码，或许还要添加更多的static final String对象。 模板简介从文本文件装入消息文本可以解决部分问题??但不能提供动态内容，而这对于系统来说是很重要的。你需要有一种方法把动态内容插入到预先编写好的文本消息。但是，如果使用某种文本模板引擎，它就能够帮助你完成所有复杂的工作。 模板引擎解决了把动态内容插入文本消息的问题。使用模板引擎时，我们不再把消息直接嵌入程序，而是创建一个包含文本内容的简单文本文件，称为“文本模板”。模板引擎解析文本模板，借助一些简单的模板指令，把动态内容插入模板输出结果。 我选择的模板引擎是Jakarta Project的Velocity，但你可以任意选择其他许多模板引擎之一。Velocity和WebMacro或许是当前功能最丰富、最受欢迎的两个引擎，而且两者都按照源代码开放协议免费提供。虽然我在本文例子中使用Velocity，你可以方便地把这些例子移植到不同的模板引擎，只需遵照目标引擎的语法即可。我们来看看用Velocity完成的email程序例子。要编译和运行修改后的程序，你必须下载Velocity并把它加入到classpath。如果要让email部分也能正常运行，你还需要JavaMail。 for (int i=0; i
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源代码。在这里我只能涉及模板的部分应用，但你可以从本文最后的参考资源找到更多的例子。 我将在下面的HTML例子中使用前面email例子的数据模式。这个HTML页面是一个假想的企业Intranet页面，它显示出客户帐户的详细信息。本例中的控制器类是一个Java Servlet，视图部分则包含一个HTML模板。下面的代码显示了Servlet类中最主要的代码。为使这个例子更具有代表性，我从头开始手工编写这个 Servlet。然而，一般情况下，模板会提供一些Servlet工具，帮助用户减轻一些编写代码的负担。 // 装入模板 Template template = Velocity.getTemplate("html.vm"); // 创建环境 VelocityContext context = new VelocityContext(); context.put ("customers",Customer.getCustomers());// 解析模板，输出应答ServletOutputStream output = response.getOutputStream();Writer writer = new OutputStreamWriter (output);template.merge(context, writer);writer.flush(); 这个例子也没有什么令人惊异的地方。和前面的例子一样，我只是把必需的对象加入到VelocityContext，然后输出解析模板的结果。但是请注意，在前面的例子中，我只把一个Customer加入到VelocityContext，这里加入到VelocityContext的却是一组 Customer对象。我可以用#foreach指令迭代访问所有的Customer对象。下面是相应的HTML模板：
客户报告
#foreach ($customer in $customers)
$customer.CustName
重庆分公司
重庆分公司
