ninja.i18n

Class MessagesImpl

java.lang.Object

ninja.i18n.MessagesImpl

All Implemented Interfaces:

Messages

public class MessagesImpl
extends java.lang.Object
implements Messages

Constructor Summary

Constructors

Constructor and Description
MessagesImpl(NinjaProperties ninjaProperties, Lang lang)

Method Summary

Modifier and Type	Method and Description
com.google.common.base.Optional<java.lang.String>	get(java.lang.String key, Context context, com.google.common.base.Optional<Result> result, java.lang.Object... parameter) Get a translated string.
com.google.common.base.Optional<java.lang.String>	get(java.lang.String key, com.google.common.base.Optional<java.lang.String> language, java.lang.Object... params) Get a translated string.
java.util.Map<java.lang.Object,java.lang.Object>	getAll(Context context, com.google.common.base.Optional<Result> result) Returns all messages for the default language in that context / result.
java.util.Map<java.lang.Object,java.lang.Object>	getAll(com.google.common.base.Optional<java.lang.String> language)
java.lang.String	getWithDefault(java.lang.String key, java.lang.String defaultMessage, Context context, com.google.common.base.Optional<Result> result, java.lang.Object... params) Gets a message for a message key.
java.lang.String	getWithDefault(java.lang.String key, java.lang.String defaultMessage, com.google.common.base.Optional<java.lang.String> language, java.lang.Object... params) Gets a message for a message key.

Methods inherited from class java.lang.Object

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

Constructor Detail

MessagesImpl

@Inject
public MessagesImpl(NinjaProperties ninjaProperties,
                            Lang lang)

Method Detail

get

public com.google.common.base.Optional<java.lang.String> get(java.lang.String key,
                                                             Context context,
                                                             com.google.common.base.Optional<Result> result,
                                                             java.lang.Object... parameter)

Description copied from interface: Messages

Get a translated string. The language is determined by the provided locale or a suitable fallback. values of keys can use the MessageFormat. More here: http://docs.oracle.com/javase/6/docs/api/java/text/MessageFormat.html But in short you can use something like mymessage=my message with a placeholder {0}

Specified by:

get in interface Messages

Parameters:

key - The key used in your message file (conf/messages.properties)

context - The context used to determine the language.

result - The result used to determine the language.

parameter - Parameters to use in formatting the message of the key (in MessageFormat).

Returns:

The matching and formatted value or absent if not found.

get

public com.google.common.base.Optional<java.lang.String> get(java.lang.String key,
                                                             com.google.common.base.Optional<java.lang.String> language,
                                                             java.lang.Object... params)

Description copied from interface: Messages

Get a translated string. The language is determined by the provided locale or a suitable fallback. values of keys can use the MessageFormat. More here: http://docs.oracle.com/javase/6/docs/api/java/text/MessageFormat.html But in short you can use something like mymessage=my message with a placeholder {0} parameter will then be used to fill {0} with the content. Note: If you don't want to determine the language yourself please use Messages#get(String, Context, Result, Object...)

Specified by:

get in interface Messages

Parameters:

key - The key used in your message file (conf/messages.properties)

language - The language to get. Can be null - then the default language is returned. It also looks for a fallback. Eg. A request for "en-US" will fallback to "en" if there is no matching language file.

params - Parameters to use in formatting the message of the key (in MessageFormat).

Returns:

The matching and formatted value or absent if not found.

getAll

public java.util.Map<java.lang.Object,java.lang.Object> getAll(Context context,
                                                               com.google.common.base.Optional<Result> result)

Description copied from interface: Messages

Returns all messages for the default language in that context / result. Does NOT format any MessageFormat values. You have to do that yourself in the controller logic most likely.

Specified by:

getAll in interface Messages

Parameters:

context - The context

result - The result - bay be absent

Returns:

A map with all messages as

getAll

public java.util.Map<java.lang.Object,java.lang.Object> getAll(com.google.common.base.Optional<java.lang.String> language)

Specified by:

getAll in interface Messages

Parameters:

language - The language to get. May be absent - then the default language is returned. It also looks for a fallback. Eg. A request for "en-US" will fallback to "en" if there is no matching language file. language can also be the complete Accept-Language header: en-US,en;q=0.8,de;q=0.6

Returns:

A map with all messages as

getWithDefault

public java.lang.String getWithDefault(java.lang.String key,
                                       java.lang.String defaultMessage,
                                       Context context,
                                       com.google.common.base.Optional<Result> result,
                                       java.lang.Object... params)

Description copied from interface: Messages

Gets a message for a message key. Returns a defaultValue if not found.

Specified by:

getWithDefault in interface Messages

Parameters:

key - The key used in your message file (conf/messages.properties)

defaultMessage - A default message that will be used when no matching message can be retrieved.

context - The context used to determine the language.

result - The result used to determine the language. May be absent

params - Parameters to use in formatting the message of the key (in MessageFormat).

Returns:

The matching and formatted value (either from messages or the default one).

getWithDefault

public java.lang.String getWithDefault(java.lang.String key,
                                       java.lang.String defaultMessage,
                                       com.google.common.base.Optional<java.lang.String> language,
                                       java.lang.Object... params)

Description copied from interface: Messages

Gets a message for a message key. Returns a defaultValue if not found. Note: If you don't want to determine the language yourself please use Messages#getWithDefault(String, Context, Result, Object...)

Specified by:

getWithDefault in interface Messages

Parameters:

key - The key used in your message file (conf/messages.properties)

defaultMessage - A default message that will be used when no matching message can be retrieved.

language - The language to get. May be absent - then the default language is returned. It also looks for a fallback. Eg. A request for "en-US" will fallback to "en" if there is no matching language file.

Returns:

The matching and formatted value (either from messages or the default one).