org.apache.wicket.feedback
Class FeedbackMessages

java.lang.Object
  org.apache.wicket.feedback.FeedbackMessages

All Implemented Interfaces:

java.io.Serializable, java.lang.Iterable<FeedbackMessage>, IClusterable

public final class FeedbackMessages
extends java.lang.Object
implements IClusterable, java.lang.Iterable<FeedbackMessage>

Holds list of feedback messages. The list can be added to, cleared, queried and filtered.

WARNING: This class should typically NOT be used directly.

Author:

Eelco Hillenius, Jonathan Locke

See Also:

Serialized Form

Constructor Summary

FeedbackMessages()
Construct.

Method Summary

void	add(Component reporter, java.io.Serializable message, int level) Adds a message
void	add(FeedbackMessage message) Adds a message.
int	clear() Clears any existing messages.
int	clear(IFeedbackMessageFilter filter) Clears all messages that are accepted by the filter.
void	debug(Component reporter, java.io.Serializable message) Adds a new ui message with level DEBUG to the current messages.
void	error(Component reporter, java.io.Serializable message) Adds a new ui message with level ERROR to the current messages.
void	fatal(Component reporter, java.io.Serializable message) Adds a new ui message with level FATAL to the current messages.
boolean	hasErrorMessageFor(Component component) Convenience method that looks up whether the given component registered a message with this list with the level ERROR.
boolean	hasMessage(IFeedbackMessageFilter filter)
boolean	hasMessageFor(Component component) Looks up whether the given component registered a message with this list.
boolean	hasMessageFor(Component component, int level) Looks up whether the given component registered a message with this list with the given level.
void	info(Component reporter, java.io.Serializable message) Adds a new ui message with level INFO to the current messages.
boolean	isEmpty() Gets whether there are no messages.
java.util.Iterator<FeedbackMessage>	iterator() Gets an iterator over stored messages
FeedbackMessage	messageForComponent(Component component) Deprecated. use messagesForComponent(org.apache.wicket.Component) instead
java.util.List<FeedbackMessage>	messages(IFeedbackMessageFilter filter) Gets a list of messages from the page using a filter.
java.util.List<FeedbackMessage>	messagesForComponent(Component component) Looks up the messages for the given component.
int	size() Gets the number of messages
int	size(IFeedbackMessageFilter filter) Gets the number of messages.
void	success(Component reporter, java.io.Serializable message) Adds a new ui message with level SUCCESS to the current messages.
java.lang.String	toString()
void	warn(Component reporter, java.io.Serializable message) Adds a new ui message with level WARNING to the current messages.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

FeedbackMessages

public FeedbackMessages()

Construct.

Method Detail

add

public final void add(FeedbackMessage message)

Adds a message.

Parameters:

message - the message

add

public final void add(Component reporter,
                      java.io.Serializable message,
                      int level)

Adds a message

Parameters:

reporter -

message -

level -

debug

public final void debug(Component reporter,
                        java.io.Serializable message)

Adds a new ui message with level DEBUG to the current messages.

Parameters:

reporter - the reporting component

message - the actual message

info

public final void info(Component reporter,
                       java.io.Serializable message)

Adds a new ui message with level INFO to the current messages.

Parameters:

reporter - The reporting component

message - The actual message

success

public final void success(Component reporter,
                          java.io.Serializable message)

Adds a new ui message with level SUCCESS to the current messages.

Parameters:

reporter - The reporting component

message - The actual message

warn

public final void warn(Component reporter,
                       java.io.Serializable message)

Adds a new ui message with level WARNING to the current messages.

Parameters:

reporter - the reporting component

message - the actual message

error

public final void error(Component reporter,
                        java.io.Serializable message)

Adds a new ui message with level ERROR to the current messages.

Parameters:

reporter - the reporting component

message - the actual message

fatal

public final void fatal(Component reporter,
                        java.io.Serializable message)

Adds a new ui message with level FATAL to the current messages.

Parameters:

reporter - the reporting component

message - the actual message

clear

public final int clear()

Clears any existing messages.

Returns:

The number of messages deleted

clear

public final int clear(IFeedbackMessageFilter filter)

Clears all messages that are accepted by the filter.

Parameters:

filter - Filter for selecting messages. If null, all messages will be returned

Returns:

The number of messages deleted

hasMessage

public final boolean hasMessage(IFeedbackMessageFilter filter)

Parameters:

filter - Filter for selecting messages

Returns:

True if one or more messages matches the filter

hasMessageFor

public final boolean hasMessageFor(Component component)

Looks up whether the given component registered a message with this list.

Parameters:

component - the component to look up whether it registered a message

Returns:

whether the given component registered a message with this list

hasMessageFor

public final boolean hasMessageFor(Component component,
                                   int level)

Looks up whether the given component registered a message with this list with the given level.

Parameters:

component - The component to look up whether it registered a message

level - The level of the message

Returns:

Whether the given component registered a message with this list with the given level

hasErrorMessageFor

public final boolean hasErrorMessageFor(Component component)

Convenience method that looks up whether the given component registered a message with this list with the level ERROR.

Parameters:

component - the component to look up whether it registered a message

Returns:

whether the given component registered a message with this list with level ERROR

iterator

public final java.util.Iterator<FeedbackMessage> iterator()

Gets an iterator over stored messages

Specified by:

iterator in interface java.lang.Iterable<FeedbackMessage>

Returns:

iterator over stored messages

messages

public final java.util.List<FeedbackMessage> messages(IFeedbackMessageFilter filter)

Gets a list of messages from the page using a filter.

Parameters:

filter - Filter for selecting messages. If null, all messages will be returned

Returns:

The messages or an empty list if no messages are found

messageForComponent

public final FeedbackMessage messageForComponent(Component component)

Deprecated. use messagesForComponent(org.apache.wicket.Component) instead

Looks up a single message for the given component.

Parameters:

component - the component to look up the message for

Returns:

the message that is found for the given component (first match) or null if none was found

messagesForComponent

public final java.util.List<FeedbackMessage> messagesForComponent(Component component)

Looks up the messages for the given component.

Parameters:

component - the component to look up the message for

Returns:

the messages that were found for the given component

isEmpty

public final boolean isEmpty()

Gets whether there are no messages.

Returns:

True when there are no messages

size

public final int size()

Gets the number of messages

Returns:

the number of messages

size

public final int size(IFeedbackMessageFilter filter)

Gets the number of messages.

Parameters:

filter - Filter for counting messages. If null, the count of all messages will be returned

Returns:

the number of messages

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

See Also:

Object.toString()