1.使用验证框架
<c:form action="loginUser" validate="true" >
2.不使用验证框架
<c:form action="loginUser" theme="simple" >
可以不写
在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 类中实现的,代码如下: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),代码如下:
< %@ 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>,分别用来显示动作错误信息,字段错误信息,和动作信息。如果信息为空,则不显示。
现在我们来实现一个动作类,代码如下:
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,代码如下:
< 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接口提供的所有的方法:
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教程4:使用validate方法验证数据》中曾讲到使用validate方法来验证客户端提交的数据,但如果使用validate方法就会将验证代码和正常的逻辑代码混在一起,但这样做并不利于代码维护,而且也很难将过些代码用于其他程序的验证。在Struts2中为我们提供了一个Validation框架,这个框架和Struts1.x提供的Validation框架类似,也是通过XML文件进行配置。
一、服务端验证
下面将给出一个例子来演示如何使用Struts2的validation框架来进行服务端验证。我们可以按着如下四步来编写这个程序:
【第1步】建立Action类(NewValidateAction.java)
import com.opensymphony.xwork2.ActionSupport;
public class NewValidateAction extends ActionSupport
{
private String msg; // 必须输入
private int age; // 在13和20之间
public String getMsg()
{
return msg;
}
public void setMsg(String msg)
{
this .msg = msg;
}
public int getAge()
{
return age;
}
public void setAge( int age)
{
this .age = age;
}
}
下面我们来验证msg和age属性。
【第2步】配置Action类,struts.xml的代码如下:
<! DOCTYPE struts PUBLIC
"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
"http://struts.apache.org/dtds/struts-2.0.dtd" >
< struts >
< package name ="demo" extends ="struts-default" namespace ="/test" >
< action name ="new_validate" class ="action.NewValidateAction" >
< result name ="input" > /validate_form.jsp </ result >
< result name ="success" > /validate_form.jsp </ result >
</ action >
</ package >
</ struts >
【第3步】编写验证规则配置文件
这是一个基于XML的配置文件,和struts1.x中的validator框架的验证规则配置文件类似。但一般放到和要验证的.class文件在同一目录下,而且配置文件名要使用如下两个规则中的一个来命名:
<ActionClassName>-validation.xml
<ActionClassName>-<ActionAliasName>-validation.xml
其中<ActionAliasName>就是struts.xml中
<ation name="xxxxx">的name属性值(action名字)。
在本例中我们使用第一种命名规则,所以文件名是NewValidateAction-validation.xml。文件的内容如下:
<! DOCTYPE validators PUBLIC "-//OpenSymphony Group//XWork Validator 1.0.2//EN"
"http://www.opensymphony.com/xwork/xwork-validator-1.0.2.dtd" >
< validators >
< field name ="msg" > <!--( 如果使用po)field name ="user.userName" -->
< field-validator type ="requiredstring" >
< message > 请输入信息 </ message >
</ field-validator >
</ field >
< field name ="age" >
< field-validator type ="int" >
< param name ="min" > 13 </ param >
< param name ="max" > 20 </ param >
< message >
必须在 13至20之间
</ message >
</ field-validator >
</ field >
</ validators >
这个文件使用了两个规则:requiredstring(必须输入)和int(确定整型范围)。关于其他更详细的验证规则,请读者访问http://struts.apache.org/2.0.11.1/docs/validation.html来查看。
【第4步】编写数据录入JSP页。
在Web根目录中建立一个validate_form.jsp文件,代码如下:
< %@ taglib prefix ="s" uri ="/struts-tags" % >
< link rel ="stylesheet" type ="text/css" href ="<s:url value=" /styles/styles.css" /> ">
< html >
< head >
< title > 验证数据 </ title >
</ head >
< body >
< s:form action ="new_validate" namespace ="/test" >
< s:textfield name ="msg" label ="姓名" />
< s:textfield name ="age" label ="年龄" />
< s:submit />
</ s:form >
</ body >
</ html >
大家要注意一下,如果在struts.xml的<package>标签中指定namespace属性,需要在<s:form>中也将namespace和action分开写,如上面代码所示。不能将其连在一起,Struts2需要分开的action和namespace。如下面的代码是错误的:
<s:form action="/test/new_validate" >
... ...
</s:form>
在上面的程序中还使用了一个styles.css来定制错误信息的风格。代码如下:
.label {font-style:italic; }
.errorLabel {font-style:italic; color:red; }
.errorMessage {font-weight:bold; color:red; }
需要在Web根目录中建立一个styles目录,并将styles.css
假设Web工程的上下文路径是validation,可以使用如下的URL来测试这个程序:
http://localhost:8080/validation/validate_form.jsp
显示结果如图1所示。
原文出自:http://www.blogjava.net/nokiaguy/archive/2008/04/21/194599.html