Enter your email ”。在资源属性文件中，可以使用 代码。ActionErrors 中 add(java.lang.String property, ActionError error) 方法的参数property 是一个表单属性名。这个 ActionError 只能与一个指定的表单属性相关。例如，如果 email 地址为空，或者只包含空格字符，那么在对表单进行验证时就会显示“Enteryour email”消息。如果在 email 地址中没有“@”字符，那么就会显示“Correct your email”消息，这是在资源属性文件中使用“error.wrongEmail”关键字定义的。这两个错误都只与表单属性“email”有关（参见 清单1）。我们稍后再回来介绍。
package com.asprise.struts.form;
import javax.servlet.http.HttpServletRequest;
import org.apache.struts.action.ActionErrors;
import org.apache.struts.action.ActionError;
import org.apache.struts.action.ActionForm;
import org.apache.struts.action.ActionMapping;
public class OwnerForm extends ActionForm {
private String email;
private String greet = "Mr.";
private String address;
private int tel = 0;
private String name;
public ActionErrors validate(
ActionMapping mapping,
HttpServletRequest request) {
ActionErrors errors = new ActionErrors();
if (greet == null || greet.trim().equals("")) {
errors.add("greet", new ActionError("error.greet"));
}
if (name == null || name.trim().equals("")) {
errors.add("name", new ActionError("error.name"));
}
if (address == null || address.trim().equals("")) {
errors.add("address", new ActionError("error.address"));
}
if (email == null || email.trim().equals("")) {
errors.add("email", new ActionError("error.noEmail"));
}
else if (email.indexOf("@")==-1) {
errors.add("email", new ActionError("error.wrongEmail"));
}
if (tel==0) {
errors.add("tel", new ActionError("error.tel"));
}
return errors;
}
...
public String getEmail() {
return email;
}
public void setEmail(String email) {
this.email = email;
}
...
}
|
在资源属性文件中可以使用 代码。资源属性文件的内容是一些键-值对（参见 清单2）。在源代码文件中可以调用这些关键字。在每个资源属性文件中系统都需要 errors.header 和 errors.footer这两个关键字。
errors.header=Validation Error(s)
error.greet=Choose your greet
error.name=Enter your name
error.address=Enter your address
error.tel=Enter your contact number
error.wrongEmail=Correct your email
error.noEmail=Enter your email
|
修改 Action 类
OwnerAction 类会在局部转发路径“success”中简单地显示一条诸如“Thank you, Miss Nancy Chen”之类的消息。请修改OwenerAction 类的 execute() 方法来实现您的逻辑，（每个 action 类都必须实现 execute() 方法）。参见 清单3，它会将控制流程转向 success.jsp。
public class OwnerAction extends Action {
public ActionForward execute(
ActionMapping mapping,
ActionForm form,
HttpServletRequest request,
HttpServletResponse response)
throws Exception {
OwnerForm ownerForm = (OwnerForm) form;
String greet = ownerForm.getGreet();
String name = ownerForm.getName();
request.setAttribute("name", name);
request.setAttribute("greet", greet);
// Forward control to the specified success target
return (mapping.findForward("success"));
}
}
|
修改 JSP 文件
首先，为 添加 ，完成表单（参见 清单4）。然后在表单后面添加一个 ，这用来演示一个与属性为“proerty”的 不同的行为。例如， 只会反映与表单属性“name”相关的用户输入的验证。可以使用ActionErrors 类的 add(String property, ActionError error) 方法为一个表单属性关联一些错误。 则会反映这个表单中所有的验证错误。这些错误会在调用 的地方显示。
<%@ taglib uri="/WEB-INF/struts-bean.tld" prefix="bean"%>
<%@ taglib uri="/WEB-INF/struts-html.tld" prefix="html"%>
Struts Form for ownerForm
greet :
Mr.
Miss
Mrs.
name :
address :
email :
tel :
|
现在，代码 success.jsp 会显示一条诸如“Thank you, Miss Nancy Chen”之类的消息。其中“Miss”是所有者的问候，而“NancyChen”是所有者的名字。最终的文件如 清单5所示。
<%@ taglib uri="/WEB-INF/struts-bean.tld" prefix="bean"%>
<%@ taglib uri="/WEB-INF/struts-logic.tld" prefix="logic" %>
Thank you,
|
是一个 Struts logic 标签。当逻辑标签具有属性“name”时，就应该检查是否存在这个指定名的JSP bean。关于 的属性完整列表和 Struts logic 标签的完整列表，请参阅
是一个 Struts bean 标签。它被用来将指定的 bean 属性的值传递给当前的 JspWriter。当bean 标签具有属性“name”和属性“property”时，就是指其属性被访问以获取由“property”所指定的值的 bean 的属性名。如果没有指定“property”属性，那么就会传递这个 bean 本身的值。关于 属性以及 Strutslogic 标签的完整列表，请参阅 。
检查 struts-config.xml
当您在 Eclipse 环境中单击“struts-config.xml”时，就会在一个图形用户界面中显示 struts-config.xml，如 图15所示。这样可以允许开发人员方便地编辑大部分 Easy Struts 功能。也可以通过单击“source”选项卡来查看 struts-config.xml的源代码。
测试应用程序
单击 Tomcat 工具栏按钮，重新启动 Tomcat 服务器。然后在 URL 地址栏中输入“”。现在屏幕上就会显示 图16。验证结果如 图17所示。注意有无属性“property”时 的不同行为。如果有“property”属性，系统只会返回与该属性有关的错误。如果没有属性“property”，那么系统就会返回该表单中的所有错误。当所有的输入都正确无误时，系统会将控制流程转到 success.jsp 上，这样会显示一条消息：“Thankyou, Miss Nancy Chen”（参见 图18）。
Struts 的配置提供了两种 ActionForwards，分别是全局转发和局部转发。全局的 ActionForwards 对于整个应用程序中的任何Action 对象都是可见的。局部 ActionForwards 只对哪些在从 ActionMapping 中调用的 Action 对象可用，这些对象就是局部ActionForwards 所关联的对象。从上一节中，您已经看到了如何在“Easy Action associated with a form”的过程中创建一个局部转发。在本节中，您将学习如何使用“EasyForward”创建局部转发或全局转发。
进入 Easy Struts 功能视图，并单击“Easy Forward”。这样做的结果是应该可以看到类似于如 图19所示的内容。如果您保留“Visibility”为空不变，那么最终的转发就是全局的。如果单击“Browse”按钮并选择“/owner”，如 图20所示，那么最终的转发就是局部转发。不管转发是全局的还是局部的，在 Action 类中都以 mapping.findForward("failure")的形式引用。
在“Easy Action associated with a form”一节中，我们已经讨论了“name”、“Redirect”和“Context relative”属性，如 图 19所示。
在上一节中，我们体验了 Easy Struts 的 3 个功能。在本节，您将编写自己的 XSLT 文件代码，以统一定制 JSP 文件的风格，并使用其他功能对内容进行国际化/本地化、连接到数据源、处理自定义异常、对应用程序进行模块化和创建自定义插件。
可以通过编写 .xsl 文件并配置 Easy Struts 的参数来按照需要的格式生成 JSP 文件。要进行参数配置，进入“Window”菜单中，选择“Preferences”项，选择“EasyStruts”选项，并单击“XSLT stylesheet”选项卡，为“Jsp file stylesheet”单击“Browse”，添加自己的.xsl 文件。
例如，如 清单6所示的代码是我们的 .xsl 文件。对于每个表单属性来说，它都生成“property”和“value”属性。例如，如果将一个名为“name”的文本输入区初值设置为“nancy”，那么在JSP 文件中生成的代码行就是 name: 。
对内容进行本地化
可以通过创建本地化的资源属性文件对应用程序进行本地化。要创建一个新的资源属性文件，进入 Easy Struts 功能视图，选择“Easy MessageResource”。按照如 图21所示进行配置，这样将创建一个中文消息资源。注意资源属性文件名必须是 ApplicationResources_xx_XX.properties。小写的xx 表示本地语言，它是一个 ISO-639 语言编代码，为两个字母；大写的 XX 表示本地国家，它是一个 ISO-3166 国家代码，为两个字母。
注意：关于 ISO-639 语言代码的完整列表，请访问 Unicode.org 上的 。关于 ISO-3166 国家代码的完整列表，请访问 Unicode.org 上的 。
![]() |
- 如果 null 属性设置为 true，会引起空字符串返回，造成未知的消息关键字。
- 当消息资源绑定时，这个参数被交给出工厂。“parameter”的值是基于 property-file 工厂的属性文件的路径。
- 这个关键字属性定义了ServletContext 属性关键字，这一消息资源绑定到它上面。
| |
资源属性文件很容易编辑。您可以使用记事本来编辑中文资源属性文件。ApplicationResources_zh_CN.properties应该被保存为 Unicode (UTF-8) 编码。然后，将本地语言设置为 Chinese，将位置设置为 China （在 Windows上，可以使用控制面板中的区域和语言选项进行设置）。重新启动 Tomcat 以启用修改过的设置，并转到 上。现在验证错误就是用中文显示的了，如 图22所示。
连接到数据库
在本节中，您将把 Web 应用程序连接到一个 MySQL 数据库上。要实现这种功能，进入 Easy Struts 功能视图，选择“EasyDatasource”，并按照 图23所示的一样进行配置。注意应该将 JDBC driver 放到 eclipse_home\eclipse\workspace\easyStruts\WEB-INF\lib 目录中。
接下来，启动 MySQL 服务器，并按照如 清单 7所示的方式创建数据库“crm”和表“owner”。
# Database : 'crm'
# Table structure for table 'owner'
#
CREATE TABLE 'owner' (
'id' int(6) NOT NULL default '0',
'greet' varchar(5) NOT NULL default '',
'name' varchar(50) NOT NULL default '',
'email' varchar(50) NOT NULL default '',
'address' varchar(100) NOT NULL default '',
'tel' int(10) NOT NULL default '0',
PRIMARY KEY ('id')
) TYPE=MyISAM;
|
接下来，修改 OwnerAction 类中的 execute() 方法，使其连接到数据库上（参见 清单8）。如您所见，Easy Datasource 就是在这里使用这些 key 属性。“org.apache.struts.action.DATA_SOURCE”是数据源使用的关键字。注意我们捕获了SQLException 异常并将其重新抛出。在下一节中，您将对异常处理程序进行编码，以便处理 SQLException 异常。
public ActionForward execute(
ActionMapping mapping,
ActionForm form,
HttpServletRequest request,
HttpServletResponse response)
throws Exception {
OwnerForm ownerForm = (OwnerForm) form;
String greet = ownerForm.getGreet();
String name = ownerForm.getName();
request.setAttribute("name", name);
request.setAttribute("greet", greet);
String address = ownerForm.getAddress();
String email = ownerForm.getEmail();
int tel = ownerForm.getTel();
Connection conn = null;
Statement stmt = null;
ResultSet rs = null;
DataSource dataSource = (DataSource)servlet.getServletContext().getAttribute(
"org.apache.struts.action.DATA_SOURCE");
try {
conn = dataSource.getConnection();
stmt = conn.createStatement();
int id = 0;
rs = stmt.executeQuery("select max(id) as counter from owner");
while(rs.next()){
id = rs.getInt("counter");
}
id += 1;
stmt.executeUpdate("insert into owner values(
"+id+", '"+greet+"', '"+name+"', '"+email+"', '"+address+"', "+tel+")");
rs.close();
stmt.close();
conn.close();
}
catch(SQLException e){
throw new SQLException("database error");
}
// Forward control to the specified success target
return (mapping.findForward("success"));
}
|
您应该重新启动 Tomcat 服务器，让其在启动时就连接到数据源上，并转到 页面上。如果所有的输入都正确，那么就会向“owner”表中插入一条记录，并将控制转到 success.jsp 页面。您可以对数据库进行检查，确认是否在表“owner”中新插入了一条记录。
处理异常
正如上一节中提到的一样，您可以编写自己的异常处理程序来处理 SQLException 异常。首先，进入 Easy Struts 功能视图，选择Easy Exception 对异常进行声明。使用如 图24所示的配置。资源包名中存放了这个异常的消息资源，这是在 bundle 属性中指定的。这个异常属性指明了当发生这个异常时被调用来处理这个异常的类。这个关键字是在消息资源包中定义的。当异常发生时，控制流程就被重定向到在path 属性中给定的文件上。scope 属性告诉 Struts ActionErrors（在处理异常时被创建）应该被保存多长时间（会话或请求）。type属性指定了这个异常处理程序会截获的异常类型。
单击“Finish”之后，异常就被声明了。然后就应该编写 MyExceptionHandler.java 的代码（参见 清单9）。它对 ExceptionHandler 类进行了扩展，与 Action 类很类似，同时还实现了 execute() 方法，并返回一个ActionForward 对象。正如您所见，Easy Exception 的“path” 属性可以使用 ExceptionConfig 类的getPath() 方法获得。您可以使用 ExceptionConfig 类的 getKey() 方法获得这个 key 属性。
package com.asprise.struts.exception;
import javax.servlet.*;
import javax.servlet.http.*;
import org.apache.struts.action.*;
import org.apache.struts.config.*;
public class MyExceptionHandler extends ExceptionHandler {
public ActionForward execute(
Exception ex,
ExceptionConfig ae,
ActionMapping mapping,
ActionForm formInstance,
HttpServletRequest request,
HttpServletResponse response)
throws ServletException {
request.setAttribute("myException",ex);
request.setAttribute("myForm",formInstance);
request.setAttribute("myKey",ae.getKey());
return new ActionForward(ae.getPath());
}
}
|
在异常声明中，如果发生一个 SQLException 异常，那么控制流程就会被重定向到 exception.jsp 文件。我们的 exception.jsp会显示默认的资源属性文件中关键字为“error.database”的消息，以及异常被抛出时的异常类型和异常消息。您可以在 MyExceptionHandler中获取这个异常关键字。您也可以将这个关键字提供给 标签使用，如 清单10所示。
<%@ page import="java.sql.SQLException" %>
<%@ page import="com.asprise.struts.form.*" %>
<%@ taglib uri="/WEB-INF/struts-bean.tld" prefix="bean"%>
<%
OwnerForm myForm = (OwnerForm)request.getAttribute("myForm");
if (myForm != null) {
out.println("Sorry, "+myForm.getGreet());
out.println(" "+myForm.getName()+"");
}
%>
<%
Object obj = request.getAttribute("myException");
if (obj != null) {
Throwable ex = (Throwable)obj;
out.println("Type:"+ex.toString());
out.println("Message:"+ex.getMessage());
}
%>
|
定义“error.database=
An Exception Handled by MyExceptionHandler:
”。当发生一个SQLException 异常时，您应该会看到类似于 图25所示的内容。
对应用程序进行模块化
在本节中，我们将创建一个名为“newModule”的新模块。要实现这个功能，进入 Easy Struts 功能视图，选择“Easy Module”，并在Module name 中输入“newModule”，如 图26所示。
重新启动 Eclipse，以启用新的模块。如果在启动 Web 应用程序时出现这样一个错误： org.xml.sax.SAXParseException:The content of element type "servlet" must match "(icon?,servlet-name,display-name?,description?,(servlet-class|jsp-file),init-param*,load-on-startup?,run-as?,security-role-ref*)" ，通过将新的模块配置部分直接移动到web.xml 中的一个默认模块下面，您可以来解决这个问题。
有两种方法可以切换到新模块上。首先，您可以在 struts-config.xml 中创建一个新的全局或局部转发“success”（参见 清单11）。然后可以使用 mapping.findForward("success") 切换到这个新模块上来。
其次，创建一个如下所示的操作，其类型是一个 SwitchAction 操作：
然后在 struts-config-newModule.xml 中创建如 清单 12所示的操作映射。
接下来，编写 easyStruts/newModule/index.jsp 的代码。index.jsp 只会显示一条消息“
Youare in module: newModule
”。
现在，启动 Tomcat 服务器，并输入 。结果如 图 27所示。如果您想切换回默认的模块，只需输入 即可。
注意：您可以在除“Add Easy Struts support”之外的所有 Easy Struts 功能中指定模块名。
在本节中，您将学习 Easy Struts 的最后一个功能 -- Easy Plug-in。 Plug-in Action 的一个常见用法是在Web 应用程序在启动时，配置或装载特定应用程序的数据。自定义插件实现了 Plug-in 接口。这个接口的实现需要一个零参数的构造函数，供ActionServlet 使用，从而确保插件可以正确创建。接口中定义的两个方法分别是 init() 和 destroy()，这两个方法分别在启动和关闭应用程序时被调用。您必须实现这两个方法。
要创建一个插件，进入 Easy Struts 功能视图，选择 Easy Plugin，在 Plugin class 中输入内容，并为添加一些属性。我们要添加proxy 和 port 属性，如 图28所示。
接下来，编写 MyPlugin 类的代码，如 清单13所示。这段代码实现了 Plugin 类。当启动 Web 应用程序时，会显示一条消息说“MyPlugin starting”，并设置系统的proxy 和 port 属性。当关闭应用程序时，就会显示一条“MyPlugin Stopping”消息。
package com.asprise.struts.plugin;
import org.apache.struts.action.PlugIn;
import org.apache.struts.config.ModuleConfig;
import org.apache.struts.action.ActionServlet;
public class MyPlugin implements PlugIn{
public String proxy;
public String port;
public MyPlugin(){
}
public void init(ActionServlet servlet, ModuleConfig config){
System.err.print("********* MyPlugin Starting *******");
System.setProperty("https.proxyHost", getProxy());
System.setProperty("https.proxyPort", getPort());
servlet.getServletContext().setAttribute("proxy", getProxy());
servlet.getServletContext().setAttribute("port", getPort());
}
public void destroy(){
System.err.print("********* MyPlugin Stopping *******");
}
public void setProxy(String prox){
proxy = prox;
}
public String getProxy(){
return this.proxy;
}
public void setPort(String por){
port = por;
}
public String getPort(){
return this.port;
}
}
|
在这个 JSP 或其他 Java 文件的源代码中，可以使用 getServletContext().getAttribute("proxy")来获取 proxy 的值。
要将 Struts 应用程序部署到客户端上，可以简单地将应用程序导出为一个 WAR 文件，并将其分发到您的客户端上，让它们把这个 WAR 文件放到自己Web 服务器的“webapps” 目录中即可。下面是将应用程序导出为 WAR 文件的步骤：
- 进入“Project”菜单，选择“Properties”菜单，选择“Tomcat”选项，并单击“Export to WAR settings”选项卡。
- 单击“WAR file for export”边上的“Browse”，将其设置为您选定的文件夹 /easyStruts.war，并保存设置。
- 然后进入 project 弹出菜单，选择“Tomcatproject”，并在子菜单中单击“Export to the WAR file sets in projectproperties”。
- 在显示“Operationsuccessful”消息之后，您可以转到第 2 步中指定的位置获取 WAR 文件。
在本文中，我们介绍了 Easy Struts 在开发在 Tomcat Web 服务器上运行的 Struts 应用程序方面的功能。您已经学习了如何处理表单验证，如何创建局部和全局的转 发和异常，同时还知道了如何进行异常处理，如何连接数据源，内容的国际化和本 地化，对应用程序进行模块化，创建自定义插件，以及将应用程序部署到客户端等知识。
![]() |
|
|
![]() |
Nancy Chen Junhua 是一位具有多年经验的自由软件顾问和开发人员。她也在新加坡南洋科技大学从事 agent learning 方面的研究。可以通过 |
