用Java程序生成文本的捷径

大多数程序都需要输出一些文本，比如邮件消息、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 ("\n");      message.append ("\n");      message.append ("您的帐户余额是 ");      message.append (customer.getAccountTotal());      message.append ("\n");      message.append ("\n");      message.append ("致礼！");      message.append ("\n");      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="致礼！\n某某装饰品公司";


假如说上述代码使得消息编辑更轻易，那么这种帮助也不会很多。很难要求一个不搞程序设计的人理解static和final的含义。此外，假如要改变消息的结构，上面这种代码也不够灵活。例如，人们可能要求你在邮件消息中加入更多来自数据源的信息，这时，你就得修改构造邮件的代码，或许还要添加更多的static final String对象。

模板简介
从文本文件装入消息文本可以解决部分问题——但不能提供动态内容，而这对于系统来说是很重要的。你需要有一种方法把动态内容插入到预先编写好的文本消息。但是，假如使用某种文本模板引擎，它就能够帮助你完成所有复杂的工作。

模板引擎解决了把动态内容插入文本消息的问题。使用模板引擎时，我们不再把消息直接嵌入程序，而是创建一个包含文本内容的简单文本文件，称为“文本模板”。模板引擎解析文本模板，借助一些简单的模板指令，把动态内容插入模板输出结果。

我选择的模板引擎是Jakarta Project的Velocity，但你可以任意选择其他许多模板引擎之一。Velocity和WebMacro或许是当前功能最丰富、最受欢迎的两个引擎，而且两者都按照源代码开放协议免费提供。虽然我在本文例子中使用Velocity，你可以方便地把这些例子移植到不同的模板引擎，只需遵照目标引擎的语法即可。
我们来看看用Velocity完成的email程序例子。要编译和运行修改后的程序，你必须下载Velocity并把它加入到classpath。假如要让email部分也能正常运行，你还需要JavaMail。
 for (int i=0; i<customers.size(); i++)  {      Customer customer = (Customer)customers.get(i);           // 创建一个环境，并加入所有的对象      VelocityContext context = new VelocityContext();      context.put ("CustName",customer.getCustName());      context.put ("total", new Double (customer.getAccountTotal()));      context.put ("customer", customer );           // 解析模板，生成结果字符串      StringWriter message = new StringWriter();      template.merge(context, message);           // 发送email      mm.sendMail (customer.getFirstName(), customer.getEmail(),          "Account", message.toString());  }


首先，你应该理解上面的Java源代码。这里我们不再象第一个例子那样生成文本，上面的代码引用一个称为“Velocity模板”的文本文件，然后把结果发送给收件人。Velocity模板可以是任何文本文件，但一般它包含一些用来插入动态内容的指令。

和VelocityContext相关的部分是上述代码中最值得注重的地方。VelocityContext提供了Java程序和Velocity文本模板之间的连接，而Velocity文本模板可以由其他人来编写。在模板中，所有加入到VelocityContext的对象都可以通过put()方法第一个参数指定的名字访问。为了解其工作过程，请看下面的模板文件：

尊敬的先生/女士： $CustName您的帐户余额是 $total致礼！某某装饰品公司


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) );