深入探讨struts的ActionMessages消息机.doc

在介绍ActionMessages前,我觉得有必要先介绍一下ActionMessages的数据结构.理解了其数据结构有助于理解相关的各种操作. ActionMessages以一个HashMap存储ActionMessage.Map中的key是一个标识,其对应的value是一个List对象,所有的ActionMessage存储在List中.也就是说key标识了一组ActionMessage. 先介绍涉及到的类中的几个常用方法,然后给出几个示例代码,帮助理解. ActionMessage ActionMessage(String key) 该方法接受一个字符串,字符串是在资源文件种配置的key值,必须在配置文件中进行相关配置. ActionMessage(String key,Object value) ActionMessage(String key,Object value0,Object value1) ActionMessage(String key,Object value0,Object value1,Object value2) ActionMessage(String key,Object value0,Object value1,Object value2,Object value3) 上面4个方法第一个参数同样是资源文件中配置的key值,同样必须在配置文件中进行相关配置.后面的参数为资源文件中key所对应的信息中需要的参数 ActionMessage(String key,Object[] values) 这种方法第一个参数同上,第二个参数接受一个Object数组,其中保存key在资源文件中对应信息需要的参数. 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中. Action及其所有子类 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) saveMessages(HttpServletRequest request,ActionMessages messages) 该方法保存messages时,如果request中已经有一个ActionMessages对象,则用新的覆盖原有的.不推荐使用该方法,该方法容易发生丢失信息的情况. addErrors()和saveErrors() 这两个方法与addMessages()和saveMessages()相似,不过在 HttpServletRequest.setAttribute()时的参数不一样,这两个方法 是:setAttribute(Globals.ERROR_KEY,messages)添加的.(Globals.ERROR_KEY = org.apache.struts.action.ERROR) 在request中添加的ActionMessages在页面显示时,用html:messages标签进行显示,下面介绍一下该标签和经常配套使用的logic:messagePresent标签. html:messages id? 必须指定id属性.html:messages标签作用是遍历ActionMes