ActionMessages,用法,(转)

 

ActionMessages,用法,(转)

2007-08-12 22:10

在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组件会对其进行访问和操作：

标签

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

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

1 <html:errors property="name" bundle="en"/> 
这时候将会输出key="en"的资源文件中的"kong"对应的信息：bu neng wei kong

标签

标签是用来在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集合中单个对象的标识，他和的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。这样就可以达到输出自己指定属性的信息啦！

参考资料：http://hi.baidu.com/hibydu/blog/item/6569bb3d72ae1102bba16747.html