play.i18n

Class Messages

java.lang.Object

play.i18n.Messages

public class Messages
extends Object

I18n Helper

translation are defined as properties in /conf/messages.locale files with locale being the i18n country code fr, en, fr_FR

 # /conf/messages.fr
 hello=Bonjour, %s !
 

Messages.get( "hello", "World"); // => "Bonjour, World !"

Field Summary

Fields

Modifier and Type	Field and Description
static Properties	defaults
static Map<String,Properties>	locales

Constructor Summary

Constructors

Constructor and Description
Messages()

Method Summary

Modifier and Type	Method and Description
static Properties	all(String locale) return all messages for a locale
static Properties	find(String locale, Set<String> keys) Return several messages for a locale
static String	formatString(Locale locale, String value, Object... args)
static String	formatString(String value, Object... args)
static String	get(Object key, Object... args) Given a message code, translate it using current locale.
static String	getMessage(String locale, Object key, Object... args)

Methods inherited from class java.lang.Object

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

Field Detail

defaults

public static Properties defaults

locales

public static Map<String,Properties> locales

Constructor Detail

Messages

public Messages()

Method Detail

get

public static String get(Object key,
                         Object... args)

Given a message code, translate it using current locale. If there is no message in the current locale for the given key, the key is returned.

Parameters:

key - the message code

args - optional message format arguments

Returns:

translated message

find

public static Properties find(String locale,
                              Set<String> keys)

Return several messages for a locale

Parameters:

locale - the locale code, e.g. fr, fr_FR

keys - the keys to get messages from. Wildcards can be used at the end: {'title', 'login.*'}

Returns:

messages as a java.util.Properties

getMessage

public static String getMessage(String locale,
                                Object key,
                                Object... args)

formatString

public static String formatString(String value,
                                  Object... args)

formatString

public static String formatString(Locale locale,
                                  String value,
                                  Object... args)

all

public static Properties all(String locale)

return all messages for a locale

Parameters:

locale - the locale code eg. fr, fr_FR

Returns:

messages as a java.util.Properties