org.codehaus.griffon.runtime.core.i18n

Class MessageSourceDecorator

java.lang.Object

org.codehaus.griffon.runtime.core.i18n.MessageSourceDecorator

All Implemented Interfaces:

MessageSource

Direct Known Subclasses:

DefaultGroovyAwareMessageSource

public class MessageSourceDecorator
extends Object
implements MessageSource

Since:

2.4.0

Author:

Andres Almiray

Field Summary

Fields inherited from interface griffon.core.i18n.MessageSource

REF_KEY_END, REF_KEY_START

Constructor Summary

Constructors

Constructor and Description
MessageSourceDecorator(MessageSource delegate)

Method Summary

Modifier and Type	Method and Description
ResourceBundle	asResourceBundle() Offers a view of this MessageSource as a ResourceBundle.
String	formatMessage(String message, List<?> args) Formats the given message using supplied args to substitute placeholders.
String	formatMessage(String message, Map<String,Object> args) Formats the given message using supplied args to substitute placeholders.
String	formatMessage(String message, Object[] args) Formats the given message using supplied args to substitute placeholders.
protected MessageSource	getDelegate()
String	getMessage(String key) Try to resolve the message.
String	getMessage(String key, List<?> args) Try to resolve the message.
String	getMessage(String key, List<?> args, Locale locale) Try to resolve the message.
String	getMessage(String key, List<?> args, Locale locale, String defaultMessage) Try to resolve the message.
String	getMessage(String key, List<?> args, String defaultMessage) Try to resolve the message.
String	getMessage(String key, Locale locale) Try to resolve the message.
String	getMessage(String key, Locale locale, String defaultMessage) Try to resolve the message.
String	getMessage(String key, Map<String,Object> args) Try to resolve the message.
String	getMessage(String key, Map<String,Object> args, Locale locale) Try to resolve the message.
String	getMessage(String key, Map<String,Object> args, Locale locale, String defaultMessage) Try to resolve the message.
String	getMessage(String key, Map<String,Object> args, String defaultMessage) Try to resolve the message.
String	getMessage(String key, Object[] args) Try to resolve the message.
String	getMessage(String key, Object[] args, Locale locale) Try to resolve the message.
String	getMessage(String key, Object[] args, Locale locale, String defaultMessage) Try to resolve the message.
String	getMessage(String key, Object[] args, String defaultMessage) Try to resolve the message.
String	getMessage(String key, String defaultMessage) Try to resolve the message.
Object	resolveMessageValue(String key, Locale locale) Resolve a message given a key and a Locale.

Methods inherited from class java.lang.Object

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

Constructor Detail

MessageSourceDecorator

public MessageSourceDecorator(@Nonnull
                              MessageSource delegate)

Method Detail

getDelegate

@Nonnull
protected MessageSource getDelegate()

getMessage

@Nonnull
public String getMessage(@Nonnull
                                  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

formatMessage

@Nonnull
public String formatMessage(@Nonnull
                                     String message,
                                     @Nonnull
                                     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.

getMessage

@Nullable
public String getMessage(@Nonnull
                                   String key,
                                   @Nonnull
                                   List<?> args,
                                   @Nonnull
                                   Locale locale,
                                   @Nullable
                                   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 String getMessage(@Nonnull
                                  String key,
                                  @Nonnull
                                  Object[] args,
                                  @Nonnull
                                  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 String getMessage(@Nonnull
                                  String key,
                                  @Nonnull
                                  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

@Nullable
public String getMessage(@Nonnull
                                   String key,
                                   @Nonnull
                                   List<?> args,
                                   @Nullable
                                   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 String getMessage(@Nonnull
                                   String key,
                                   @Nonnull
                                   Object[] args,
                                   @Nonnull
                                   Locale locale,
                                   @Nullable
                                   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

formatMessage

@Nonnull
public String formatMessage(@Nonnull
                                     String message,
                                     @Nonnull
                                     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 String formatMessage(@Nonnull
                                     String message,
                                     @Nonnull
                                     Map<String,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.

getMessage

@Nonnull
public String getMessage(@Nonnull
                                  String key,
                                  @Nonnull
                                  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

@Nullable
public String getMessage(@Nonnull
                                   String key,
                                   @Nullable
                                   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 String getMessage(@Nonnull
                                   String key,
                                   @Nonnull
                                   Map<String,Object> args,
                                   @Nullable
                                   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

@Nonnull
public String getMessage(@Nonnull
                                  String key,
                                  @Nonnull
                                  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 String getMessage(@Nonnull
                                  String key,
                                  @Nonnull
                                  Map<String,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

@Nullable
public String getMessage(@Nonnull
                                   String key,
                                   @Nonnull
                                   Locale locale,
                                   @Nullable
                                   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 String getMessage(@Nonnull
                                   String key,
                                   @Nonnull
                                   Object[] args,
                                   @Nullable
                                   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

@Nonnull
public String getMessage(@Nonnull
                                  String key,
                                  @Nonnull
                                  Map<String,Object> args,
                                  @Nonnull
                                  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

asResourceBundle

@Nonnull
public ResourceBundle asResourceBundle()

Description copied from interface: MessageSource

Offers a view of this MessageSource as a ResourceBundle.

Specified by:

asResourceBundle in interface MessageSource

Returns:

a ResourceBundle containing the keys this MessageSource can resolve.

getMessage

@Nullable
public String getMessage(@Nonnull
                                   String key,
                                   @Nonnull
                                   Map<String,Object> args,
                                   @Nonnull
                                   Locale locale,
                                   @Nullable
                                   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

getMessage

@Nonnull
public String getMessage(@Nonnull
                                  String key,
                                  @Nonnull
                                  List<?> args,
                                  @Nonnull
                                  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

resolveMessageValue

@Nonnull
public Object resolveMessageValue(@Nonnull
                                           String key,
                                           @Nonnull
                                           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