ActionErrors 使用说明 struts validate 处理流程

struts  处理流程是  jsp  -->  ActionForm 中的ActionErrors validate-->验证通过后执行 action  ，否则返回页面，显示错误信息！

例子：

package org.myrose.form;

import javax.servlet.http.HttpServletRequest;

import org.apache.struts.action.ActionErrors;

import org.apache.struts.action.ActionForm;

import org.apache.struts.action.ActionMapping;

import org.apache.struts.action.ActionMessage;

public class LoginForm extends ActionForm {

 private String password;

 private String id;

 private String validatecode;

 public String getValidatecode() {

  return validatecode;

 }

 public void setValidatecode(String validatecode) {

  this.validatecode = validatecode;

 }

 public ActionErrors validate(ActionMapping mapping,

   HttpServletRequest request) {

  ActionErrors errors = new ActionErrors();

  if(id == null || id.trim().equals("")){

   errors.add("login_id_null",new ActionMessage("login.id.null"));

   return errors;

  }else if(id.length() != 20){

   errors.add("login_id_length",new ActionMessage("login.id.length"));

   return errors;

  }else if(password == null || password.trim().equals("")){

   errors.add("login_password_null",new ActionMessage("login.password.null"));

   return errors;

  }else if(password.length() != 6){

   errors.add("login_password_length",new ActionMessage("login.password.length"));

   return errors;

  }else if(!validatecode.equals(request.getSession().getAttribute("rand").toString())){

   errors.add("login_validatecode_error", new ActionMessage("login.validatecode.error"));

   return errors;

  }

  return null;

 }

 public void reset(ActionMapping mapping, HttpServletRequest request) {

  // TODO Auto-generated method stub

 }

 public String getPassword() {

  return password;

 }

 public void setPassword(String password) {

  this.password = password;

 }

 public String getId() {

  return id;

 }

 public void setId(String id) {

  this.id = id;

 }

}

转自：http://hi.baidu.com/630270730/item/e946aa5f8af0bf434eff2083

一、简介ActionErrors与ActionMessages

ActionErrors是ActionMessages的子类，包括ActionMessage，他们都实现了接口java.io.serializable。原来ActionError是ActionMessage的子类，后来在struts1.3中已被弃用，估计原因是ActionMessage能满足要求，并且 ActionErrors亦能用作ActionMessage的容器，所以ActionError显得多余。

ActionErrors和ActionMessages都可作为ActionMessage的容器，ActionMessages实例也可以互为容器，甚至ActionErrors可以做父类实例ActionMessages的容器（这里体现了“里氏代换”原则——父类出现的地方，子类是可以安全替代的），既可以有errors.add(msgs)。

二、例子

先来看一个简单例子

1、资源文件错误信息来源(其格式为 key = value )

   error.test = this is a test error.

2、JSP页面中用于显示错误信息标签

   <html:errors property="testerror"/>

3、ActionFormBean的validate()方法中产生错误信息

   ActionErrors error = new ActionErrors();

   error.add("testerror",new ActionMessage("error.test"))

   return error;

这个例子的功能就是在ActionForm Bean的validate()方法中产生一条名为：testerror的错误信息，

错误信息息是资源文件中key为error.test的值。然后在页面上用html:errors标签输出testerror这条错误信息。

这是最常用的一种功能，所有的错误信息都在资源文件里面。

有人会问，错误信息只能存放在资源文件中吗，其实不是这样。不需要资源文件也可以产生错误信息。

1)ActionMessage(String key,boolean isresource)

如果isresource值为true,则表示key是资源文件中的key，产生的消息就是与key相对应的消息

如果isresource值为false,则表示key为一条普通的消息。

如果上面的error.add改为error.add("testerror",new ActonMessage("这是一条自定义消息",false",));

那么页面上显示的将是：这是一条自定义消息.

2)另外还可以用ActionMessage产生复合消息，比如我们要输出：xxx不能用作用户名，其中xxx是一个变量。

首先我们在资源文件中加一个条复合消息

testmsg = {0}不能用作用户名。这里{0}是要被替换的参数。

我们再来看一下ActionMessage的另一中构造方法

ActionMessage(String key,Object value0);

也就是说用value0的值来替换{0}

我们修改error.add为error.add("testerror",new ActonMessage("testmsg","毛泽东"))

那么JSP页面上将显示：毛泽东不能用作用户名。

当然在一条复合消息中也可带多个参数，参数依次为{0},{1},{2}或更多

例如：loginUser = 用户名:{0} 姓名:{1} 登录次数:{2}.....

那么在产生错误消息时就用new ActionMessage(String key,Object value0,Object value1,Object value2.....)

或者使用对象数组new ActionMessage(String key,Object[] values)

String[] detail = {"Admin","王晶","12"};

error.add("testerror",new ActionMessage("loginUser",detail))

________________________________________

Note：

Cannot find message resources under key org.apache.struts.action.MESSAGE 错误的原因是没有配置资源文件

解决办法： 在struts-config.xml 中加入如下的一段

<message-resources parameter="application" null="false"></message-resources>

-----------------------------------------------------------------------------------------------------------------------

在Action或Form里生成errors:

在Action中使用：

 ActionErrors errors = new ActionErrors();

//创建一个error,topic.show.error要在application.properties文件中声明

 ActionError error1 = new ActionError("topic.show.error");

//加入到errors ，content为键

  errors.add("content", error1);

//创建多个error

 ActionError error2 = new ActionError("topic.show.error");

 ActionError error3 = new ActionError("topic.show.error"); 

  errors.add("error2", error2);

  errors.add("error2", error3);      

//Action返回值是Forward，所以要保存此errors

  this.saveErrors(request, errors);

在JSP端就可以用：

<html:errors property="content" />

来显示error1这个错误。

若用<html:erros />则显示出所有的错误

三、详细讲解

ActionMessages以一个HashMap存储ActionMessage.Map中的key是一个标识,其对应的value是一个List对象,所有的ActionMessage存储在List中.也就是说key标识了一组ActionMessage.

1、 ActionMessage

1)ActionMessage(String key)该方法接受一个字符串,字符串是在资源文件种配置的key值,必须在配置文件中进行相关配置.

2)ActionMessage(String key,Object value)

3)ActionMessage(String key,Object value0,Object value1)

4)ActionMessage(String key,Object value0,Object value1,Object value2)

5)ActionMessage(String key,Object value0,Object value1,Object value2,Object value3)

上面4个方法第一个参数同样是资源文件中配置的key值,同样必须在配置文件中进行相关配置.

后面的参数为资源文件中key所对应的信 息中需要的参数 ActionMessage(String key,Object[] values)

这种方法第一个参数同上,第二个参数接受一个Object数组,其中保存key在资源文件中对应信息需要的参数.

6)ActionMessage(String msg,false )这个方法显示自定义消息，即消息输出内容为msg。

7)getKey()返回ActionMessage的key，返回类型：String。

8)getValues()返回ActionMessage中设定的资源文件参数，返回类型：Object[]。

2、ActionMessages

ActionMessages.add(String property,ActionMessage message)

第一个参数property对应于<html:messages>标签中的property属性, property的值一般采用ActionMessages类中的静态常量ActionMessages.GLOBAL_MESSAGE,也可以自己定义一个key.该方法执行时,先判断ActionMessages中有没有该key,如果没有就新添加对key-List键值对;如果有同样的key,就先获取该key对应的Value并转换为List对象,然后将(ActionMessage)message添加进List对象中.

ActionMessages.add(ActionMessages ams)该方法将参数中保存的ActionMessage合并到调用ActionMessages中.

3、Action及其所有子类

1)addMessages(HttpServletRequest request,ActionMessages messages)

 该方法首先检查request对象中是否有ActionMessages对象,如果有对象,则将接收的ActionMessages合并到request中,如果没有,用setAttribute(Globals.MESSAGE_KEY,messages)方法将messages添加进去.如果一个Action中需要显示多条错误信息,推荐使用该方法.

(Globals.MESSAGE_KEY ="org.apache.struts.action.ACTION_MESSAGE")

2)saveMessages(HttpServletRequest request,ActionMessages messages)

 该方法保存messages时,如果request中已经有一个ActionMessages对象,则用新的覆盖原有的.不推荐使用该方法,该方法容易发生丢失信息的情况.

3)addErrors()和saveErrors()

这两个方法与addMessages()和saveMessages()相似,不过在HttpServletRequest.setAttribute()时的参数不一样,这两个方法是:setAttribute(Globals.ERROR_KEY,messages)添加的.(Globals.ERROR_KEY = "org.apache.struts.action.ERROR")

4)clear()

5)isEmpty()

6)isAccessed()是否已将ActionMessages存入request中。

7)size()存于ActionMessages中的ActionMessage的数量。

8)size(String property)ActionMessages中property键对应的List中的ActionMessage的数量。

9)properties()返回ActionMessages的所有key，并存于Iterator中。

10)get()返回存于ActionMessages中的所有ActionMessage，并存于Iterator中。

11)get(String property)返回ActionMessages中property键对应的List中的所有ActionMessage，并存于Iterator中。

4、 AtionErrors和ActionMessages的区别

1) ActionErrors是ActionMessages的一个子类，功能几乎相同，不同点在于标签<html:errors/>和<html:messages>的使用上的区别。

html:errors指定了footer和header属性。默认值为errors.header和errors.footer,需要时可以自己指定。如果资源属性文件配置了 errors.header和errors.footer，则任何时候使用html:errors时开头和结尾都是这两个属性对应的资源信息。

而html:message默认情况下没有errors.header和errors.footer值，当然可以自己指定。

2)html:errors可以根据property属性指定显示一个错误信息。html:messages有一个必添项id。html:messages不能直接显示信息，它将选出的信息放入一个用id标识的Iterator对象里，然后在用ben:write或JSTL c:out标签显示每个信息.例如：

<html:messages message="true" id="msg">

    <c:out value="${msg}"/><br />

</html:messages>