Struts 2 数据校验功能及校验问题的解决方案

通过继承actionsupport类来完成action开发，actionsupport类不仅对action接口进行简单实现， 同时增加了验证、本地化等支持 。真实开发中自定义action都需要继承该类。对用户登录添加表单验证功能

actionsupport类的作用：

struts2不要求我们自己设计的action类继承任何的struts基类或struts接口，但是我们为了方便实现我们自己的action，大多数情况下都会继承com.opensymphony.xwork2.actionsupport类，并重写此类里的public string execute() throws exception方法。因为此类中实现了很多的实用借口，提供了很多默认方法，这些默认方法包括国际化信息的方法、默认的处理用户请求的方法等，这样可以大大的简化acion的开发。 struts2中通常直接使用action来封装http请求参数，因此，action类里还应该包含与请求参数对应的属性，并且为属性提供对应的getter和setter方法。

那么action 接口和 actionsupport类的区别是什么呢？

action接口有:

public static final string success = "success";
public static final string none = "none";
public static final string error = "error";
public static final string login = "login";
public string execute() throws exception;

可以看到有五个静态常量和返回类型为string 的execute（）

而actionsupport这个工具类在实现了action接口的基础上还定义了一个validate()方法,重写该方法,它会在execute()方法之前执行,如校验失败,会转入input处，必须在配置该action时配置input属性。

另外,actionsupport还提供了一个gettext(string key)方法还实现国际化,该方法从资源文件上获取国际化信息.

这样在自定义标签时可以定义一个变量为new actionsupport对象实现国际化。

actionsupport类有（源码）：

public class actionsupport implements action, validateable, validationaware, textprovider, localeprovider, serializable {
protected static logger log = loggerfactory.getlogger(actionsupport.class);
private final validationawaresupport validationaware = new validationawaresupport();
private transient textprovider textprovider;
private container container;
public void setactionerrors(collection<string> errormessages) {
validationaware.setactionerrors(errormessages);
}
public collection<string> getactionerrors() {
return validationaware.getactionerrors();
}
public void setactionmessages(collection<string> messages) {
validationaware.setactionmessages(messages);
}
public collection<string> getactionmessages() {
return validationaware.getactionmessages();
}
@deprecated
public collection<string> geterrormessages() {
return getactionerrors();
}
@deprecated
public map<string, list<string>> geterrors() {
return getfielderrors();
}
public void setfielderrors(map<string, list<string>> errormap) {
validationaware.setfielderrors(errormap);
}
public map<string, list<string>> getfielderrors() {
return validationaware.getfielderrors();
}
public locale getlocale() {
actioncontext ctx = actioncontext.getcontext();
if (ctx != null) {
return ctx.getlocale();
} else {
if (log.isdebugenabled()) {
log.debug("action context not initialized");
}
return null;
}
}
public boolean haskey(string key) {
return gettextprovider().haskey(key);
}
public string gettext(string atextname) {
return gettextprovider().gettext(atextname);
}
public string gettext(string atextname, string defaultvalue) {
return gettextprovider().gettext(atextname, defaultvalue);
}
public string gettext(string atextname, string defaultvalue, string obj) {
return gettextprovider().gettext(atextname, defaultvalue, obj);
}
public string gettext(string atextname, list<?> args) {
return gettextprovider().gettext(atextname, args);
}
public string gettext(string key, string[] args) {
return gettextprovider().gettext(key, args);
}
public string gettext(string atextname, string defaultvalue, list<?> args) {
return gettextprovider().gettext(atextname, defaultvalue, args);
}
public string gettext(string key, string defaultvalue, string[] args) {
return gettextprovider().gettext(key, defaultvalue, args);
}
public string gettext(string key, string defaultvalue, list<?> args, valuestack stack) {
return gettextprovider().gettext(key, defaultvalue, args, stack);
}
public string gettext(string key, string defaultvalue, string[] args, valuestack stack) {
return gettextprovider().gettext(key, defaultvalue, args, stack);
}
public string getformatted(string key, string expr) {
map<string, object> conversionerrors = actioncontext.getcontext().getconversionerrors();
if (conversionerrors.containskey(expr)) {
string[] vals = (string[]) conversionerrors.get(expr);
return vals[0];
} else {
final valuestack valuestack = actioncontext.getcontext().getvaluestack();
final object val = valuestack.findvalue(expr);
return gettext(key, arrays.aslist(val));
}
}
public resourcebundle gettexts() {
return gettextprovider().gettexts();
}
public resourcebundle gettexts(string abundlename) {
return gettextprovider().gettexts(abundlename);
}
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);
}
public string input() throws exception {
return input;
}
public string dodefault() throws exception {
return success;
}
public string execute() throws exception {
return success;
}
public boolean hasactionerrors() {
return validationaware.hasactionerrors();
}
public boolean hasactionmessages() {
return validationaware.hasactionmessages();
}
public boolean haserrors() {
return validationaware.haserrors();
}
public boolean hasfielderrors() {
return validationaware.hasfielderrors();
}
public void clearfielderrors() {
validationaware.clearfielderrors();
}
public void clearactionerrors() {
validationaware.clearactionerrors();
}
public void clearmessages() {
validationaware.clearmessages();
}
public void clearerrors() {
validationaware.clearerrors();
}
public void clearerrorsandmessages() {
validationaware.clearerrorsandmessages();
}
public void validate() {
}
@override
public object clone() throws clonenotsupportedexception {
return super.clone();
}
public void pause(string result) {
}
private textprovider gettextprovider() {
if (textprovider == null) {
textproviderfactory tpf = new textproviderfactory();
if (container != null) {
container.inject(tpf);
}
textprovider = tpf.createinstance(getclass(), this);
}
return textprovider;
}
@inject
public void setcontainer(container container) {
this.container = container;
}

可以看到里面有很多的方法，但我们很明显看到有一个我们很了解的，validate（），数据校验的方法。通过这个方法，我们可以登录时，用户名和密码为空的提示，或其他··

现在举一个简单的例子：当用户名和密码为空，给客户一个友好提示。

下面通过两种方式来阐述struts 2的数据校验功能。

1. 编码方式校验

1) action一定要继承自actionsupport

2) 针对某个要进行校验的请求处理方法编写一个 public void validatexxx()方法,在方法内部进行表单数据校验.

3) 也可针对所有的请求处理方法编写public void validate()方法。

4) 在校验方法中，可以通过addfielderror()方法来添加字段校验错误消息。

5) 当校验失败时，struts框架会自动跳转到name为input的result页面。在校验失败页面中，可以使用<s:fielderror/>来显示错误消息
6) 简单，灵活。但重用性不高

重写validate方法

1.我们编写的action一般继承与actionsupport，而actionsupport不仅实现了action接口，还实现了validatable接口，提供了数据校验功能。在validatable接口中定义一个validate方法，重写该方法，如果校验表单输入域出现错误，则将错误添加到actionsupport类的fielderror域中，然后通过ognl表达式输出。

下面是用户登录校验界面：

<body>
<%--输出校验信息--%>
<%--想要单个提示 <s:fielderror fieldname="uname"/>--%>
<%--<s:property value=""/>
--%><div style="color:red"><s:fielderror/></div> 
<s:form name="form1" namespace="/" method="post" action="loginvalidateaction">
<s:div>请输入用户名:<s:textfield name="user.uname" ></s:textfield></s:div>
<s:div>请输入密码：<s:password name="user.upwd" ></s:password></s:div>
<s:submit value="登录"></s:submit>
</s:form>
<%--debug --%>
<s:debug></s:debug>
</body>

用户输入数据后，提交到loginvalidateaction 中：

public class loginvalidateaction extends actionsupport implements action {
public user user;
public map<string, object> map;
//验证的方法，会对所有的action起作用
@override 
public void validate() {
if(user.getuname().length()==0){
addfielderror("uname", "用户名不能为空!");

}
if(user.getupwd().length()==0){
addfielderror("upwd", "密码不能为空!");
} 

} 
//处理业务的方法
public string execute() throws exception {
system.out.println(user.getuname());
if(user.getuname().equals("admin")&&user.getupwd().equals("admin")){
//让struts2注入 map集合
map.put("uname", user.getuname());
//如果登录成功，返回“ success”
return success;
}
else{
//登录失败，返回 error
return input; //此处一定是 input
}
}
/**
* @return the user
*/
public user getuser() {
return user;
}
/**
* @param user the user to set
*/
public void setuser(user user) {
this.user = user;
}

上面的loginvalidateaction类重写了validate方法，该方法会在执行excute方法之前执行，如果执行该方法之后，action类的filederror中包含了数据校验错误，请求将被转发到input逻辑视图。

struts.xml配置如下：

<!-- 数据校验 -->
<action name="loginvalidateaction" class="cn.struts2.action.loginvalidateaction">
<!-- 结果为“success”时，跳转至success.jsp页面 -->
<result name="success">success.jsp</result>
<!-- 结果为"error"时，跳转至fail.jsp页面 或 还在登录界面 login.jsp-->
<result name="input">loginvalidateaction.jsp</result>
<result name="login">fail.jsp</result> 
<result name="error">fail.jsp</result> 
</action>

在客户端的效果：

但是大家注意没有呢，当提示错误的时候不太是我们想要的的效果显示。

这个不是我们所想要的，那么我们怎么改呢？其实这主要显示的struts2主题样式导致的，

再来看看：

它自动给我们添加了样式。struts2提供了三种主题，ajax, simple, xhtml，它默认的是xhtml主题，当然你可以写任意个你自己的主题,我们称之为自定义主题。可以通过设置解决以上问题

有两种方法可以解决：

1.简单的方法（也很实用，针对所有struts2标签），在struts.xml中，加上下一行代码就可以了。

<constant name="struts.ui.theme" value="simple" />

代表所有的页面采用的都是 simple主题了，这时它输出的页面，不回添加任何多余的代码，比如 table tr td 等，我们就可以像其他编辑页面的方式编辑页面的风格。

现在再来看看，错误的提示格式

我们可以通过设置这样一个标签：

<s:property value="errors.uname[0]"/>

把这个标签注释掉：

<div style="color:red"><s:fielderror/></div> 

但我们设置成 这样时，会出现这样的效果。

这种效果就有点想我们平常输入错误时的那个提示了，还有其他属性值，这里就不用一一列举了。

使用struts2的校验框架

xml配置方式校验。

在编码方式之前被执行。

1) 针对要校验的action类，在同包下编写一个名为:action类名-validation.xml校验规则文件。

2) 在校验规则文件中添加校验规则：具体的校验器名，参数可参看struts2的reference或struts2的api。

a) field校验：针对action类中每个非自定义类型的field进行校验的规则。

<field name="要校验的field名">
<field-validator type="校验规则器名" short-circuit="是否要短路径校验(默认是false)">
<param name="校验器要使用的参数名">值</param>
<message>校验失败时的提示消息</message>
</field-validator>
<!-- 还可添加其它的校验规则 -->
</field>

b) 非field校验：针对action类的某些field使用ognl表达进行组合校验。

<validator type="fieldexpression">
<param name="fieldname">pwd</param>
<param name="fieldname">pwd2</param>
<param name="expression"><![cdata[pwd==pwd2]]></param><!-- ognl表达式 -->
<message>确认密码和密码输入不一致</message>
</validator>

c) visitor校验：主要是用来校验action类中的自定义类型field。(针对使用模型驱动方式时)

i) 在action类的的校验规则文件中针对自定义类型field使用visitor校验规则。

<!-- 针对自定义field使用visitor校验 -->
<field name="user">
<field-validator type="required" short-circuit="true">
<message>用户的信息必填</message><!-- 消息前缀 -->
</field-validator>
<field-validator type="visitor"><!-- 指定为visitor校验规则 -->
<param name="context">usercontext</param><!-- 指定本visitor校验的上下文名 -->
<param name="appendprefix">true</param><!-- 是否要添加校验失败消息的前缀 -->
<message>用户的</message><!-- 消息前缀 -->
</field-validator>
</field>

ii) 针对visitor的field编写一个校验规则文件.文件名为: visitor字段类型名[-visitor校验的上下文名]-validation.xml. 例如: 本例中的文件名为user-usercontext-validation.xml

注意: 此文件要存放到visitor字段类型所在的包下.

iii) 在visitor的field校验规则文件中针对要校验的field添加校验规则.

　　我们还可以不重写validate方法，而通过增加校验配置文件来进行数据校验。这个校验配置文件通过使用struts2已有的校验器来完成对表单域的校验，下面以requiredstring校验器为例，这个校验器是一个必填校验器，指定某个表单域必须输入。

下面是这个校验配置文件loginvalidateaction-validation.xml的写法：

<?xml version="1.0" encoding="utf-8"?>
<!doctype validators public "-//apache struts//xwork validator 1.0.2//en" 
"http://struts.apache.org/dtds/xwork-validator-1.0.2.dtd">
<validators>
<field name="uname">
<field-validator type="requiredstring">
<message>用户名不能为空</message>
</field-validator>
</field>
<field name="upwd">
<field-validator type="requiredstring">
<message>密码不能为空</message>
</field-validator>
<field-validator type="stringlength">
<param name="maxlength">18</param>
<param name="minlength">6</param>
<message>密码长度应该在${minlength}--${maxlength}位之间</message>
</field-validator>
</field>
</validators>

注意：这个校验配置文件必须遵守下面两个规则：

　　1、该文件命运格式必须是action类名-validation.xml，例如本例中该文件名为：loginvalidateaction-validation.xml

　　2、该文件必须与action类的class文件位于同一路径下，本例中文件位于

loginvalidateaction类的代码还是一样：

public class loginvalidateaction extends actionsupport implements action {
public user user;
public map<string, object> map;
//验证的方法，会对所有的action起作用
@override 
public void validate() {
if(user.getuname().length()==0){
addfielderror("uname", "用户名不能为空!");
}
if(user.getupwd().length()==0){
addfielderror("upwd", "密码不能为空!");
} 
} 
//处理业务的方法
public string execute() throws exception {
system.out.println(user.getuname());
if(user.getuname().equals("admin")&&user.getupwd().equals("admin")){
//让struts2注入 map集合
map.put("uname", user.getuname());
//如果登录成功，返回“ success”
return success;
}
else{
//登录失败，返回 error
return input; //此处一定是 input
}
}
/**
* @return the user
*/
public user getuser() {
return user;
}
/**
* @param user the user to set
*/
public void setuser(user user) {
this.user = user;
}

以上所述是小编给大家介绍的struts 2 数据校验功能及校验问题的解决方案，希望对大家有所帮助