Struts2教程4：使用validate方法验证数据

上一篇：Struts2教程3：struts.xml经常使用配置解析

在Struts2中最简单的验证数据的方法是使用validate。咱们从ActionSupport类的源代码中能够看到，ActionSupport类实现了一个Validateable接口。这个接口只有一个validate方法。若是Action类实现了这个接口，Struts2在调用execute方法以前首先会调用这个方法，咱们能够在validate方法中验证，若是发生错误，能够根据错误的level选择字段级错误，仍是动做级错误。而且可以使用addFieldError或addActionError加入相应的错误信息，若是存在Action或Field错误，Struts2会返回“input”（这个并不用开发人员写，由Struts2自动返回），若是返回了“input”，Struts2就不会再调用execute方法了。若是不存在错误信息，Struts2在最后会调用execute方法。

这两个add方法和ActionErrors类中的add方法相似，只是add方法的错误信息须要一个ActionMessage对象，比较麻烦。除了加入错误信息外，还可使用addActionMessage方法加入成功提交后的信息。当提交成功后，能够显示这些信息。

以上三个add方法都在ValidationAware接口中定义，而且在ActionSupport类中有一个默认的实现。其实，在ActionSupport类中的实现其实是调用了ValidationAwareSupport中的相应的方法，也就是这三个add方法是在ValidationAwareSupport类中实现的，代码以下：

private  final ValidationAwareSupport validationAware =  new ValidationAwareSupport();

public  void addActionError(String anErrorMessage) 
{      validationAware.addActionError(anErrorMessage);
}
public  void addActionMessage(String aMessage) 
{
    validationAware.addActionMessage(aMessage);
}
public  void addFieldError(String fieldName, String errorMessage) 
{
    validationAware.addFieldError(fieldName, errorMessage);
}

下面咱们来实现一个简单的验证程序，来体验一个validate方法的使用。

先来在Web根目录创建一个主页面（validate.jsp），代码以下：

< %@ page  language ="java"  import ="java.util.*"  pageEncoding ="GBK" % >
< %@ taglib  prefix ="s"  uri ="/struts-tags"  % >
< html >
   < head >
     < title >验证数据 </ title >
   </ head >
  
   < body >
     < s:actionerror />
     < s:actionmessage />
     < s:form  action ="validate.action"   theme ="simple" >
        输入内容： < s:textfield  name ="msg" />
          < s:fielderror  key ="msg.hello"   />
          < br /> 
         < s:submit />
     </ s:form >
   </ body >
</ html >

在上面的代码中，使用了Struts2的tag：<s:actionerror>、<s:fielderror>和<s:actionmessage>，分别用来显示动做错误信息，字段错误信息，和动做信息。若是信息为空，则不显示。

如今咱们来实现一个动做类，代码以下：

package action;

import javax.servlet.http.*;

import com.opensymphony.xwork2.ActionSupport;
import org.apache.struts2.interceptor.*;

public  class ValidateAction  extends ActionSupport
{
     private String msg;
     public String execute() 
    {
        System.out.println(SUCCESS);
         return SUCCESS;
    }
     public  void validate()
    {
         if(!msg.equalsIgnoreCase("hello"))
        {
            System.out.println(INPUT);
             this.addFieldError("msg.hello", "必须输入hello!");
             this.addActionError("处理动做失败!");
        }
         else
        {
             this.addActionMessage("提交成功");
        }
    }
     public String getMsg()
    {
         return msg;
    }
     public  void setMsg(String msg)
    {
         this.msg = msg;
    }
}

你们从上面的代码能够看出，Field错误须要一个key（通常用来表示是哪个属性出的错误），而Action错误和Action消息只要提供一个信息字符串就能够了。

最后来配置一下这个Action，代码以下：

< package  name ="demo"  extends ="struts-default" >
     < action  name ="validate"  class ="action.ValidateAction" >
         < result  name ="success" >/error/validate.jsp </ result >
         < result  name ="input" >/error/validate.jsp </ result >
     </ action >
</ package >

假设应用程序的上下文路径为demo，则可经过以下的URL来测试程序：

http://localhost:8080/demo/validate.jsp

咱们还可使用ValidationAware接口的其余方法（由ValidationAwareSupport类实现）得到或设置字段错误信息、动做错误信息以及动做消息。如hasActionErrors方法判断是否存在动做层的错误，getFieldErrors得到字段错误信息（一个Map对象）。下面是ValidationAware接口提供的全部的方法：

package com.opensymphony.xwork2;

import java.util.Collection;
import java.util.Map;

public  interface ValidationAware
{
     void setActionErrors(Collection errorMessages);
    Collection getActionErrors();

     void setActionMessages(Collection messages);
    Collection getActionMessages();
     void setFieldErrors(Map errorMap);
    Map getFieldErrors();
     void addActionError(String anErrorMessage);
     void addActionMessage(String aMessage);
     void addFieldError(String fieldName, String errorMessage);
     boolean hasActionErrors();
     boolean hasActionMessages();
     boolean hasErrors();
     boolean hasFieldErrors();
}

下一篇：Struts2教程5：使用Validation框架验证数据