com.atlassian.jira.util
Interface MessageSet

All Known Implementing Classes:
AbstractMessageSet, ListOrderedMessageSetImpl, MessageSetImpl

@PublicApi
public interface MessageSet

Used to communicate error and warning messages.

Since:
v3.13

Nested Class Summary
static class MessageSet.Level
          Message levels
static class MessageSet.MessageLink
          A simple class for holding link text and a link url.
 
Method Summary
 void addErrorMessage(String errorMessage)
          Adds an error message.
 void addErrorMessage(String errorMessage, MessageSet.MessageLink link)
          Adds an error message and associates a link with the error.
 void addErrorMessageInEnglish(String errorMessage)
          Adds an error message in English.
 void addMessage(MessageSet.Level level, String errorMessage)
          Adds a message with the given warning / error level
 void addMessage(MessageSet.Level level, String errorMessage, MessageSet.MessageLink link)
          Adds an error message with the given warning / error level and associates a link with the error.
 void addMessageSet(MessageSet messageSet)
          Will concatenate this message set with the provided message set.
 void addWarningMessage(String warningMessage)
          Adds a warning message.
 void addWarningMessage(String warningMessage, MessageSet.MessageLink link)
          Adds a warning message and associates a link with the warning.
 void addWarningMessageInEnglish(String warningMessage)
          Adds a warning message in English.
 Set<String> getErrorMessages()
           
 Set<String> getErrorMessagesInEnglish()
          Returns a unique set of all the English error messages.
 MessageSet.MessageLink getLinkForError(String errorMsg)
           
 MessageSet.MessageLink getLinkForWarning(String warningMsg)
           
 Set<String> getWarningMessages()
           
 Set<String> getWarningMessagesInEnglish()
          Returns a unique set of all the English warning messages.
 boolean hasAnyErrors()
          Returns true if there are error messages, false otherwise.
 boolean hasAnyMessages()
          Returns true if there are messages of any type, false otherwise.
 boolean hasAnyWarnings()
          Returns true if there are warning messages, false otherwise.
 

Method Detail

getErrorMessages

Set<String> getErrorMessages()
Returns:
a unique set of error messages, these messages are separate from the warning messages, never null.

getLinkForError

MessageSet.MessageLink getLinkForError(String errorMsg)
Parameters:
errorMsg - the unique error message
Returns:
the MessageLink that is associated with the error, if one exists, null otherwise.

getErrorMessagesInEnglish

Set<String> getErrorMessagesInEnglish()
Returns a unique set of all the English error messages.

Returns:
a unique set of all the English error messages.
See Also:
addErrorMessageInEnglish(String)

getWarningMessages

Set<String> getWarningMessages()
Returns:
a unique set of warning messages, these messages are separate from the error messages, never null.

getLinkForWarning

MessageSet.MessageLink getLinkForWarning(String warningMsg)
Parameters:
warningMsg - the unique warning message
Returns:
the MessageLink that is associated with the warning, if one exists, null otherwise.

getWarningMessagesInEnglish

Set<String> getWarningMessagesInEnglish()
Returns a unique set of all the English warning messages.

Returns:
a unique set of all the English warning messages.
See Also:
addWarningMessageInEnglish(String)

hasAnyErrors

boolean hasAnyErrors()
Returns true if there are error messages, false otherwise.

Returns:
true if there are error messages, false otherwise.

hasAnyWarnings

boolean hasAnyWarnings()
Returns true if there are warning messages, false otherwise.

Returns:
true if there are warning messages, false otherwise.

hasAnyMessages

boolean hasAnyMessages()
Returns true if there are messages of any type, false otherwise. That is, it will return true if hasAnyErrors() is true or hasAnyWarnings() is true.

Returns:
true if there are messages of any type, false otherwise.

addMessageSet

void addMessageSet(MessageSet messageSet)
Will concatenate this message set with the provided message set. All new errors and warnings will be added to the existing errors and warnings.

Parameters:
messageSet - contains the new errors and warnings to add to this set.

addMessage

void addMessage(MessageSet.Level level,
                String errorMessage)
Adds a message with the given warning / error level

Parameters:
level - message level
errorMessage - the message to add.

addMessage

void addMessage(MessageSet.Level level,
                String errorMessage,
                MessageSet.MessageLink link)
Adds an error message with the given warning / error level and associates a link with the error.

Parameters:
level - message level
errorMessage - the message to add.
link - the link to show the users associated with this error.

addErrorMessage

void addErrorMessage(String errorMessage)
Adds an error message.

Parameters:
errorMessage - the message to add.

addErrorMessage

void addErrorMessage(String errorMessage,
                     MessageSet.MessageLink link)
Adds an error message and associates a link with the error.

Parameters:
errorMessage - the message to add.
link - the link to show the users associated with this error.

addErrorMessageInEnglish

void addErrorMessageInEnglish(String errorMessage)
Adds an error message in English.

This is useful when the addErrorMessage(String) method is used to add translated messages, and you want to be able to get a set of the messages in English as well. Eg, in the Project Import we show the translated messages on screen during validation, and log the English versions in case Atlassian Support needs to read the logs later.

Parameters:
errorMessage - the message to add.
See Also:
addErrorMessage(String), addWarningMessageInEnglish(String)

addWarningMessage

void addWarningMessage(String warningMessage)
Adds a warning message.

Parameters:
warningMessage - the message to add.

addWarningMessage

void addWarningMessage(String warningMessage,
                       MessageSet.MessageLink link)
Adds a warning message and associates a link with the warning.

Parameters:
warningMessage - the message to add.
link - the link to show the users associated with this warning.

addWarningMessageInEnglish

void addWarningMessageInEnglish(String warningMessage)
Adds a warning message in English.

This is useful when the addWarningMessage(String) method is used to add translated messages, and you want to be able to get a set of the messages in English as well. Eg, in the Project Import we show the translated messages on screen during validation, and log the English versions in case Atlassian Support needs to read the logs later.

Parameters:
warningMessage - the message to add.
See Also:
addWarningMessage(String), addErrorMessageInEnglish(String)


Copyright © 2002-2013 Atlassian. All Rights Reserved.