[标题]:[原]Struts2输入校验
[时间]:2009-7-26
[摘要]:替换struts默认的类型转换错误信息、给Struts标签指定主题、使用自定义业务方法和验证方法。
[关键字]:浪曦视频,Struts2应用开发系列,WebWork,Apache,输入校验,validate,validation
[环境]:struts-2.1.6、JDK6、MyEclipse7、Tomcat6
[作者]:Winty (wintys@gmail.com) http://www.blogjava.net/wintys
[正文]:
1、知识点
a.validate()中添加验证错误信息
当校验出错时,可以向客户端输出两种类型的Error:
addFiledError() //可以用<s:filederror />显示,也可以直接由Struts输入标签自动显示。
addActionError() //用<s:actionerror />显示。
b.替换struts默认的类型转换错误信息
例如:如果为int型的age输入字母,将出现类型转换错误信息:Invalid field value for field "age"。
这个信息是由Struts自动提供的,可以使用全局或局部配置文件对其进行替换。
a).替换struts默认的类型转换错误信息的全局配置:
在struts.xml中增加constant,指明全局配置文件的名称为"message":
<struts>
<constant name="struts.custom.i18n.resources " value="message">
</constant>
</struts>
在struts.xml相同目录下新建message.properties,message.properties内容可使用中文,但需要JDK的native2ascii进行转换。内容如下({0}代表出现错误的字段):
xwork.default.invalid.fieldvalue ={0} error
b).替换struts默认的类型转换错误信息的局部配置:
在RegisterAction.java相同目录下新建RegisterAction.properties("\u5E74\u9F84\u8F6C\u6362\u9519\u8BEF" = "年龄转换错误"):
invalid.fieldvalue.age =\u5E74\u9F84\u8F6C\u6362\u9519\u8BEF
c.给Struts标签指定主题
<s:textfield name="name" label="name" theme="simple" >
指定simple主题,则Struts不生成table等布局。
同时,不会显示label,也不会显示field errror。
但与HTML input不同的是,可以保存提交失败后的值。
d.指定自定义业务方法register()替代execute()
在struts.xml中配置:
<action name="register"
class="wintys.struts2.validation.RegisterAction"
method="register" >
并在类RegisterAction中添加方法register(),与execute()签名相同:
public String register()throws Exception{
System.out.println("register()...");
return SUCCESS;
}
e.使用自定义验证方法validateRegister()
在类RegisterAction中添加方法validateRegister(),与validate()签名相同:
public void validateRegister(){
System.out.println("validateRegister()...");
}
validateRegister()并不替换validate(),而是先于validate()执行。Struts从struts.xml中的配置得知register(),而使用反射寻找validateRegister()。如果有validateRegister(),则执行之。然后再执行validate()。执行流程:validateRegister() => validate() => register()。
f.最佳实践
给默认execute()指定另一个validateExecute(),而不重写validate()。不把所有验证写在validate()中,则可以根据需要执行个性化验证。
2、详细代码
/StrutsHelloWorld/WebRoot/validation/input.jsp:
<%@ taglib prefix="s" uri="/struts-tags" %>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>struts validation</title>
</head>
<body>
<s:actionerror cssStyle="color:red"/>
<s:fielderror></s:fielderror>
<s:form name="register" action="register" theme="simple">
用户名:<s:textfield name="name" label="用户名"></s:textfield><br/>
密码:<s:textfield name="age" label="年龄"></s:textfield><br/>
<s:submit value=" 确定 "></s:submit> <br/>
</s:form>
</body>
</html>
/StrutsHelloWorld/WebRoot/validation/output.jsp:
<%@ taglib uri="/struts-tags" prefix="s"%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
</head>
<body>
<s:property value="name"/><br/>
<s:property value="age"/><br/>
</body>
</html>
/StrutsHelloWorld/src/wintys/struts2/validation/RegisterAction.java:
import com.opensymphony.xwork2.ActionSupport;
/**
*
* @author Winty (wintys@gmail.com)
* @version 2009-07-26
* http://www.blogjava.net/wintys
*/
@SuppressWarnings("serial")
public class RegisterAction extends ActionSupport {
private String name;
private int age;
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public int getAge() {
return age;
}
public void setAge(int age) {
this.age = age;
}
@Override
public void validate() {
System.out.println("validate()...");
//Action Error
if(name == null || name.length() < 6 || name.length()>10){
addActionError("invalid name");
}
//Filed Error
if(age <= 0 || age > 150){
addFieldError("age", "invalid age");
}
}
@Override
public String execute() throws Exception {
System.out.println("execute()...");
return SUCCESS;
}
/**
* 自定义验证方法,用于验证register()。
*
* 如果客户端请求的action name="register" ,
* 该验证会自动执行。
*/
public void validateRegister(){
System.out.println("validateRegister()...");
}
/**
* 自定义method,代替execute(),
* 则最终只运行register() , 而不运行execute()。
*
* 需在struts.xml中配置:method="register"
* <action name="register"
* class="wintys.struts2.validation.RegisterAction"
* method="register">
*/
public String register()throws Exception{
System.out.println("register()...");
return SUCCESS;
}
}
/StrutsHelloWorld/src/wintys/struts2/validation/RegisterAction.properties:
/StrutsHelloWorld/src/struts.xml:
<!DOCTYPE struts PUBLIC
"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
"http://struts.apache.org/dtds/struts-2.0.dtd">
<struts>
<!-- 定义全局错误信息资源文件message.properties -->
<constant name="struts.custom.i18n.resources" value="message"></constant>
<package name="MyStruts" extends="struts-default">
<action name="register" class="wintys.struts2.validation.RegisterAction" method="register">
<result name="success">/validation/output.jsp</result>
<result name="input">/validation/input.jsp</result>
</action>
</package>
</struts>
/StrutsHelloWorld/src/message.properties:
xwork.default.invalid.fieldvalue={0} error.
[参考资料]:
《浪曦视频之Struts2应用开发系列》
[附件]:
源代码: struts_StrutsValidation.zip