org.kuali.rice.krad.util
Class MessageMap

java.lang.Object
  org.kuali.rice.krad.util.MessageMap

All Implemented Interfaces:

Serializable

public class MessageMap
extends Object
implements Serializable

Holds errors due to validation

Keys of map represent property paths, and value is a AutoPopulatingList that contains resource string keys (to retrieve the error message).

Note, prior to rice 0.9.4, this class implemented Map. The implements has been removed as of rice 0.9.4

Author:

Kuali Rice Team (rice.collab@kuali.org)

See Also:

Serialized Form

Constructor Summary

MessageMap()

MessageMap(MessageMap messageMap)

Method Summary

void	addGrowlMessage(String growlTitle, String messageKey) Adds a growl (using the default theme) to the message map with the given title and message
void	addGrowlMessage(String growlTitle, String messageKey, String... messageParameters) Adds a growl (using the default theme) to the message map with the given title and message
void	addGrowlMessage(String growlTitle, String growlTheme, String messageKey) Add a growl using the given styling them with the given title and message
void	addGrowlMessage(String growlTitle, String growlTheme, String messageKey, String... messageParameters) Add a growl using the given styling them with the given title and message
void	addToErrorPath(String parentName) Adds a string prefix to the error path.
protected GrowlMessage	buildGrowl(String growlTitle, String growlTheme, String messageKey, String... messageParameters) Builds a growl message instance from the given parameters
void	clearErrorMessages()
void	clearErrorPath() Clears the errorPath.
boolean	containsKeyMatchingPattern(String pattern)
boolean	containsMessageKey(String messageKey)
int	countFieldMessages(String fieldName) Returns the number of messages for the given field
boolean	doesPropertyHaveError(String key)
boolean	equals(Object o)
boolean	fieldHasMessage(String fieldName, String errorKey) Returns true if the named field has a message with the given errorKey
Set<Map.Entry<String,org.springframework.util.AutoPopulatingList<ErrorMessage>>>	getAllPropertiesAndErrors()
Set<String>	getAllPropertiesWithErrors()
Set<String>	getAllPropertiesWithInfo()
Set<String>	getAllPropertiesWithWarnings()
int	getErrorCount() Counts the total number of error messages in the map
Map<String,org.springframework.util.AutoPopulatingList<ErrorMessage>>	getErrorMessages()
org.springframework.util.AutoPopulatingList<ErrorMessage>	getErrorMessagesForProperty(String propertyName)
List<org.springframework.util.AutoPopulatingList<ErrorMessage>>	getErrorMessagesForProperty(String propertyName, boolean allowWildcard) Gets a list of lists that represent errors that matched by the propertyName passed in (multiple lists because the wildcard can match multiple keys).
List<String>	getErrorPath() This method returns the list that holds the error path values.
List<GrowlMessage>	getGrowlMessages() Returns the list of growl messages (@{link GrowlMessage}) that have been added to the message map
int	getInfoCount() Counts the total number of info messages in the map
Map<String,org.springframework.util.AutoPopulatingList<ErrorMessage>>	getInfoMessages()
org.springframework.util.AutoPopulatingList<ErrorMessage>	getInfoMessagesForProperty(String propertyName)
List<org.springframework.util.AutoPopulatingList<ErrorMessage>>	getInfoMessagesForProperty(String propertyName, boolean allowWildcard) Gets a list of lists that represent info messages that matched by the propertyName passed in (multiple lists because the wildcard can match multiple keys).
String	getKeyPath(String propertyName, boolean prependFullErrorPath) This is what's prepended to the beginning of the key.
org.springframework.util.AutoPopulatingList<ErrorMessage>	getMessages(String path)
int	getNumberOfPropertiesWithErrors()
List<String>	getPropertiesWithErrors()
List<String>	getPropertiesWithInfo()
List<String>	getPropertiesWithWarnings()
int	getWarningCount() Counts the total number of warning messages in the map
Map<String,org.springframework.util.AutoPopulatingList<ErrorMessage>>	getWarningMessages()
org.springframework.util.AutoPopulatingList<ErrorMessage>	getWarningMessagesForProperty(String propertyName)
List<org.springframework.util.AutoPopulatingList<ErrorMessage>>	getWarningMessagesForProperty(String propertyName, boolean allowWildcard) Gets a list of lists that represent warnings that matched by the propertyName passed in (multiple lists because the wildcard can match multiple keys).
boolean	hasErrors()
int	hashCode()
boolean	hasInfo()
boolean	hasMessages()
boolean	hasNoErrors()
boolean	hasNoInfo()
boolean	hasNoMessages()
boolean	hasNoWarnings()
boolean	hasWarnings()
void	merge(Map<String,org.springframework.util.AutoPopulatingList<ErrorMessage>> messagesFrom, Map<String,org.springframework.util.AutoPopulatingList<ErrorMessage>> messagesTo) Takes one message map and merges it into another.
void	merge(MessageMap messageMap)
org.springframework.util.AutoPopulatingList<ErrorMessage>	putError(String propertyName, ErrorMessage message)
org.springframework.util.AutoPopulatingList<ErrorMessage>	putError(String propertyName, String errorKey, String... errorParameters) Adds an error to the map under the given propertyName and adds an array of message parameters
org.springframework.util.AutoPopulatingList<ErrorMessage>	putErrorForSectionId(String sectionId, String errorKey, String... errorParameters) Adds an error related to a particular section identified by its section ID
org.springframework.util.AutoPopulatingList<ErrorMessage>	putErrorWithoutFullErrorPath(String propertyName, String errorKey, String... errorParameters) Adds an error to the map under the given propertyName and adds an array of message parameters.
org.springframework.util.AutoPopulatingList<ErrorMessage>	putInfo(String propertyName, ErrorMessage message)
org.springframework.util.AutoPopulatingList<ErrorMessage>	putInfo(String propertyName, String messageKey, String... messageParameters)
org.springframework.util.AutoPopulatingList<ErrorMessage>	putInfoForSectionId(String sectionId, String messageKey, String... messageParameters)
org.springframework.util.AutoPopulatingList<ErrorMessage>	putInfoWithoutFullErrorPath(String propertyName, String messageKey, String... messageParameters)
org.springframework.util.AutoPopulatingList<ErrorMessage>	putWarning(String propertyName, ErrorMessage message)
org.springframework.util.AutoPopulatingList<ErrorMessage>	putWarning(String propertyName, String messageKey, String... messageParameters)
org.springframework.util.AutoPopulatingList<ErrorMessage>	putWarningForSectionId(String sectionId, String messageKey, String... messageParameters)
org.springframework.util.AutoPopulatingList<ErrorMessage>	putWarningWithoutFullErrorPath(String propertyName, String messageKey, String... messageParameters)
org.springframework.util.AutoPopulatingList<ErrorMessage>	removeAllErrorMessagesForProperty(String property)
org.springframework.util.AutoPopulatingList<ErrorMessage>	removeAllInfoMessagesForProperty(String property)
org.springframework.util.AutoPopulatingList<ErrorMessage>	removeAllWarningMessagesForProperty(String property)
boolean	removeFromErrorPath(String parentName) Removes a string prefix from the error path.
boolean	replaceError(String propertyName, String targetKey, String replaceKey, String... replaceParameters) If any error messages with the key targetKey exist in this ErrorMap for the named property, those ErrorMessages will be replaced with a new ErrorMessage with the given replaceKey and replaceParameters.
boolean	replaceErrorWithoutFullErrorPath(String propertyName, String targetKey, String replaceKey, String... replaceParameters) If any error messages with the key targetKey exist in this ErrorMap for the named property, those ErrorMessages will be replaced with a new ErrorMessage with the given replaceKey and replaceParameters.
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

MessageMap

public MessageMap()

MessageMap

public MessageMap(MessageMap messageMap)

Method Detail

merge

public void merge(MessageMap messageMap)

merge

public void merge(Map<String,org.springframework.util.AutoPopulatingList<ErrorMessage>> messagesFrom,
                  Map<String,org.springframework.util.AutoPopulatingList<ErrorMessage>> messagesTo)

Takes one message map and merges it into another. Makes sure there are no duplicates.

Parameters:

messagesFrom -

messagesTo -

putError

public org.springframework.util.AutoPopulatingList<ErrorMessage> putError(String propertyName,
                                                                          String errorKey,
                                                                          String... errorParameters)

Adds an error to the map under the given propertyName and adds an array of message parameters

This will fully prepend the error key with any value in the errorPath list. This should be used when you do not want to add the error with the prepend pre-built error path.

Parameters:

propertyName - name of the property to add error under

errorKey - resource key used to retrieve the error text from the error message resource bundle

errorParameters - zero or more string parameters for the displayed error message

Returns:

AutoPopulatingList

putWarning

public org.springframework.util.AutoPopulatingList<ErrorMessage> putWarning(String propertyName,
                                                                            String messageKey,
                                                                            String... messageParameters)

putInfo

public org.springframework.util.AutoPopulatingList<ErrorMessage> putInfo(String propertyName,
                                                                         String messageKey,
                                                                         String... messageParameters)

putError

public org.springframework.util.AutoPopulatingList<ErrorMessage> putError(String propertyName,
                                                                          ErrorMessage message)

putWarning

public org.springframework.util.AutoPopulatingList<ErrorMessage> putWarning(String propertyName,
                                                                            ErrorMessage message)

putInfo

public org.springframework.util.AutoPopulatingList<ErrorMessage> putInfo(String propertyName,
                                                                         ErrorMessage message)

putErrorWithoutFullErrorPath

public org.springframework.util.AutoPopulatingList<ErrorMessage> putErrorWithoutFullErrorPath(String propertyName,
                                                                                              String errorKey,
                                                                                              String... errorParameters)

Adds an error to the map under the given propertyName and adds an array of message parameters. This will fully prepend the error key with any value in the errorPath list.

Parameters:

propertyName - name of the property to add error under

errorKey - resource key used to retrieve the error text from the error message resource bundle

errorParameters - zero or more string parameters for the displayed error message

Returns:

AutoPopulatingList

putWarningWithoutFullErrorPath

public org.springframework.util.AutoPopulatingList<ErrorMessage> putWarningWithoutFullErrorPath(String propertyName,
                                                                                                String messageKey,
                                                                                                String... messageParameters)

putInfoWithoutFullErrorPath

public org.springframework.util.AutoPopulatingList<ErrorMessage> putInfoWithoutFullErrorPath(String propertyName,
                                                                                             String messageKey,
                                                                                             String... messageParameters)

putErrorForSectionId

public org.springframework.util.AutoPopulatingList<ErrorMessage> putErrorForSectionId(String sectionId,
                                                                                      String errorKey,
                                                                                      String... errorParameters)

Adds an error related to a particular section identified by its section ID

For maintenance documents, the section ID is identified by calling MaintainableSectionDefinition.getId()

Parameters:

sectionId -

errorKey -

errorParameters -

Returns:

putWarningForSectionId

public org.springframework.util.AutoPopulatingList<ErrorMessage> putWarningForSectionId(String sectionId,
                                                                                        String messageKey,
                                                                                        String... messageParameters)

putInfoForSectionId

public org.springframework.util.AutoPopulatingList<ErrorMessage> putInfoForSectionId(String sectionId,
                                                                                     String messageKey,
                                                                                     String... messageParameters)

addGrowlMessage

public void addGrowlMessage(String growlTitle,
                            String messageKey)

Adds a growl (using the default theme) to the message map with the given title and message

Parameters:

growlTitle - - title for the growl

messageKey - - key for the message in resources, assumed to have no parameters

addGrowlMessage

public void addGrowlMessage(String growlTitle,
                            String messageKey,
                            String... messageParameters)

Adds a growl (using the default theme) to the message map with the given title and message

Parameters:

growlTitle - - title for the growl

messageKey - - key for the message in resources

messageParameters - - parameters for the message

addGrowlMessage

public void addGrowlMessage(String growlTitle,
                            String growlTheme,
                            String messageKey)

Add a growl using the given styling them with the given title and message

Parameters:

growlTitle - - title for the growl

growlTheme - - name of the styling theme to apply

messageKey - - key for the message in resources, assumed to have no parameters

addGrowlMessage

public void addGrowlMessage(String growlTitle,
                            String growlTheme,
                            String messageKey,
                            String... messageParameters)

Add a growl using the given styling them with the given title and message

Parameters:

growlTitle - - title for the growl

growlTheme - - name of the styling theme to apply

messageKey - - key for the message in resources

messageParameters - - parameters for the message

buildGrowl

protected GrowlMessage buildGrowl(String growlTitle,
                                  String growlTheme,
                                  String messageKey,
                                  String... messageParameters)

Builds a growl message instance from the given parameters

Parameters:

growlTitle - - title for growl, exception is thrown if blank

growlTheme - - theme name for growl

messageKey - - key of growl message in resources, exception is thrown if blank

messageParameters - - zero or more parameters for the message

Returns:

GrowlMessage instance populated from parameters

replaceError

public boolean replaceError(String propertyName,
                            String targetKey,
                            String replaceKey,
                            String... replaceParameters)

If any error messages with the key targetKey exist in this ErrorMap for the named property, those ErrorMessages will be replaced with a new ErrorMessage with the given replaceKey and replaceParameters.

Parameters:

propertyName - name of the property where existing error will be replaced

targetKey - error key of message to be replaced

replaceParameters - zero or more string parameters for the replacement error message

Returns:

true if the replacement occurred

replaceErrorWithoutFullErrorPath

public boolean replaceErrorWithoutFullErrorPath(String propertyName,
                                                String targetKey,
                                                String replaceKey,
                                                String... replaceParameters)

If any error messages with the key targetKey exist in this ErrorMap for the named property, those ErrorMessages will be replaced with a new ErrorMessage with the given replaceKey and replaceParameters. The targetKey and replaceKey will be prepended with the current errorPath, if any.

Parameters:

propertyName - name of the property where existing error will be replaced

targetKey - error key of message to be replaced

replaceParameters - zero or more string parameters for the replacement error message

Returns:

true if the replacement occurred

fieldHasMessage

public boolean fieldHasMessage(String fieldName,
                               String errorKey)

Returns true if the named field has a message with the given errorKey

Parameters:

errorKey -

fieldName -

Returns:

boolean

countFieldMessages

public int countFieldMessages(String fieldName)

Returns the number of messages for the given field

Parameters:

fieldName -

Returns:

int

containsMessageKey

public boolean containsMessageKey(String messageKey)

Returns:

true if the given messageKey is associated with some property in this ErrorMap

getErrorCount

public int getErrorCount()

Counts the total number of error messages in the map

Returns:

returns an int for the total number of errors

getWarningCount

public int getWarningCount()

Counts the total number of warning messages in the map

Returns:

returns an int for the total number of warnings

getInfoCount

public int getInfoCount()

Counts the total number of info messages in the map

Returns:

returns an int for the total number of info

getMessages

public org.springframework.util.AutoPopulatingList<ErrorMessage> getMessages(String path)

Parameters:

path -

Returns:

Returns a List of ErrorMessages for the given path

addToErrorPath

public void addToErrorPath(String parentName)

Adds a string prefix to the error path.

Parameters:

parentName -

getErrorPath

public List<String> getErrorPath()

This method returns the list that holds the error path values.

Returns:

List

removeFromErrorPath

public boolean removeFromErrorPath(String parentName)

Removes a string prefix from the error path.

Parameters:

parentName -

Returns:

boolean Returns true if the parentName existed, false otherwise.

clearErrorPath

public void clearErrorPath()

Clears the errorPath.

getKeyPath

public String getKeyPath(String propertyName,
                         boolean prependFullErrorPath)

This is what's prepended to the beginning of the key. This is built by iterating over all of the entries in the errorPath list and concatenating them together witha "."

Parameters:

propertyName -

prependFullErrorPath -

Returns:

String Returns the keyPath.

getPropertiesWithErrors

public List<String> getPropertiesWithErrors()

Returns:

List of the property names that have errors.

getPropertiesWithWarnings

public List<String> getPropertiesWithWarnings()

Returns:

List of the property names that have warnings.

getPropertiesWithInfo

public List<String> getPropertiesWithInfo()

Returns:

List of the property names that have info.

clearErrorMessages

public void clearErrorMessages()

doesPropertyHaveError

public boolean doesPropertyHaveError(String key)

containsKeyMatchingPattern

public boolean containsKeyMatchingPattern(String pattern)

Parameters:

pattern - comma separated list of keys, optionally ending with * wildcard

getAllPropertiesAndErrors

public Set<Map.Entry<String,org.springframework.util.AutoPopulatingList<ErrorMessage>>> getAllPropertiesAndErrors()

getErrorMessagesForProperty

public org.springframework.util.AutoPopulatingList<ErrorMessage> getErrorMessagesForProperty(String propertyName)

getWarningMessagesForProperty

public org.springframework.util.AutoPopulatingList<ErrorMessage> getWarningMessagesForProperty(String propertyName)

getInfoMessagesForProperty

public org.springframework.util.AutoPopulatingList<ErrorMessage> getInfoMessagesForProperty(String propertyName)

getErrorMessagesForProperty

public List<org.springframework.util.AutoPopulatingList<ErrorMessage>> getErrorMessagesForProperty(String propertyName,
                                                                                                   boolean allowWildcard)

Gets a list of lists that represent errors that matched by the propertyName passed in (multiple lists because the wildcard can match multiple keys). If wildcard is true, the propertyName ends with a wildcard character. Otherwise, it will only match on the single key and return a list with one list

Parameters:

propertyName -

allowWildcard -

Returns:

getWarningMessagesForProperty

public List<org.springframework.util.AutoPopulatingList<ErrorMessage>> getWarningMessagesForProperty(String propertyName,
                                                                                                     boolean allowWildcard)

Gets a list of lists that represent warnings that matched by the propertyName passed in (multiple lists because the wildcard can match multiple keys). If wildcard is true, the propertyName ends with a wildcard character. Otherwise, it will only match on the single key and return a list with one list.

Parameters:

propertyName -

allowWildcard -

Returns:

getInfoMessagesForProperty

public List<org.springframework.util.AutoPopulatingList<ErrorMessage>> getInfoMessagesForProperty(String propertyName,
                                                                                                  boolean allowWildcard)

Gets a list of lists that represent info messages that matched by the propertyName passed in (multiple lists because the wildcard can match multiple keys). If wildcard is true, the propertyName ends with a wildcard character. If it is false, it will only match on the single key and return a list with one list.

Parameters:

propertyName -

allowWildcard -

Returns:

hasErrors

public boolean hasErrors()

hasNoErrors

public boolean hasNoErrors()

hasWarnings

public boolean hasWarnings()

hasNoWarnings

public boolean hasNoWarnings()

hasInfo

public boolean hasInfo()

hasNoInfo

public boolean hasNoInfo()

hasMessages

public boolean hasMessages()

hasNoMessages

public boolean hasNoMessages()

getAllPropertiesWithErrors

public Set<String> getAllPropertiesWithErrors()

getAllPropertiesWithWarnings

public Set<String> getAllPropertiesWithWarnings()

getAllPropertiesWithInfo

public Set<String> getAllPropertiesWithInfo()

removeAllErrorMessagesForProperty

public org.springframework.util.AutoPopulatingList<ErrorMessage> removeAllErrorMessagesForProperty(String property)

removeAllWarningMessagesForProperty

public org.springframework.util.AutoPopulatingList<ErrorMessage> removeAllWarningMessagesForProperty(String property)

removeAllInfoMessagesForProperty

public org.springframework.util.AutoPopulatingList<ErrorMessage> removeAllInfoMessagesForProperty(String property)

getNumberOfPropertiesWithErrors

public int getNumberOfPropertiesWithErrors()

getErrorMessages

public Map<String,org.springframework.util.AutoPopulatingList<ErrorMessage>> getErrorMessages()

getWarningMessages

public Map<String,org.springframework.util.AutoPopulatingList<ErrorMessage>> getWarningMessages()

getInfoMessages

public Map<String,org.springframework.util.AutoPopulatingList<ErrorMessage>> getInfoMessages()

getGrowlMessages

public List<GrowlMessage> getGrowlMessages()

Returns the list of growl messages (@{link GrowlMessage}) that have been added to the message map

Returns:

List

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object