org.codehaus.griffon.runtime.core.i18n

Class AbstractMessageSource

java.lang.Object

org.codehaus.griffon.runtime.core.i18n.AbstractMessageSource

All Implemented Interfaces:

MessageSource

Direct Known Subclasses:

CompositeMessageSource, DefaultMessageSource

public abstract class AbstractMessageSource
extends java.lang.Object
implements MessageSource

Since:

2.0.0

Author:

Andres Almiray, Alexander Klein

Field Summary

Fields

Modifier and Type	Field and Description
protected static java.lang.Object[]	EMPTY_OBJECT_ARGS
protected static java.lang.String	ERROR_ARGS_NULL
protected static java.lang.String	ERROR_KEY_BLANK
protected static java.lang.String	ERROR_LOCALE_NULL
protected static java.lang.String	ERROR_MESSAGE_NULL

Fields inherited from interface griffon.core.i18n.MessageSource

REF_KEY_END, REF_KEY_START

Constructor Summary

Constructors

Constructor and Description
AbstractMessageSource()

Method Summary

Modifier and Type	Method and Description
protected abstract java.lang.Object	doResolveMessageValue(java.lang.String key, java.util.Locale locale)
protected java.lang.Object	evalMessageWithArguments(java.lang.Object message, java.util.Map<java.lang.String,java.lang.Object> args)
protected java.lang.Object	evalMessageWithArguments(java.lang.Object message, java.lang.Object[] args)
java.lang.String	formatMessage(java.lang.String message, java.util.List<?> args) Formats the given message using supplied args to substitute placeholders.
java.lang.String	formatMessage(java.lang.String message, java.util.Map<java.lang.String,java.lang.Object> args) Formats the given message using supplied args to substitute placeholders.
java.lang.String	formatMessage(java.lang.String message, java.lang.Object[] args) Formats the given message using supplied args to substitute placeholders.
java.lang.String	getMessage(java.lang.String key) Try to resolve the message.
java.lang.String	getMessage(java.lang.String key, java.util.List<?> args) Try to resolve the message.
java.lang.String	getMessage(java.lang.String key, java.util.List<?> args, java.util.Locale locale) Try to resolve the message.
java.lang.String	getMessage(java.lang.String key, java.util.List<?> args, java.util.Locale locale, java.lang.String defaultMessage) Try to resolve the message.
java.lang.String	getMessage(java.lang.String key, java.util.List<?> args, java.lang.String defaultMessage) Try to resolve the message.
java.lang.String	getMessage(java.lang.String key, java.util.Locale locale) Try to resolve the message.
java.lang.String	getMessage(java.lang.String key, java.util.Locale locale, java.lang.String defaultMessage) Try to resolve the message.
java.lang.String	getMessage(java.lang.String key, java.util.Map<java.lang.String,java.lang.Object> args) Try to resolve the message.
java.lang.String	getMessage(java.lang.String key, java.util.Map<java.lang.String,java.lang.Object> args, java.util.Locale locale) Try to resolve the message.
java.lang.String	getMessage(java.lang.String key, java.util.Map<java.lang.String,java.lang.Object> args, java.util.Locale locale, java.lang.String defaultMessage) Try to resolve the message.
java.lang.String	getMessage(java.lang.String key, java.util.Map<java.lang.String,java.lang.Object> args, java.lang.String defaultMessage) Try to resolve the message.
java.lang.String	getMessage(java.lang.String key, java.lang.Object[] args) Try to resolve the message.
java.lang.String	getMessage(java.lang.String key, java.lang.Object[] args, java.util.Locale locale) Try to resolve the message.
java.lang.String	getMessage(java.lang.String key, java.lang.Object[] args, java.util.Locale locale, java.lang.String defaultMessage) Try to resolve the message.
java.lang.String	getMessage(java.lang.String key, java.lang.Object[] args, java.lang.String defaultMessage) Try to resolve the message.
java.lang.String	getMessage(java.lang.String key, java.lang.String defaultMessage) Try to resolve the message.
java.lang.Object	resolveMessageValue(java.lang.String key, java.util.Locale locale) Resolve a message given a key and a Locale.
protected java.lang.Object[]	toObjectArray(java.util.List<?> args)

Methods inherited from class java.lang.Object

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

Methods inherited from interface griffon.core.i18n.MessageSource

asResourceBundle

Field Detail

ERROR_KEY_BLANK

protected static final java.lang.String ERROR_KEY_BLANK

See Also:

Constant Field Values

ERROR_LOCALE_NULL

protected static final java.lang.String ERROR_LOCALE_NULL

See Also:

Constant Field Values

ERROR_ARGS_NULL

protected static final java.lang.String ERROR_ARGS_NULL

See Also:

Constant Field Values

ERROR_MESSAGE_NULL

protected static final java.lang.String ERROR_MESSAGE_NULL

See Also:

Constant Field Values

EMPTY_OBJECT_ARGS

protected static final java.lang.Object[] EMPTY_OBJECT_ARGS

Constructor Detail

AbstractMessageSource

public AbstractMessageSource()

Method Detail

getMessage

@Nonnull
public java.lang.String getMessage(@Nonnull
                                            java.lang.String key)
                                     throws NoSuchMessageException

Description copied from interface: MessageSource

Try to resolve the message.

Specified by:

getMessage in interface MessageSource

Parameters:

key - Key to lookup, such as 'log4j.appenders.console'

Returns:

The resolved message at the given key for the default locale

Throws:

NoSuchMessageException - if no message is found

getMessage

@Nonnull
public java.lang.String getMessage(@Nonnull
                                            java.lang.String key,
                                            @Nonnull
                                            java.util.Locale locale)
                                     throws NoSuchMessageException

Description copied from interface: MessageSource

Try to resolve the message.

Specified by:

getMessage in interface MessageSource

Parameters:

key - Key to lookup, such as 'log4j.appenders.console'

locale - Locale in which to lookup

Returns:

The resolved message at the given key for the given locale

Throws:

NoSuchMessageException - if no message is found

getMessage

@Nonnull
public java.lang.String getMessage(@Nonnull
                                            java.lang.String key,
                                            @Nonnull
                                            java.lang.Object[] args)
                                     throws NoSuchMessageException

Description copied from interface: MessageSource

Try to resolve the message.

Specified by:

getMessage in interface MessageSource

Parameters:

key - Key to lookup, such as 'log4j.appenders.console'

args - Arguments that will be filled in for params within the message (params look like "{0}" within a message, but this might differ between implementations), or null if none.

Returns:

The resolved message at the given key for the default locale

Throws:

NoSuchMessageException - if no message is found

getMessage

@Nonnull
public java.lang.String getMessage(@Nonnull
                                            java.lang.String key,
                                            @Nonnull
                                            java.lang.Object[] args,
                                            @Nonnull
                                            java.util.Locale locale)
                                     throws NoSuchMessageException

Description copied from interface: MessageSource

Try to resolve the message.

Specified by:

getMessage in interface MessageSource

Parameters:

key - Key to lookup, such as 'log4j.appenders.console'

args - Arguments that will be filled in for params within the message (params look like "{0}" within a message, but this might differ between implementations), or null if none.

locale - Locale in which to lookup

Returns:

The resolved message at the given key for the given locale

Throws:

NoSuchMessageException - if no message is found

getMessage

@Nonnull
public java.lang.String getMessage(@Nonnull
                                            java.lang.String key,
                                            @Nonnull
                                            java.util.List<?> args)
                                     throws NoSuchMessageException

Description copied from interface: MessageSource

Try to resolve the message.

Specified by:

getMessage in interface MessageSource

Parameters:

key - Key to lookup, such as 'log4j.appenders.console'

args - Arguments that will be filled in for params within the message (params look like "{0}" within a message, but this might differ between implementations), or null if none.

Returns:

The resolved message at the given key for the default locale

Throws:

NoSuchMessageException - if no message is found

getMessage

@Nonnull
public java.lang.String getMessage(@Nonnull
                                            java.lang.String key,
                                            @Nonnull
                                            java.util.List<?> args,
                                            @Nonnull
                                            java.util.Locale locale)
                                     throws NoSuchMessageException

Description copied from interface: MessageSource

Try to resolve the message.

Specified by:

getMessage in interface MessageSource

Parameters:

key - Key to lookup, such as 'log4j.appenders.console'

args - Arguments that will be filled in for params within the message (params look like "{0}" within a message, but this might differ between implementations), or null if none.

locale - Locale in which to lookup

Returns:

The resolved message at the given key for the given locale

Throws:

NoSuchMessageException - if no message is found

getMessage

@Nullable
public java.lang.String getMessage(@Nonnull
                                             java.lang.String key,
                                             @Nullable
                                             java.lang.String defaultMessage)

Description copied from interface: MessageSource

Try to resolve the message. Return default message if no message was found.

Specified by:

getMessage in interface MessageSource

Parameters:

key - Key to lookup, such as 'log4j.appenders.console'

defaultMessage - Message to return if the lookup fails

Returns:

The resolved message at the given key for the default locale

getMessage

@Nullable
public java.lang.String getMessage(@Nonnull
                                             java.lang.String key,
                                             @Nonnull
                                             java.util.Locale locale,
                                             @Nullable
                                             java.lang.String defaultMessage)

Description copied from interface: MessageSource

Try to resolve the message. Return default message if no message was found.

Specified by:

getMessage in interface MessageSource

Parameters:

key - Key to lookup, such as 'log4j.appenders.console'

locale - Locale in which to lookup

defaultMessage - Message to return if the lookup fails

Returns:

The resolved message at the given key for the given locale

getMessage

@Nullable
public java.lang.String getMessage(@Nonnull
                                             java.lang.String key,
                                             @Nonnull
                                             java.lang.Object[] args,
                                             @Nullable
                                             java.lang.String defaultMessage)

Description copied from interface: MessageSource

Try to resolve the message. Return default message if no message was found.

Specified by:

getMessage in interface MessageSource

Parameters:

key - Key to lookup, such as 'log4j.appenders.console'

args - Arguments that will be filled in for params within the message (params look like "{0}" within a message, but this might differ between implementations), or null if none.

defaultMessage - Message to return if the lookup fails

Returns:

The resolved message at the given key for the default locale

getMessage

@Nullable
public java.lang.String getMessage(@Nonnull
                                             java.lang.String key,
                                             @Nonnull
                                             java.lang.Object[] args,
                                             @Nonnull
                                             java.util.Locale locale,
                                             @Nullable
                                             java.lang.String defaultMessage)

Description copied from interface: MessageSource

Try to resolve the message. Return default message if no message was found.

Specified by:

getMessage in interface MessageSource

Parameters:

key - Key to lookup, such as 'log4j.appenders.console'

args - Arguments that will be filled in for params within the message (params look like "{0}" within a message, but this might differ between implementations), or null if none.

locale - Locale in which to lookup

defaultMessage - Message to return if the lookup fails

Returns:

The resolved message at the given key for the given locale

getMessage

@Nullable
public java.lang.String getMessage(@Nonnull
                                             java.lang.String key,
                                             @Nonnull
                                             java.util.List<?> args,
                                             @Nullable
                                             java.lang.String defaultMessage)

Description copied from interface: MessageSource

Try to resolve the message. Return default message if no message was found.

Specified by:

getMessage in interface MessageSource

Parameters:

key - Key to lookup, such as 'log4j.appenders.console'

args - Arguments that will be filled in for params within the message (params look like "{0}" within a message, but this might differ between implementations), or null if none.

defaultMessage - Message to return if the lookup fails

Returns:

The resolved message at the given key for the default locale

getMessage

@Nullable
public java.lang.String getMessage(@Nonnull
                                             java.lang.String key,
                                             @Nonnull
                                             java.util.List<?> args,
                                             @Nonnull
                                             java.util.Locale locale,
                                             @Nullable
                                             java.lang.String defaultMessage)

Description copied from interface: MessageSource

Try to resolve the message. Return default message if no message was found.

Specified by:

getMessage in interface MessageSource

Parameters:

key - Key to lookup, such as 'log4j.appenders.console'

args - Arguments that will be filled in for params within the message (params look like "{0}" within a message, but this might differ between implementations), or null if none.

locale - Locale in which to lookup

defaultMessage - Message to return if the lookup fails

Returns:

The resolved message at the given key for the given locale

getMessage

@Nonnull
public java.lang.String getMessage(@Nonnull
                                            java.lang.String key,
                                            @Nonnull
                                            java.util.Map<java.lang.String,java.lang.Object> args)
                                     throws NoSuchMessageException

Description copied from interface: MessageSource

Try to resolve the message.

Specified by:

getMessage in interface MessageSource

Parameters:

key - Key to lookup, such as 'log4j.appenders.console'

args - Arguments that will be filled in for params within the message (params look like "{:key}" within a message, but this might differ between implementations), or null if none.

Returns:

The resolved message at the given key for the default locale

Throws:

NoSuchMessageException - if no message is found

getMessage

@Nonnull
public java.lang.String getMessage(@Nonnull
                                            java.lang.String key,
                                            @Nonnull
                                            java.util.Map<java.lang.String,java.lang.Object> args,
                                            @Nonnull
                                            java.util.Locale locale)
                                     throws NoSuchMessageException

Description copied from interface: MessageSource

Try to resolve the message.

Specified by:

getMessage in interface MessageSource

Parameters:

key - Key to lookup, such as 'log4j.appenders.console'

args - Arguments that will be filled in for params within the message (params look like "{:key}" within a message, but this might differ between implementations), or null if none.

locale - Locale in which to lookup

Returns:

The resolved message at the given key for the given locale

Throws:

NoSuchMessageException - if no message is found

getMessage

@Nullable
public java.lang.String getMessage(@Nonnull
                                             java.lang.String key,
                                             @Nonnull
                                             java.util.Map<java.lang.String,java.lang.Object> args,
                                             @Nullable
                                             java.lang.String defaultMessage)

Description copied from interface: MessageSource

Try to resolve the message. Return default message if no message was found.

Specified by:

getMessage in interface MessageSource

Parameters:

key - Key to lookup, such as 'log4j.appenders.console'

args - Arguments that will be filled in for params within the message (params look like "{:key}" within a message, but this might differ between implementations), or null if none.

defaultMessage - Message to return if the lookup fails

Returns:

The resolved message at the given key for the default locale

getMessage

@Nullable
public java.lang.String getMessage(@Nonnull
                                             java.lang.String key,
                                             @Nonnull
                                             java.util.Map<java.lang.String,java.lang.Object> args,
                                             @Nonnull
                                             java.util.Locale locale,
                                             @Nullable
                                             java.lang.String defaultMessage)

Description copied from interface: MessageSource

Try to resolve the message. Return default message if no message was found.

Specified by:

getMessage in interface MessageSource

Parameters:

key - Key to lookup, such as 'log4j.appenders.console'

args - Arguments that will be filled in for params within the message (params look like "{:key}" within a message, but this might differ between implementations), or null if none.

locale - Locale in which to lookup

defaultMessage - Message to return if the lookup fails

Returns:

The resolved message at the given key for the given locale

resolveMessageValue

@Nonnull
public java.lang.Object resolveMessageValue(@Nonnull
                                                     java.lang.String key,
                                                     @Nonnull
                                                     java.util.Locale locale)
                                              throws NoSuchMessageException

Description copied from interface: MessageSource

Resolve a message given a key and a Locale.

This method should use the default Locale if the locale argument is null. The key argument may refer to another key if the resolved value results in a CharSequence that begins with "@[" and ends with "]". In this case the method will use the enclosed value as the next key to be resolved. For example, given the following key/value definitions

     some.key = Hello {0}
     other.key = @[some.key]
 

Evaluating the keys results in

    assert resolveMessageValue('some.key', Locale.default) == 'Hello {0}'
    assert resolveMessageValue('other.key', Locale.default) == 'Hello {0}'
 

Specified by:

resolveMessageValue in interface MessageSource

Parameters:

key - Key to lookup, such as 'log4j.appenders.console'

locale - Locale in which to lookup

Returns:

the resolved message value at the given key for the given locale

Throws:

NoSuchMessageException - if no message is found

formatMessage

@Nonnull
public java.lang.String formatMessage(@Nonnull
                                               java.lang.String message,
                                               @Nonnull
                                               java.util.List<?> args)

Description copied from interface: MessageSource

Formats the given message using supplied args to substitute placeholders.

Specified by:

formatMessage in interface MessageSource

Parameters:

message - The message following a predefined format.

args - Arguments that will be filled in for params within the message (params look like "{0}" within a message, but this might differ between implementations), or null if none.

Returns:

the formatted message with all matching placeholders with their substituted values.

formatMessage

@Nonnull
public java.lang.String formatMessage(@Nonnull
                                               java.lang.String message,
                                               @Nonnull
                                               java.lang.Object[] args)

Description copied from interface: MessageSource

Formats the given message using supplied args to substitute placeholders.

Specified by:

formatMessage in interface MessageSource

Parameters:

message - The message following a predefined format.

args - Arguments that will be filled in for params within the message (params look like "{0}" within a message, but this might differ between implementations), or null if none.

Returns:

the formatted message with all matching placeholders with their substituted values.

formatMessage

@Nonnull
public java.lang.String formatMessage(@Nonnull
                                               java.lang.String message,
                                               @Nonnull
                                               java.util.Map<java.lang.String,java.lang.Object> args)

Description copied from interface: MessageSource

Formats the given message using supplied args to substitute placeholders.

Specified by:

formatMessage in interface MessageSource

Parameters:

message - The message following a predefined format.

args - Arguments that will be filled in for params within the message (params look like "{:key}" within a message, but this might differ between implementations), or null if none.

Returns:

the formatted message with all matching placeholders with their substituted values.

doResolveMessageValue

@Nonnull
protected abstract java.lang.Object doResolveMessageValue(@Nonnull
                                                                   java.lang.String key,
                                                                   @Nonnull
                                                                   java.util.Locale locale)
                                                            throws NoSuchMessageException

Throws:

NoSuchMessageException

evalMessageWithArguments

@Nullable
protected java.lang.Object evalMessageWithArguments(@Nonnull
                                                              java.lang.Object message,
                                                              @Nonnull
                                                              java.lang.Object[] args)

evalMessageWithArguments

@Nullable
protected java.lang.Object evalMessageWithArguments(@Nonnull
                                                              java.lang.Object message,
                                                              @Nonnull
                                                              java.util.Map<java.lang.String,java.lang.Object> args)

toObjectArray

@Nonnull
protected java.lang.Object[] toObjectArray(@Nonnull
                                                    java.util.List<?> args)