org.apache.commons.scaffold.util
Interface Messages

All Known Implementing Classes:

MessagesImpl

public interface Messages

A class that encapsulates messages. Messages 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.

Version:

$Revision: 1.3 $ $Date: 2004/03/21 21:10:10 $

Field Summary

static java.lang.String

GLOBAL_MESSAGE_KEY

Method Summary

void	add(Message message) Add a message to the set of messages for the "global" property.
void	add(Messages messages) Adds the messages from the given Messages object to this set of messages.
void	add(java.lang.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.
boolean	empty() Deprecated. Use isEmpty instead.
java.util.Iterator	get() Return the set of all recorded messages, without distinction by which property the messages are associated with.
java.util.Iterator	get(java.lang.String property) Return the set of messages related to a specific property.
boolean	isEmpty() Return true if there are no messages recorded in this collection, or false otherwise.
java.util.Iterator	properties() Return the set of property names for which at least one message has been recorded.
int	size() Return the number of messages recorded for all properties (including global messages).
int	size(java.lang.String property) Return the number of messages associated with the specified property.

Field Detail

GLOBAL_MESSAGE_KEY

public static final java.lang.String GLOBAL_MESSAGE_KEY

See Also:

Constant Field Values

Method Detail

add

public void add(java.lang.String property,
                Message message)

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.

Parameters:

property - Property name (or Messages.GLOBAL_MESSAGE_KEY)

message - The message to be added

add

public void add(Message message)

Add a message to the set of messages for the "global" property. An order of the property/key is maintained based on the initial addition of the property/key.

Parameters:

message - The message to be added

add

public void add(Messages messages)

Adds the messages from the given Messages 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 Messages 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.

Parameters:

messages - The Messages object to be added.

clear

public void clear()

Clear all messages recorded by this object.

empty

public boolean empty()

Deprecated. Use isEmpty instead.

Return true if there are no messages recorded in this collection, or false otherwise.

isEmpty

public boolean isEmpty()

Return true if there are no messages recorded in this collection, or false otherwise.

get

public java.util.Iterator get()

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.

get

public java.util.Iterator get(java.lang.String property)

Return the set of messages related to a specific property. If there are no such messages, an empty enumeration is returned.

Parameters:

property - Property name (or ActionMessages.GLOBAL_MESSAGE_KEY)

properties

public java.util.Iterator properties()

Return the set of property names for which at least one message has been recorded. If there are no messages, an empty Iterator is returned. If you have recorded global messages, the String value of Messages.GLOBAL_MESSAGE will be one of the returned property names.

size

public int size()

Return the number of messages recorded for all properties (including global messages). NOTE - it is more efficient to call empty() if all you care about is whether or not there are any messages at all.

size

public int size(java.lang.String property)

Return the number of messages associated with the specified property.

Parameters:

property - Property name (or Messages.GLOBAL_MESSAGE_KEY