com.haulmont.cuba.core.sys

Class AbstractMessages

java.lang.Object

com.haulmont.cuba.core.sys.AbstractMessages

All Implemented Interfaces:

Messages

Direct Known Subclasses:

MessagesClientImpl, MessagesImpl

public abstract class AbstractMessages
extends java.lang.Object
implements Messages

Messages implementation common for all tiers.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	BUNDLE_NAME
static java.lang.String	EXT

Fields inherited from interface com.haulmont.cuba.core.global.Messages

NAME

Constructor Summary

Constructors

Constructor and Description
AbstractMessages()

Method Summary

Modifier and Type	Method and Description
void	clearCache()
java.lang.String	findMessage(java.lang.String packs, java.lang.String key, java.util.Locale locale) Returns localized message or null if not found.
java.lang.String	formatMainMessage(java.lang.String key, java.lang.Object... params) Get localized message from main message pack and use it as a format string for parameters provided. Locale is determined by the current user session.
java.lang.String	formatMessage(java.lang.Class caller, java.lang.String key, java.util.Locale locale, java.lang.Object... params) Get localized message and use it as a format string for parameters provided
java.lang.String	formatMessage(java.lang.Class caller, java.lang.String key, java.lang.Object... params) Get localized message and use it as a format string for parameters provided. Locale is determined by the current user session.
java.lang.String	formatMessage(java.lang.String pack, java.lang.String key, java.util.Locale locale, java.lang.Object... params) Get localized message and use it as a format string for parameters provided
java.lang.String	formatMessage(java.lang.String pack, java.lang.String key, java.lang.Object... params) Get localized message and use it as a format string for parameters provided. Locale is determined by the current user session.
int	getCacheSize()
java.lang.String	getMainMessage(java.lang.String key) Returns localized message using main message pack. Locale is determined by the current user session.
java.lang.String	getMainMessage(java.lang.String key, java.util.Locale locale) Returns localized message
java.lang.String	getMainMessagePack()
java.lang.String	getMessage(java.lang.Class caller, java.lang.String key) Returns localized message. Locale is determined by the current user session.
java.lang.String	getMessage(java.lang.Class caller, java.lang.String key, java.util.Locale locale) Returns localized message
java.lang.String	getMessage(java.lang.Enum caller) Returns localized message. Locale is determined by the current user session.
java.lang.String	getMessage(java.lang.Enum caller, java.util.Locale locale) Returns localized message
java.lang.String	getMessage(java.lang.String pack, java.lang.String key) Returns localized message. Locale is determined by the current user session.
java.lang.String	getMessage(java.lang.String packs, java.lang.String key, java.util.Locale locale) Returns localized message
MessageTools	getTools() Convenient access to MessageTools bean.
void	setConfiguration(Configuration configuration)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

BUNDLE_NAME

public static final java.lang.String BUNDLE_NAME

See Also:

Constant Field Values

EXT

public static final java.lang.String EXT

See Also:

Constant Field Values

Constructor Detail

AbstractMessages

public AbstractMessages()

Method Detail

setConfiguration

@Inject
public void setConfiguration(Configuration configuration)

getTools

public MessageTools getTools()

Description copied from interface: Messages

Convenient access to MessageTools bean.

Specified by:

getTools in interface Messages

Returns:

MessageTools instance

getMainMessagePack

public java.lang.String getMainMessagePack()

Specified by:

getMainMessagePack in interface Messages

Returns:

main message pack for this application tier

getMessage

public java.lang.String getMessage(java.lang.Class caller,
                                   java.lang.String key)

Description copied from interface: Messages

Returns localized message.
Locale is determined by the current user session.

Specified by:

getMessage in interface Messages

Parameters:

caller - class determining the message pack as full package name

key - message key

Returns:

localized message or the key if the message not found

formatMessage

public java.lang.String formatMessage(java.lang.Class caller,
                                      java.lang.String key,
                                      java.lang.Object... params)

Description copied from interface: Messages

Get localized message and use it as a format string for parameters provided.
Locale is determined by the current user session.

Specified by:

formatMessage in interface Messages

Parameters:

caller - class determining the message pack as full package name

key - message key

params - parameter values

Returns:

formatted string or the key in case of IllegalFormatException

getMessage

public java.lang.String getMessage(java.lang.Class caller,
                                   java.lang.String key,
                                   java.util.Locale locale)

Description copied from interface: Messages

Returns localized message

Specified by:

getMessage in interface Messages

Parameters:

caller - class determining the message pack as full package name

key - message key

locale - message locale

Returns:

localized message or the key if the message not found

formatMessage

public java.lang.String formatMessage(java.lang.Class caller,
                                      java.lang.String key,
                                      java.util.Locale locale,
                                      java.lang.Object... params)

Description copied from interface: Messages

Get localized message and use it as a format string for parameters provided

Specified by:

formatMessage in interface Messages

Parameters:

caller - class determining the message pack as full package name

key - message key

locale - message locale

params - parameter values

Returns:

formatted string or the key in case of IllegalFormatException

getMessage

public java.lang.String getMessage(java.lang.Enum caller)

Description copied from interface: Messages

Returns localized message.
Locale is determined by the current user session.

Specified by:

getMessage in interface Messages

Parameters:

caller - enum determining the message pack and key:

• pack - enum's full package name
• key - enum's short class name (after last dot), plus dot, plus enum value

Returns:

localized message or the key if the message not found

getMessage

public java.lang.String getMessage(java.lang.Enum caller,
                                   java.util.Locale locale)

Description copied from interface: Messages

Returns localized message

Specified by:

getMessage in interface Messages

Parameters:

caller - enum determining the message pack and key:

• pack - enum's full package name
• key - enum's short class name (after last dot), plus dot, plus enum value

locale - message locale

Returns:

localized message or the key if the message not found

getMessage

public java.lang.String getMessage(java.lang.String pack,
                                   java.lang.String key)

Description copied from interface: Messages

Returns localized message.
Locale is determined by the current user session.

Specified by:

getMessage in interface Messages

Parameters:

pack - package name to start searching the message. If the key is not found in this package, it will be searched in parent package, and so forth

key - message key

Returns:

localized message or the key if the message not found

getMainMessage

public java.lang.String getMainMessage(java.lang.String key)

Description copied from interface: Messages

Returns localized message using main message pack.
Locale is determined by the current user session.

Specified by:

getMainMessage in interface Messages

Parameters:

key - message key

Returns:

localized message or the key if the message not found

getMainMessage

public java.lang.String getMainMessage(java.lang.String key,
                                       java.util.Locale locale)

Description copied from interface: Messages

Returns localized message

Specified by:

getMainMessage in interface Messages

Parameters:

key - message key

locale - message locale

Returns:

localized message or the key if the message not found

formatMessage

public java.lang.String formatMessage(java.lang.String pack,
                                      java.lang.String key,
                                      java.lang.Object... params)

Description copied from interface: Messages

Get localized message and use it as a format string for parameters provided.
Locale is determined by the current user session.

Specified by:

formatMessage in interface Messages

Parameters:

pack - package name to start searching the message. If the key is not found in this package, it will be searched in parent package, and so forth

key - message key

params - parameter values

Returns:

formatted string or the key in case of IllegalFormatException

formatMainMessage

public java.lang.String formatMainMessage(java.lang.String key,
                                          java.lang.Object... params)

Description copied from interface: Messages

Get localized message from main message pack and use it as a format string for parameters provided.
Locale is determined by the current user session.

Specified by:

formatMainMessage in interface Messages

Parameters:

key - message key

params - parameter values

Returns:

formatted string or the key in case of IllegalFormatException

getMessage

public java.lang.String getMessage(java.lang.String packs,
                                   java.lang.String key,
                                   java.util.Locale locale)

Description copied from interface: Messages

Returns localized message

Specified by:

getMessage in interface Messages

Parameters:

packs - list of whitespace-separated package names. Searching of message is performed in reverse order - starts from last name in the list. Each package is searched for the key, if the key is not found in this package, it is searched in parent package, and so forth

key - message key

locale - message locale

Returns:

localized message or the key if the message not found

findMessage

@Nullable
public java.lang.String findMessage(java.lang.String packs,
                                              java.lang.String key,
                                              @Nullable
                                              java.util.Locale locale)

Description copied from interface: Messages

Returns localized message or null if not found.

Specified by:

findMessage in interface Messages

Parameters:

packs - list of whitespace-separated package names. Searching of message is performed in reverse order - starts from last name in the list. Each package is searched for the key, if the key is not found in this package, it is searched in parent package, and so forth

key - message key

locale - message locale. If null, current user locale is used.

Returns:

localized message or null if the message not found

formatMessage

public java.lang.String formatMessage(java.lang.String pack,
                                      java.lang.String key,
                                      java.util.Locale locale,
                                      java.lang.Object... params)

Description copied from interface: Messages

Get localized message and use it as a format string for parameters provided

Specified by:

formatMessage in interface Messages

Parameters:

pack - package name to start searching the message. If the key is not found in this package, it will be searched in parent package, and so forth

key - message key

locale - message locale

params - parameter values

Returns:

formatted string or the key in case of IllegalFormatException

getCacheSize

public int getCacheSize()

Specified by:

getCacheSize in interface Messages

clearCache

public void clearCache()

Specified by:

clearCache in interface Messages