posts - 5, comments - 24, trackbacks - 0, articles - 20
  BlogJava :: 首页 :: 新随笔 :: 联系 :: 聚合  :: 管理

ActionMessages类及其绑定的组件

Posted on 2006-09-25 02:54 kook 阅读(1539) 评论(4)  编辑  收藏 所属分类: Struts

首先来了解一下ActionMessages类的结构:



在ActionMessages中包含着一个HashMap,其中的key就是add方法的property参数,然而他的值对应的是一个ActionMessageItem,ActionMessageItem是该类的一个内部类,当中包含了一个ArrayList。
由此可见,一个property中可以包含着多个ActionMessage,这些ActionMessage都将保存在ActionMessageItem的ArrayList中。

 1 public void  add(String property, ActionMessage message) {
 2 

 3         ActionMessageItem item =  (ActionMessageItem) messages.get(property);
 4         List list = null
;
 5 

 6         if (item == null ) {
 7             list = new
 ArrayList();
 8             item = new ActionMessageItem(list, iCount++
, property);
 9 

10              messages.put(property, item);
11         } else
 {
12             list =
 item.getList();
13 
        }
14 

15          list.add(message);
16 

17     }



每次添加新的ActionMessage中,ActionMessages类会判断HashMap中的get(property)是否存在,如果存在的话,就获得该list = item.getList();并把ActionMessage添加到其中。如果不存在,就会创建一个新的list = new  ArrayList();
再将内容添加到当中去。总的来说,ActionMessages就是一个保存信息的容器。通常ActionMessages是不会单独使用的,和他相关的一些Struts组件会对其进行访问和操作:

<html:errors>标签

<html:errors>标签是一个Struts组件,他的内部标签类对ActionMessages类的子类ActionErrors进行访问。通过在request和session中找到ActionErrors来获得相关信息。在此之前,先来了解下<html:errors>标签的几个重要属性:

name属性:
指定ActionMessages在request和session范围内的属性key.默认值为Globals.ERROR_KEY。由此我们可以了解到Struts是如此保存和获取ActionMessages的:

保存:
ActionErrors errors = new ActionErrors();

request.setAttribute(Globals.ERROR_KEY ,errors);或者

session.setAttribute(Globals.ERROR_KEY ,errors);

获取:
ActionErrors errors = new ActionErrors();

errors = (ActionErrors)request.getAttribute(Globals.ERROR_KEY);或者

errors = (ActionErrors)session.getAttribute(Globals.ERROR_KEY);或者

该属性通常我们不用设置和更改他,用默认值就可以啦。

property属性:
用来指定消息的属性,如果不设置该属性,那么<html:errors>标签将显示ActionMessages中的所有属性。如果设置了该属性,则只显示HashMap中Key为property属性值的ArrayList集合。通常,我们在调用ActionMessages的add方法时,会指定add方法的property参数,也就是第一个参数,将相关信息添加到指定的property对应的ArrayList中。那么我们要显示相关信息时,就可以指定输出<html:errors>标签的property属性对应的ArrayList,这两个property是相互对应的。

bundle属性:
指定资源文件的key属性。缺省的情况下调用的是默认的资源文件Application.properties。
如在struts-config.xml中声明的资源文件信息如下:

  < message - resources parameter = " com.kook.struts.ApplicationResources "   />
  
< message - resources key = " ch "  parameter = " com.kook.struts.ApplicationResources_ch "   />
  
< message - resources key = " en "  parameter = " com.kook.struts.ApplicationResources_en "   />

对应的add方法如下:

1 ActionErrors errors = new  ActionErrors();
2 if(name==null || name.length()<1
)
3 
{
4       errors.add("name",new ActionMessage("kong"
));
5 
 }
6  return errors;

new  ActionMessage( " kong " )对应在key="en"的资源文件中为:

kong=bu neng wei kong

JSP中的<html:errors>标签:

1 <html:errors property="name" bundle="en"/>

这时候将会输出key="en"的资源文件中的"kong"对应的信息:bu neng wei kong

<html:messages>标签

<html:messages>标签是用来在JSP页面上输出一条消息的。通常我们在做添加数据的时候,如果添加成功,通常会在前台页面反馈给用户一条“添加成功”的信息,这时候我们就可以用到这个标签。

name属性:

是指ActionMessages对象保存在request或session中的属性key,即request.setAttribute("heihei", messages);中的第一个参数。

message属性:如果为true,表示是从request或session中取得key为Globals.MESSAGE_KEY的ActionMessages对象,此时该标签设置的name属性的无效的。如果为false,表示从该标签的name属性来获得request或session的key值。缺省值就为false。

id属性:这个属性就不说了,检索出ActionMessages集合中单个对象的标识,他和<logic:iterate>的id是同一个意思。

小实验:

在action中的execute方法中添加如下代码:

1 ActionMessages messages = new ActionMessages();
2         
3 messages.add(""new ActionMessage("haha",false));
4         
5 this.saveMessages(request, messages);        
6 
7 return new ActionForward("/form/hello.jsp");

表示往ActionMessages对象中添加一条信息new ActionMessage("haha",false),并保存在request当中this.saveMessages(request, messages);  那么在这个方法中,他是如何保存ActionMessage对象的呢?下面是 saveMessages 方法的源代码: 

 1 protected void saveMessages(
 2         HttpServletRequest request,
 3         ActionMessages messages) {
 4 
 5         // Remove any messages attribute if none are required
 6         if ((messages == null|| messages.isEmpty()) {
 7             request.removeAttribute(Globals.MESSAGE_KEY);
 8             return;
 9         }
10 
11         // Save the messages we need
12         request.setAttribute(Globals.MESSAGE_KEY, messages);
13     }

观察这段代码不难发现,他是将ActionMessages存放在key为Globals.MESSAGE_KEY当中的,因此我们在调用ActionMessages的add方法时,他的property参数(add方法的第一个参数)就没有必要让我们自己去手动指定了,因为不论你指定什么参数,只要调用了saveMessages方法(这是前提),他只会将信息保存在固定的常量key中。
这时前台的hello.jsp页面的显示代码为:

1 <html:messages id="a" message="true">
2     <bean:write name="a"/>
3 </html:messages>

上面代码设置了message属性,表示从Globals.MESSAGE_KEY中获取信息,前面也有提到,此时指定name属性是无效的。

那如果我想只显示我自己指定的信息怎么办呢?

我们可以不使用saveMessages方法而使用最原始的办法,通常最原始的办法也是最有效的,Struts其实是封装了许多最原始的实现。我们先将action中的代码改为:

ActionMessages messages  =   new  ActionMessages();
        
messages.add(
"" new  ActionMessage( " haha " , false ));
        
request.setAttribute(
" show " , messages);

return   new  ActionForward( " /form/hello.jsp " );

然后在JSP页面中指定name属性,而将message设为false就可以了:

1 <html:messages id="a" name="show">
2     <bean:write name="a"/>
3 </html:messages>

这里是直接省略了message属性,因为他的缺省值就是false。这样就可以达到输出自己指定属性的信息啦!




 


评论

# re: ActionMessages类及其绑定的组件  回复  更多评论   

2007-05-22 17:40 by cqusoft
good!

# re: ActionMessages类及其绑定的组件  回复  更多评论   

2007-06-11 01:34 by samalanqi
request.setAttribute( " show " , messages);为什么不行呢??

# re: ActionMessages类及其绑定的组件[未登录]  回复  更多评论   

2007-07-04 16:17 by aa
不行。。。

# re: ActionMessages类及其绑定的组件  回复  更多评论   

2007-09-17 21:41 by ee
perfect

只有注册用户登录后才能发表评论。


网站导航: