com.atlassian.confluence.util.i18n
Interface I18NBean

All Known Implementing Classes:

DefaultI18NBean

public interface I18NBean

Responsible for fetching internationalised text for a given key.

Field Summary

static java.lang.String

DEFAULT_RESOURCE_BUNDLE

Method Summary

java.util.ResourceBundle	getResourceBundle()
java.lang.String	getText(Message message) Gets the i18n text for the specified message, formatting the message's value and arguments with MessageFormat.
java.lang.String	getText(java.lang.String key) Get the i18n text for a particular key.
java.lang.String	getText(java.lang.String key, java.util.List list)
java.lang.String	getText(java.lang.String key, java.lang.Object[] args) Get the i18n text for a particular key, formatted through MessageFormat with the given arguments.
java.lang.String	getTextStrict(java.lang.String i18nKey) Needed for text that should not be marked up (for example, values for the 'accessKey' attribute in an input element)
java.util.Map<java.lang.String,java.lang.String>	getTranslationsForPrefix(java.lang.String prefix) Gets a map of all keys that start with the given prefix, and their corresponding localised text, suitable for rendering with MessageFormat.
java.lang.String	getUntransformedRawText(java.lang.String key) Same as getText(String) but does not apply any TranslationTransforms.

Field Detail

DEFAULT_RESOURCE_BUNDLE

static final java.lang.String DEFAULT_RESOURCE_BUNDLE

Method Detail

getText

java.lang.String getText(@Nullable
                         java.lang.String key)

Get the i18n text for a particular key.

getText

java.lang.String getText(@Nullable
                         java.lang.String key,
                         @Nullable
                         java.lang.Object[] args)

Get the i18n text for a particular key, formatted through MessageFormat with the given arguments. Works similarly to ActionSupport.getText(String, java.util.List), but the array form is necessary to work well with Velocity.

Parameters:

key - the key to retrieve the i18n text for

args - an array of arguments to be passed in to the MessageFormat.format(java.lang.Object[], java.lang.StringBuffer, java.text.FieldPosition) for this text

Returns:

the appropriate i18n text, formatted with the supplied arguments

See Also:

ActionSupport.getText(String, java.util.List), MessageFormat

getText

java.lang.String getText(@Nullable
                         java.lang.String key,
                         @Nullable
                         java.util.List list)

getText

java.lang.String getText(Message message)

Gets the i18n text for the specified message, formatting the message's value and arguments with MessageFormat.

Parameters:

message - the message to format, containing an i18n key and arguments

Returns:

the formatted message

getTextStrict

java.lang.String getTextStrict(java.lang.String i18nKey)

Needed for text that should not be marked up (for example, values for the 'accessKey' attribute in an input element)

Parameters:

i18nKey - the key to retrieve localised text for

Returns:

text for i18nKey (and excludes markup regardless of settings)

getResourceBundle

java.util.ResourceBundle getResourceBundle()

getTranslationsForPrefix

java.util.Map<java.lang.String,java.lang.String> getTranslationsForPrefix(java.lang.String prefix)

Gets a map of all keys that start with the given prefix, and their corresponding localised text, suitable for rendering with MessageFormat. It is strongly recommended that plugin developers not use this, as its performance is not guaranteed. Instead, apply translations for specific keys (e.g. via the jsI18n web resource transformer).

Since:

5.0

getUntransformedRawText

java.lang.String getUntransformedRawText(java.lang.String key)

Same as getText(String) but does not apply any TranslationTransforms.

Parameters:

key - the key of the i18n message

Returns:

the un-formatted text or the key itself if no i18n message can be found