|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface MessageList
A class that encapsulates messages. MessageList can be either global or they are specific to a particular bean property.
Each individual message is described by an Message
object, which contains a message key (to be looked up in an appropriate
message resources database), and up to four placeholder arguments used for
parametric substitution in the resulting message.
IMPLEMENTATION NOTE - It is assumed that these objects are created and manipulated only within the context of a single thread. Therefore, no synchronization is required for access to internal collections.
Orginally based on org.apache.struts.action.ActionMessages, Revision 49670.
Field Summary | |
---|---|
static String |
GLOBAL_MESSAGE_KEY
A default key to represent "global" messages that do not pertain to a particular property. |
Method Summary | |
---|---|
void |
add(Message message)
Add a message to the set of messages for the "global" property. |
void |
add(MessageList messages)
Adds the messages from the given MessageList object to
this set of messages. |
void |
add(String property,
Message message)
Add a message to the set of messages for the specified property. |
void |
clear()
Clear all messages recorded by this object. |
Iterator |
get()
Return the set of all recorded messages, without distinction by which property the messages are associated with. |
Iterator |
get(String property)
Return the set of messages related to a specific property. |
String |
getGlobalMessageKey()
|
boolean |
isAccessed()
Determines if the MessageList's messages have been accessed one or more times. |
boolean |
isEmpty()
|
Iterator |
properties()
Return the set of property names for which at least one message has been recorded. |
void |
setGlobalMessageKey(String globalMessageKey)
|
int |
size()
Return the number of messages recorded for all properties (including global messages). |
int |
size(String property)
Return the number of messages associated with the specified property. |
Field Detail |
---|
static final String GLOBAL_MESSAGE_KEY
Method Detail |
---|
String getGlobalMessageKey()
void setGlobalMessageKey(String globalMessageKey)
globalMessageKey
- The new default global message keyvoid add(String property, Message message)
property
- Property name (or MessageList.GLOBAL_MESSAGE_KEY)message
- The message to be addedvoid add(Message message)
message
- The message to be addedvoid add(MessageList messages)
MessageList
object to
this set of messages. The messages are added in the order they are returned from
the properties() method. If a message's property is already in the current
MessageList
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.
messages
- The MessageList
object to be added.void clear()
boolean isAccessed()
true
if the get()
or
get(String)
methods are called.
true
if the messages have been accessed one or more
times.boolean isEmpty()
true
if there are no messages recorded
in this collection, or false
otherwise.Iterator get()
Iterator get(String property)
property
- Property name
Iterator properties()
MessageList.GLOBAL_MESSAGE
will be one of the returned
property names.
int size()
isEmpty()
if all you care about is whether or not there are
any messages at all.
int size(String property)
property
- Property name (or MessageList.GLOBAL_MESSAGE_KEY
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |