在此 JSP 文件中，要注意的第一点是它有一个 page 指令标记。这是因为它需要继承一个超类，并需要导入两个类。JSP 文件继承了超类 com.ibm.igs.ispkcm.translator.JspBase，因为 JspBase 包括一些很好的实用函数，它使得 JSP 文件可包含更少的代码。该 JSP 文件所用的主要实用函数是 displayErrors() 和 highLightErrors()。该 page 指令导入 LoanTranslator 和 Hashtable，因为 JSP 文件中引用了这两个类，导入这两个类是为了以后在此 JSP 代码中引用这两个类时不必使用它们完全限定的类名。以下代码显示了 import 语句的一个示例：

<%@ page extends="com.ibm.igs.ispkcm.translator.JspBase"
import="com.ibm.developerworks.translatorpattern.LoanTranslator,
Java.util.Hashtable"%>
 
    JSP 文件中第一行真正的 Java 代码获取 Translator 对象的一个实例，然后获取一个 Hashtable，其中存储着属于 Translator 对象的那个实例的错误。因为 JSP 文件（在编译后）是一个 servlet，所以它是一个无状态的服务对象。Translator 对象将在特定 JSP 文件或 servlet 的不同往返之间维护必要的状态信息。状态信息应仅限于网站访问者输入的值和要向网站访问者显示的任何处理错误。因为 Translator 对象的每个实例都与一个特定的网站访问者相关联，所以 JSP 文件调用 Translator 对象的 getInstance(HttpServletRequest) 方法。由于为该方法传递的是一个 HttpServletRequest 对象，所以该方法将能够检索与该网站访问者的 HttpSession 相关的 Translator 实例。

<%
LoanTranslator ltLoan = LoanTranslator.getInstance(request);
Hashtable htErrors = ltLoan.getErrors();
%>

    在此 JSP 文件示例中，网站访问者将在表单的顶部看到所有处理错误。用来显示这些错误消息的 HTML 是使用 <%= displayErrors(htErrors) %> 表达式输出的。displayErrors() 方法是从 JSP 文件的超类 JspBase 中继承而来的。有了 displayErrors()，用于显示错误消息的所有逻辑都被集中在一起，从而简化了维护工作。

    下面这段代码模板适用于表单上的每个输入域：

<%= hightLightErrors(ltLoan.BORROWER_LAST_NAME, htErrors) %>Borrower Last Name:
<INPUT name="<%= ltLoan.BORROWER_LAST_NAME %>"
value="<%= ltLoan.getBorrowerLastName() %>">
 
    highLightErrors() 是从 JSP 文件的超类 JspBase 中继承而来的。如果某个输入域有错误，该方法将突出显示该输入域的标签。该方法接收两个参数：String 和Hashtable。该 Hashtable 是其中存储着从 Translator 的实例检索而来的错误的 Translator。String 是正在检查其是否有错误的输入域的名称。如果存在与该域相关的错误，highLightErrors() 就会返回突出显示此输入域的标签的 HTML。

    在此代码模板中，须注意的重要一点是：INPUT 标记的 name 属性是由一个表达式设置的，该表达式使用 LoanTranslator 对象的 BORROWER_LAST_NAME 常量。因为在 JSP 文件中引用此域名时使用了一个常量，所以 Translator 对象和 servlet 的调试变得更加容易。使用常量更为容易，因为无论何时开发人员更改此域的名称，他们都会获得一个编译错误，而非运行时错误。查找编译错误要容易得多，因为编译器会立即指出错误，而运行时错误到调试和测试期间才能被发现。

    有关此代码模板的最后一个（也是最重要的一个）注意事项是：INPUT 标记的 value 属性是由一个表达式设置的，该表达式使用了 Translator 的一个 getter 方法。value="<%= tLoan.getBorrowerLastName() %> 这行代码是此模式最重要的部分之一，因为它就是使输入域的值缺省为网站访问者最初输入的值的代码。通过将此值缺省设置为网站访问者最初输入的值，访问者就能看到他最初输入的内容，并很容易地修正他的错误。这节省了网站访问者的时间，并能使其获得更好的用户体。

    servlet
    下面是一个典型的简化 servlet：

public void doPost(HttpServletRequest request, HttpServletResponse response)
  {
     // 缺省设置是使用户返回输入页。
  String sRedirect = LOAN_JSP;
    // 获取 Translator 的正确实例
  LoanTranslator ltTrans = LoanTranslator.getInstance(request);
    // 现在有了 Translator 的一个实例
  ltTrans.processForm(request);
    // 获取 Loan 的正确版本的逻辑
  Loan lnTheLoan = null;
  if (ltTrans.isNew () == true)
  {
    // 创建新 Loan
  }
  else
  {
    // 获得现有的 loan
  }
    // Sync the Loan object values to values in the submitted form.
  ltTrans.syncModelToGui(lnTheLoan);
    // 确保未出现任何错误
  if (ltTrans.hasErrors() == false)
  {
    // 提交 Loan 信息，然后将重定向设置为正确的尾随页
  sRedirect = LOAN_CONFIRMATION;
  }
    // 将网站访问者重定向为当前工资。
  try {
  response.sendRedirect(sRedirect);
  }
  catch (Exception e)
  {
    // 错误逻辑
  }
  }

    在 servlet 拥有业务对象的一个实例之后，servlet 就会调用 Translator 对象的 syncModelToGui()。syncModelToGui() 随后将网站访问者提交的全部值转换为业务对象可识别的值。在 Translator 完成值的同步之后，servlet 将检查当试图转换网站访问者输入的值时，Translator 是否记录了任何错误。如果没有记录任何错误，servlet 就会将网站访问者重定向到确认页（通常是另一个 JSP 文件，它同样能显示来自 Translator 的值）。如果记录了错误，servlet 就将网站访问者重定向到输入表单，这样他就可以修正错误。

    Translator 对象
    因为 Translator 对象是 JSP 文件、servlet 和业务对象之间的联系纽带，所以要求它是有状态的，并且要求它在 HTTP 请求（或线程）之间维护状态。为了符合这个标准，Translator 对象需要起到类似伪孤子 (pseudo singleton) 那样的作用。Translator 类有五个主要部分，另外还有一个前面未曾提及的 Object Translator 类库。
 
    getInstance()
    syncGuiToModel()
    若干 getter 方法
    processForm()
    syncModelToGui()
    Object Translators 库
    为了调用 Translator 对象的一个实例，调用程序必须调用静态方法 getInstance(HttpServletRequest)。getInstance() 方法将确定是否应返回 Translator 的一个新实例，或者是否应从 HttpSession 中重用某个实例。该方法通过查看定制参数 action 来实现这一点。此参数是随 HTTP 请求（例如，http://localhost/registerLoan.jsp?action=new）一起传递的。下面的样例代码段显示了
    getInstance() 的内容：
public static LoanRegistrationTranslator getInstance(HttpServletRequest request)
  {
    // 声明返回值变量。
  LoanRegistrationTranslator lrtRV = null;
    // HttpSession 是必需的，因此在此处将它提取出来。
  HttpSession session = request.getSession();
    // 从 request 对象中检索 action 参数。
  String sAction = parseString(request, ACTION);
    // 确定我们要返回哪种 Translator。
  if (ACTION_PROCESS.equals(sAction) == true)
  {
    // 因为 action 参数被设置为 process，这表示我们正在处理一个现有的
    // Translator，所以从 HttpSession 中将这个 translator 提取出来。
    lrtRV = (LoanRegistrationTranslator)
  session.getValue(HttpSessionValueKeys.LOAN_REGISTRATION_TRANSLATOR);
  }
  else if (sAction == null || "".equals(sAction) == true ||
  ACTION_NEW.equals(sAction) == true)
  {
    // 由于未设置或根本未传递 action，所以缺省操作是创建一个新的 translator。
    // 另一种可能是 action 为 "new"
  lrtRV = new LoanRegistrationTranslator();
  session.putValue(HttpSessionValueKeys.LOAN_REGISTRATION_TRANSLATOR, lrtRV);
  }
  else
  {
    // 由于 action 不满足前面的任何检查，即 action 值是位于辅助存储器中的
    // 一个现有 Loan 的 ID，所以这次创建一个 LoanRegistrationTranslator，
    // 其值被预设为已保存的 loan 中的值。
  lrtRV = new LoanRegistrationTranslator(sAction);
  session.putValue(HttpSessionValueKeys.LOAN_REGISTRATION_TRANSLATOR, lrtRV);
  }
    // 返回 Translator 对象的一个实例。
  return lrtRV;
  }
    对于要在 JSP 文件中显示的每个业务对象值，Translator 都提供了一个 getter 方法。这些 getter 方法由 JSP 文件调用。必须在 JSP 文件中显示的每个业务对象属性都有一个 getter 方法。getter 方法总是返回一个 String。返回的 String 值已被预先格式化，以便直接在 JSP 文件中显示。预先格式化 String 是为了使 JSP 文件中的 Java 代码尽可能少。对这些值的格式化改为在syncGuiToModel() 中进行。

DoubleTranslator dtDouble = new DoubleTranslator();
String sTemp = dtDouble.translate(loan.getInterestRate());
setInterestRate(sTemp);
   为了使转换代码具有最大的可重用性，并为整个站点提供一种共同的转换，syncGuiToModel() 和 syncModelToGui() 使用的都是 Object Translator 类。Object Translators 与 Translator 对象联系得如此紧密，以致于几乎可将它们看作是 Translator 对象的规则。Object Translator 类是一个简单的类，它的唯一用途就是将一种数据类型转换为格式化字符串，以及将格式化字符串转换为它的数据类型。

    下面是一个很简单的 Object Translator 类的代码：

public class DoubleTranslator extends ObjectTranslator
　{
　　public String translate(double doubleValue)
　　　{
　　　return Double.toString(doubleValue);
　　　}
　　public double translate(String stringToBeTranslated) throws Exception
　　{
　　　double dRV = 0.0;
　　　try {
　　　　　Double dbDouble = Double.valueOf(stringToBeTranslated);
　　　　　dRV = dbDouble.doubleValue();
　　　　　}
　　　catch(Exception e)
　　　　{
　　　　　Exception eTranslation =
　　　　　new Exception("Please enter a numeric value like 1.0 or 1.25");
　　　　　throw eTranslation;
　　　　}
　　　return dRV;
　　}
　}
　　当这个样例 Object Translator 将 double 转换为格式化的 String 时，它只需调用 Double.toString()。这个方法可实现更强大的功能，例如，可以添加几行代码，使得当格式化类似 。1000.25 这样的大 double 值时，可预格式化这个值，以便显示为 1,000.25。对于 DoubleTranslator.translate(String)，须注意的重要一点是，它会发出一个可读性很好的异常，而不是标准的 Java.lang.NumberFormatException 异常。JSP 文件将此异常的消息直接显示给网站访问者，因此，让网站的普通访问者很容易地理解该方法发出的异常是非常重要的。

　　小结
　　使用 Translator 模式框架的优点很多，不仅可以降低网站的成本，而且可以提高用户的满意度。由于不同组件都只执行专门的任务，因而网站的构建成本降低了。这些专门任务分配给生产小组，如 HTML 小组或 Java 程序员小组。因为 Translator 模式的 ObjectTranslators 在整个网站重用，所有全部格式化和分析都是以相同的方式进行的。因为每项任务都以相同的方式完成，所以网站访问者就能够以一致的方式查看整个网站的信息。这进一步提高了用户的满意度。