Package org.spincast.core.dictionary

Interface Dictionary

public interface Dictionary

The entity to get a localized message given a specified key.

Method Summary

Modifier and Type	Method	Description
String	get(String key)	Gets a message.
String	get(String key, boolean forceEvaluation)	Gets a message.
String	get(String key, Locale locale)	Gets a message.
String	get(String key, Locale locale, boolean forceEvaluation)	Gets a message.
String	get(String key, Locale locale, Map<String,Object> params)	Gets a message.
String	get(String key, Locale locale, Pair... params)	Gets a message.
String	get(String key, Map<String,Object> params)	Gets a message.
String	get(String key, Pair... params)	Gets a message.
Map<String,String>	getAll(String key)	Return all the possible values, for all languages used, by language abreviation.
Map<String,String>	getAll(String key, Map<String,Object> params)	Return all the possible values, for all languages used, by language abreviation.
Map<String,String>	getAll(String key, Pair... params)	Return all the possible values, for all languages used, by language abreviation.
Set<String>	getAllKeys()	Returns all keys the dictionary contains.
boolean	hasKey(String key)	Contains this key?

Method Details

get

String get(String key)

Gets a message.

Will use the proper Locale as provided by the LocaleResolver.

The behavior if the key is not found can be configured using SpincastConfig#getDictionaryEntryNotFoundFallbackTo() and SpincastConfig.getDictionaryEntryNotFoundBehavior().

get

String get(String key,
 Locale locale)

Gets a message.

Uses the specified Locale.

The behavior if the key is not found can be configured using SpincastConfig#getDictionaryEntryNotFoundFallbackTo() and SpincastConfig.getDictionaryEntryNotFoundBehavior().

get

String get(String key,
 boolean forceEvaluation)

Gets a message.

Will use the proper Locale as provided by the LocaleResolver.

Parameters:

forceEvaluation - if true, the TemplatingEngine will be used even there are no parameters. This may be useful to trigger some templating function that don't need parameters. We don't use the templting engine will default since it is costy.

The behavior if the key is not found can be configured using SpincastConfig#getDictionaryEntryNotFoundFallbackTo() and SpincastConfig.getDictionaryEntryNotFoundBehavior().

get

String get(String key,
 Locale locale,
 boolean forceEvaluation)

Gets a message.

Uses the specified Locale.

Parameters:

forceEvaluation - if true, the TemplatingEngine will be used even there are no parameters. This may be useful to trigger some templating function that don't need parameters. We don't use the templting engine will default since it is costy.

The behavior if the key is not found can be configured using SpincastConfig#getDictionaryEntryNotFoundFallbackTo() and SpincastConfig.getDictionaryEntryNotFoundBehavior().

get

String get(String key,
 Pair... params)

Gets a message. Will use the proper Locale as provided by the LocaleResolver.

The behavior if the key is not found can be configured using SpincastConfig#getDictionaryEntryNotFoundFallbackTo() and SpincastConfig.getDictionaryEntryNotFoundBehavior().

get

String get(String key,
 Locale locale,
 Pair... params)

Gets a message.

Uses the specified Locale.

The behavior if the key is not found can be configured using SpincastConfig#getDictionaryEntryNotFoundFallbackTo() and SpincastConfig.getDictionaryEntryNotFoundBehavior().

get

String get(String key,
 Map<String,Object> params)

Gets a message.

Will use the proper Locale as provided by the LocaleResolver.

The behavior if the key is not found can be configured using SpincastConfig#getDictionaryEntryNotFoundFallbackTo() and SpincastConfig.getDictionaryEntryNotFoundBehavior().

get

String get(String key,
 Locale locale,
 Map<String,Object> params)

Gets a message.

Uses the specified Locale.

The behavior if the key is not found can be configured using SpincastConfig#getDictionaryEntryNotFoundFallbackTo() and SpincastConfig.getDictionaryEntryNotFoundBehavior().

hasKey

boolean hasKey(String key)

Contains this key?

getAll

Map<String,String> getAll(String key)

Return all the possible values, for all languages used, by language abreviation.

getAll

Map<String,String> getAll(String key,
 Map<String,Object> params)

Return all the possible values, for all languages used, by language abreviation.

getAll

Map<String,String> getAll(String key,
 Pair... params)

Return all the possible values, for all languages used, by language abreviation.

getAllKeys

Set<String> getAllKeys()

Returns all keys the dictionary contains.