actionmessages.html

struts api,学习使用struts必备的文档

<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=1><FONT SIZE="+2">
<B>Field Detail</B></FONT></TD>
</TR>
</TABLE>

<A NAME="actionItemComparator"><!-- --></A><H3>
actionItemComparator</H3>
<PRE>
private static final java.util.Comparator <B>actionItemComparator</B></PRE>
<DL>
<DD><p>Compares ActionMessageItem objects.</p></DL>
<HR>

<A NAME="GLOBAL_MESSAGE"><!-- --></A><H3>
GLOBAL_MESSAGE</H3>
<PRE>
public static final java.lang.String <B>GLOBAL_MESSAGE</B></PRE>
<DL>
<DD><p>The "property name" marker to use for global messages, as opposed to
 those related to a specific property.</p></DL>
<HR>

<A NAME="accessed"><!-- --></A><H3>
accessed</H3>
<PRE>
protected boolean <B>accessed</B></PRE>
<DL>
<DD><p>Have the messages been retrieved from this object?</p>

 <p>The controller uses this property to determine if session-scoped
 messages can be removed.</p><DD><DL>
<DT><B>Since: </B><DD>Struts 1.2</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="messages"><!-- --></A><H3>
messages</H3>
<PRE>
protected java.util.HashMap <B>messages</B></PRE>
<DL>
<DD><p>The accumulated set of <code>ActionMessage</code> objects (represented
 as an ArrayList) for each property, keyed by property name.</p></DL>
<HR>

<A NAME="iCount"><!-- --></A><H3>
iCount</H3>
<PRE>
protected int <B>iCount</B></PRE>
<DL>
<DD><p>The current number of the property/key being added. This is used
 to maintain the order messages are added.</p></DL>

<!-- ========= CONSTRUCTOR DETAIL ======== -->

<A NAME="constructor_detail"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=1><FONT SIZE="+2">
<B>Constructor Detail</B></FONT></TD>
</TR>
</TABLE>

<A NAME="ActionMessages()"><!-- --></A><H3>
ActionMessages</H3>
<PRE>
public <B>ActionMessages</B>()</PRE>
<DL>
<DD><p>Create an empty <code>ActionMessages</code> object.</p></DL>
<HR>

<A NAME="ActionMessages(org.apache.struts.action.ActionMessages)"><!-- --></A><H3>
ActionMessages</H3>
<PRE>
public <B>ActionMessages</B>(<A HREF="../../../../org/apache/struts/action/ActionMessages.html">ActionMessages</A>&nbsp;messages)</PRE>
<DL>
<DD><p>Create an <code>ActionMessages</code> object initialized with the given
 messages.</p><DD><DL>
<DT><B>Parameters:</B><DD><CODE>messages</CODE> - The messages to be initially added to this object.
 This parameter can be <code>null</code>.<DT><B>Since: </B><DD>Struts 1.1</DD>
</DL>
</DD>
</DL>

<!-- ============ METHOD DETAIL ========== -->

<A NAME="method_detail"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=1><FONT SIZE="+2">
<B>Method Detail</B></FONT></TD>
</TR>
</TABLE>

<A NAME="add(java.lang.String, org.apache.struts.action.ActionMessage)"><!-- --></A><H3>
add</H3>
<PRE>
public void <B>add</B>(java.lang.String&nbsp;property,
                <A HREF="../../../../org/apache/struts/action/ActionMessage.html">ActionMessage</A>&nbsp;message)</PRE>
<DL>
<DD><p>Add a message to the set of messages for the specified property. An
 order of the property/key is maintained based on the initial addition
 of the property/key.</p><DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>property</CODE> - Property name (or ActionMessages.GLOBAL_MESSAGE)<DD><CODE>message</CODE> - The message to be added</DL>
</DD>
</DL>
<HR>

<A NAME="add(org.apache.struts.action.ActionMessages)"><!-- --></A><H3>
add</H3>
<PRE>
public void <B>add</B>(<A HREF="../../../../org/apache/struts/action/ActionMessages.html">ActionMessages</A>&nbsp;messages)</PRE>
<DL>
<DD><p>Adds the messages from the given <code>ActionMessages</code> object to
 this set of messages. The messages are added in the order they are returned from
 the <code>properties</code> method. If a message's property is already in the current
 <code>ActionMessages</code> object, it is added to the end of the list for that
 property. If a message's property is not in the current list it is added to the end
 of the properties.</p><DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>messages</CODE> - The <code>ActionMessages</code> object to be added.  
 This parameter can be <code>null</code>.<DT><B>Since: </B><DD>Struts 1.1</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="clear()"><!-- --></A><H3>
clear</H3>
<PRE>
public void <B>clear</B>()</PRE>
<DL>
<DD><p>Clear all messages recorded by this object.</p><DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="isEmpty()"><!-- --></A><H3>
isEmpty</H3>
<PRE>
public boolean <B>isEmpty</B>()</PRE>
<DL>
<DD><p>Return <code>true</code> if there are no messages recorded
 in this collection, or <code>false</code> otherwise.</p><DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Since: </B><DD>Struts 1.1</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="get()"><!-- --></A><H3>
get</H3>
<PRE>
public java.util.Iterator <B>get</B>()</PRE>
<DL>
<DD><p>Return the set of all recorded messages, without distinction
 by which property the messages are associated with. If there are
 no messages recorded, an empty enumeration is returned.</p><DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="get(java.lang.String)"><!-- --></A><H3>
get</H3>
<PRE>
public java.util.Iterator <B>get</B>(java.lang.String&nbsp;property)</PRE>
<DL>
<DD><p>Return the set of messages related to a specific property.
 If there are no such messages, an empty enumeration is returned.</p><DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>property</CODE> - Property name (or ActionMessages.GLOBAL_MESSAGE)</DL>
</DD>
</DL>
<HR>

<A NAME="isAccessed()"><!-- --></A><H3>
isAccessed</H3>
<PRE>
public boolean <B>isAccessed</B>()</PRE>
<DL>
<DD><p>Returns <code>true</code> if the <code>get()</code> or
 <code>get(String)</code> methods are called.</p><DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD><code>true</code> if the messages have been accessed one or more
 times.<DT><B>Since: </B><DD>Struts 1.2</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="properties()"><!-- --></A><H3>
properties</H3>
<PRE>
public java.util.Iterator <B>properties</B>()</PRE>
<DL>
<DD><p>Return the set of property names for which at least one message has
 been recorded. If there are no messages, an empty <code>Iterator</code> is returned.
 If you have recorded global messages, the <code>String</code> value of
 <code>ActionMessages.GLOBAL_MESSAGE</code> will be one of the returned
 property names.</p><DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="size()"><!-- --></A><H3>
size</H3>
<PRE>
public int <B>size</B>()</PRE>
<DL>
<DD><p>Return the number of messages recorded for all properties (including
 global messages). <strong>NOTE</strong> - it is more efficient to call
 <code>isEmpty</code> if all you care about is whether or not there are
 any messages at all.</p><DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="size(java.lang.String)"><!-- --></A><H3>
size</H3>
<PRE>
public int <B>size</B>(java.lang.String&nbsp;property)</PRE>
<DL>
<DD><p>Return the number of messages associated with the specified property.</p><DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>property</CODE> - Property name (or ActionMessages.GLOBAL_MESSAGE)</DL>
</DD>
</DL>
<HR>

<A NAME="toString()"><!-- --></A><H3>
toString</H3>
<PRE>
public java.lang.String <B>toString</B>()</PRE>
<DL>
<DD><p>Returns a String representation of this ActionMessages'
 property name=message list mapping.</p><DD><DL>
<DT><B>Overrides:</B><DD><CODE>toString</CODE> in class <CODE>java.lang.Object</CODE></DL>
</DD>
<DD><DL>
<DT><B>See Also: </B><DD><CODE>Object.toString()</CODE></DL>
</DD>
</DL>
<!-- ========= END OF CLASS DATA ========= -->
<HR>

<!-- ========== START OF NAVBAR ========== -->
<A NAME="navbar_bottom"><!-- --></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
<TR>
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_bottom_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
  <TR ALIGN="center" VALIGN="top">
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/ActionMessages.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
  </TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>

<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
&nbsp;<A HREF="../../../../org/apache/struts/action/ActionMessage.html"><B>PREV CLASS</B></A>&nbsp;
&nbsp;<A HREF="../../../../org/apache/struts/action/ActionMessages.ActionMessageItem.html"><B>NEXT CLASS</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  <A HREF="../../../../index.html" TARGET="_top"><B>FRAMES</B></A>  &nbsp;
&nbsp;<A HREF="ActionMessages.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  SUMMARY: &nbsp;<A HREF="#inner_class_summary">INNER</A>&nbsp;|&nbsp;<A HREF="#field_summary">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL: &nbsp;<A HREF="#field_detail">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
</TR>
</TABLE>
<!-- =========== END OF NAVBAR =========== -->

<HR>
Copyright