ActionErrors 使用说明 struts validate 处理流程 详细教程
struts 处理流程是 jsp --> ActionForm 中的ActionErrors validate-->验证通过后执行 action ,否则返回页面,显示错误信息!
下载例子:
http://download.csdn.net/detail/mzy001mzy/1354519
例子:
/*
* Generated by MyEclipse Struts
* Template path: templates/java/JavaClass.vtl
*/
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;
/**
* MyEclipse Struts
* Creation date: 12-27-2007
*
* XDoclet definition:
* @struts.form name="loginForm"
*/
public class LoginForm extends ActionForm {
/*
* Generated fields
*/
/** password property */
private String password;
/** name property */
private String id;
private String validatecode;
/*
* Generated Methods
*/
public String getValidatecode() {
return validatecode;
}
public void setValidatecode(String validatecode) {
this.validatecode = validatecode;
}
/**
* Method validate
* @param mapping
* @param request
* @return ActionErrors
*/
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;
}
/**
* Method reset
* @param mapping
* @param request
*/
public void reset(ActionMapping mapping, HttpServletRequest request) {
// TODO Auto-generated method stub
}
/**
* Returns the password.
* @return String
*/
public String getPassword() {
return password;
}
/**
* Set the password.
* @param password The password to set
*/
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>