jakarta struts简介.txt

一些自己平时积累的小知识点, java 的 javaee 的

                        return (errors);
        }
}

        以上的代码，只有两点和一般的Java Bean有所不同。其一是reset方法，方法中设置的值将在表单被reset时反应到其对应的表单项上，即将表单项的数据恢复到默认值。其二是validate方法，是用来验证用户在表单中所输入数据的方法。在当前这个例子中，我们只验证用户输入的用户名。因为一个用户名其对应的密码可能为空，所以我们的逻辑就是验证时不去检查密码。验证用户名，当发现输入的用户名为空时，方法就会产生一个错误对象（ActionError）。
        在Struts中用ActionErrors来装载多个错误，从ActionErrors结尾的那个“s”就可以知道她是一个ActionError对象的集合。在验证用户输入时，可以验证完表单中所有数据后，再将可能发现的多个错误通过ActionErrors返回给用户，这样的逻辑应该是想当然的啦，不可能用户有五个不同的输入错误，却要分五次提示，让用户修改提交五遍吧，呵呵。
        同时，要知道在我们这个例子中，我们将错误信息提示给用户是通过ApplicationResource.properties文件。这个文件在Tomcat启动时通过web.xml中的定义为这个应用所使用。通常每一个应用都在其WEB-INF目录下都有web.xml文件来描述系统，而关于部署应用时具体的结构信息，请参考Tomcathttp://jakarta.apache.org/tomcat/index.html等Server相关的用户手册。
        ApplicationResource.properties文件中可以定义应用中所要用到的提示信息的字符串，字符串都通过一个键值来唯一确定其位置。在我们这个例子中，键值error.userName.required所对应的字符串信息是“A username is required”，在给用户显示错误信息时，也就通过键值确定的错误提示显示该字符串。通过这样的机制，为我们在系统中实现多语言提供了便利，将该文件中的这些字符串翻译成相应的语言，我们的系统就可以实现西班牙语、德语、法语和汉语等等语言的版本了。
        下面这些ApplicationResource.properties中的信息对于我们这个简单的示例中已经够用了：

login.title=Login Struts Sample
error.userName.required=A username is required
error.login.authenticate=Invalid username/password
errors.footer=</ul><hr>
errors.header=<h3><font color="red">Page 
Validation</font></h3>Please correct the 
following error(s) before contiuing:<ul>
applicationResources=Cannot load application resources bundle 
{0}

        页面的标题，按钮或其他什么需要文本提示的地方都可以通过这个文件来定义显示用字符串。我们将在该系列的最后一篇文章，也就是后续几个开发步骤中讲解如何通过Struts的标签从这个文件中获取显示用字符串。
        
Sue Spielmanhttp://www.onjava.com/pub/au/113是ONJava.com的副编辑，主要擅长于JSP和Servlet技术，她还是Switchback Software LLChttp://www.switchbacksoftware.com/公司的总裁和高级技术咨询专家。


matrix开源技术经Onjava授权翻译并发布.
如果你对此文章有任何看法或建议,请到Matrix论坛发表您的意见.
注明: 如果对matrix的翻译文章系列感兴趣,请点击oreilly和javaworld文章翻译计划查看详细情况
您也可以点击-Wingc查看翻译作者的详细信息.


 学习Jakarta Struts(三)  
 
发布时间：2006.03.15 19:51     来源：Matrix    作者：chris 

本文是三篇学习Struts框架系列文章的最后一篇（原文请见http://www.onjava.com/pub/a/onjava/2001/11/14/jsp_servlets.html）。
在第一篇文章《Jakarta Struts简介》中，我大致分析了Struts框架，讨论了它所能完成的功能，还浏览了组成Struts的各个组成部分。在第二篇文章《学习Jakarta Struts》中，我开始详细描述如何利用Struts来构建一个简单应用的过程步骤。而本篇文章将会向大家演示如何将ApplicationResource文件中的文本信息，通过Struts标签在JSP页面中显示出来。
Action类是连接Struts架构和应用中业务逻辑代码的桥梁。所以你应该尽可能让Action类小巧简单，因为真实应用中的逻辑处理应该是由单独分离出来的逻辑层来完成的。如果你正在从事n层应用的开发，你当然希望层与层之间的接口越简单越好。而事实上，Action类中的主要方法"perform()"（1.1中为execute()）却有点暗示应该在本方法中做点什么的意思。我们知道，每个Action类都需要从 org.apache.struts.action.Action 继承而来。在小型应用中，我们的Action类很可能就只要继承org.apache.struts.action.Action就足够了；而在某些特定的复杂应用中，我就从我们所实现的Action类中总结出来了一些通用特性。因此，在我看来，构造一个基类将这些通用特性的代码实现出来，让应用中所用到的所有Action类不直接继承org.apache.struts.action.Action，而继承这个完成了一些通用特性的基类以实现代码重用，是一个相当不错的设计。我在StrutsSample中就应用了这种方法，构造了这样的一个基类，该基类的方法在完成复杂逻辑的和简单转发请求的Action类中都可以使用。

package com.oreilly.actions;

import java.io.IOException;
import java.util.Properties;
import java.util.ResourceBundle;
import java.util.MissingResourceException;
import java.util.Enumeration;
import java.util.Properties;
import java.rmi.RemoteException;
import javax.ejb.EJBHome;
import javax.ejb.CreateException;
import javax.naming.Context;
import javax.naming.InitialContext;
import javax.naming.NamingException;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import org.apache.struts.action.Action;
import org.apache.struts.action.ActionServlet;
import org.apache.struts.action.ActionForm;
import org.apache.struts.action.ActionForward;
import org.apache.struts.action.ActionMapping;

这个类就是使用Struts开发时，所有Action类都要继承的基类。它把一些通常在实际应用中最有可能被用到的东西都考虑进来了。就这篇文章而言， 类中一些与Struts并不是太紧密相关的方法将只做注释而不会完整的实现，而从事开发工作的你，有兴趣的话，请完成这些方法并应用这个类，将为你在实际项目中的开发快马加鞭。注意，因为所有的Action类都要从org.apache.struts.action.Action 继承而来，所以我们的这个类同样。
public abstract class AbstStrutsActionBase extends Action {
  / * 定义一些在struts-config.xml中记录在案的
   * 全局应用中皆可可通用的forward标识*/
  protected static final String SUCCESS = "success";
  protected static final String FAILURE = "failure";
  protected static final String ERROR = "error";
  protected static final String LOGIN = "login";
  protected static final String CONFIRM = "confirm";
  protected Context jndiContext = null;

  /**
   * 默认构造方法
   */

  public AbstStrutsActionBase() {
}

/**
下面这个查找EJB实例的方法将不会完整实现。
一般来说，Action类应该调用实现了应用的商务逻辑的EJB会话bean（或仅仅普通JavaBean）。在大型项目中，开发人员必须划清层与层之间的界限。在Action类中，我们应该拿到获取含有JNDI信息的环境的实例，然后通过EJB的JNDI名字去查询获取它的home接口。过程并不简单，所以下面这个代码片断只是个给出了必要实现的小例子。
&#61548; 参数类型String，传入的要查询JNDI的名字
&#61548; 返回类型Object，即查找到的home接口
&#61548; 如果查找失败，抛出NamingException异常
&#61548; 如果获取资源信息失败，抛出MissingResourceException异常
*/

public Object lookup(String jndiName)
    throws NamingException, MissingResourceException {
  // 为调用EJB对象，通过构建记录JNDI信息的Properties对象
  // 来获得初始环境信息
    if (jndiContext == null) {
      ResourceBundle resource =
        ResourceBundle.getBundle("strutssample.properties");
    Properties properties = new Properties();
      properties.setProperty(
        Context.INITIAL_CONTEXT_FACTORY,
        resource.getString(Context.INITIAL_CONTEXT_FACTORY));
    properties.setProperty(
        Context.PROVIDER_URL,
        resource.getString(Context.PROVIDER_URL));
    properties.setProperty(
        Context.SECURITY_PRINCIPAL,
        resource.getString(Context.SECURITY_PRINCIPAL));
    properties.setProperty(
        Context.SECURITY_CREDENTIALS,
        resource.getString(Context.SECURITY_CREDENTIALS));
    jndiContext = new InitialContext(properties);
}

注意：在真正的产品中，我们应该在此处考虑代码的健壮性，将代码加入到try/catch块内，并记录所有错误或重要信息到系统log中。而本例中，我们仅仅把异常往外抛，并假定一定会找到EJB对象的home接口并返回。

    return (jndiContext.lookup(jndiName));
}

由于Action类将是由Struts来调用的。所以它的主要方法应该是一个抽象方法，而由每个继承的子类来具体实现，或者在其中做一些所有Action都会做的通用机制，例如记录log信息。在本例中，我们一切从简，将其抽象之。
&#61548; 参数mapping：其类型为ActionMapping，将在本Action做跳转选择用
&#61548; 参数actionForm：由Struts根据本次HTTP请求数据填充完成的ActionForm对象（可选，如果存在请求数据的话）
&#61548; 参数request：此Action所有处理的本次HTTP请求（对象）
&#61548; 参数response：此Action输出数据所要用到的HTTP响应（对象）
&#61548; 如果有I/O错误出现，则本方法抛出IOException异常
&#61548; 如果处理时发生servlet异常，则本方法抛出ServletException异常
&#61548; 本方法处理完请求后按照处理逻辑返回相应的页面导向（对象）

  public abstract ActionForward perform(
    ActionMapping mapping,
    ActionForm form,
    HttpServletRequest request,
    HttpServletResponse response)
    throws IOException, ServletException;
}

或者让这个抽象方法更有用一点，那就在里面干点什么吧，比如像下面这样在其中记录log。

  {
    ActionForward forward = null;
    //  只是简单的记录一些提示信息到servlet log

    getServlet().log(
      "AbstStrutsActionBase.perform() [Action Class: "
        + this.getClass().getName()
        + " ]");
    getServlet().log(
      "AbstStrutsActionBase.perform() [Form Class : "
        + (form == null ? "null" : form.getClass().getName())
        + " ]");
  }

然后，我们再编写的每个Action类都应该从AbstStrutsActionBase继承，并依照处理逻辑编写各自的perform方法。让我们用LoginAction为例，看看具体应该怎么应用吧。

package com.oreilly.actions;

import java.io.IOException;
import java.rmi.RemoteException;
import javax.ejb.CreateException;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import org.apache.struts.action.ActionError;
import org.apache.struts.action.ActionErrors;
import org.apache.struts.action.ActionForm;
import org.apache.struts.action.ActionMapping;
import org.apache.struts.action.ActionForward;
import com.oreilly.forms.LoginForm;

/*
LoginAction 将演示一个Action将如何被Struts架构所调用
在这个例子中，我们只是简单的演示perform方法是如何调用、执行并返回的