org.opencms.gwt.client.util

类 CmsMessages

java.lang.Object

org.opencms.gwt.client.util.CmsMessages

public class CmsMessages
extends java.lang.Object

Reads localized resource Strings from a java.util.ResourceBundle and provides convenience methods to access the Strings from a template.

从以下版本开始:

8.0.0

另请参阅:

CmsMessages

字段概要

字段

限定符和类型	字段和说明
static java.lang.String	KEY_SHORT_SUFFIX The suffix of a "short" localized key name.
static java.lang.String	UNKNOWN_KEY_EXTENSION Prefix / Suffix for unknown keys.

构造器概要

构造器

构造器和说明
CmsMessages(java.lang.String bundleName) Default constructor.

方法概要

方法

限定符和类型	方法和说明
static java.lang.String	formatMessage(java.lang.String result, java.lang.Object... args) Helper method for formatting message parameters.
static java.lang.String	formatUnknownKey(java.lang.String keyName) Formats an unknown key.
CmsMessages	getBundle() Returns the localized message bundle wrapped in this instance.
java.lang.String	getBundleName() Returns the name of the resource bundle.
java.lang.String	getDate(java.util.Date date) Returns a formated date String from a Date value, the format being CmsDateTimeUtil.Format.SHORT and the locale based on this instance.
java.lang.String	getDate(java.util.Date date, CmsDateTimeUtil.Format format) Returns a formated date String from a Date value, the formatting based on the provided option and the locale based on this instance.
java.lang.String	getDate(long time) Returns a formated date String from a timestamp value, the format being CmsDateTimeUtil.Format.SHORT and the locale based on this instance.
java.lang.String	getDateTime(java.util.Date date) Returns a formated date and time String from a Date value, the format being CmsDateTimeUtil.Format.SHORT and the locale based on this instance.
java.lang.String	getDateTime(java.util.Date date, CmsDateTimeUtil.Format format) Returns a formated date and time String from a Date value, the formatting based on the provided option and the locale based on this instance.
java.lang.String	getDateTime(long time) Returns a formated date and time String from a timestamp value, the format being CmsDateTimeUtil.Format.SHORT and the locale based on this instance.
com.google.gwt.i18n.client.Dictionary	getDictionary() Returns the internal dictionary.
static boolean	isUnknownKey(java.lang.String value) Returns true if the provided value matches the scheme "???
java.lang.String	key(java.lang.String keyName) Returns the localized resource string for a given message key.
java.lang.String	key(java.lang.String keyName, boolean allowNull) Returns the localized resource string for a given message key.
java.lang.String	key(java.lang.String key, java.lang.Object... args) Returns the selected localized message for the initialized resource bundle and locale.
java.lang.String	keyDefault(java.lang.String keyName, java.lang.String defaultValue) Returns the localized resource string for a given message key.
java.lang.String	keyWithParams(java.lang.String keyName) Returns the localized resource string for a given message key, treating all values appended with "|" as replacement parameters.

从类继承的方法 java.lang.Object

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

字段详细资料

KEY_SHORT_SUFFIX

public static final java.lang.String KEY_SHORT_SUFFIX

The suffix of a "short" localized key name.

另请参阅:

常量字段值

UNKNOWN_KEY_EXTENSION

public static final java.lang.String UNKNOWN_KEY_EXTENSION

Prefix / Suffix for unknown keys.

另请参阅:

常量字段值

构造器详细资料

CmsMessages

public CmsMessages(java.lang.String bundleName)

Default constructor.

参数:

bundleName - the localized bundle name

方法详细资料

formatMessage

public static java.lang.String formatMessage(java.lang.String result,
                             java.lang.Object... args)

Helper method for formatting message parameters.

参数:

result - the raw message containing placeholders like {0}

args - the parameters to insert into the placeholders

返回:

the formatted message

formatUnknownKey

public static java.lang.String formatUnknownKey(java.lang.String keyName)

Formats an unknown key.

参数:

keyName - the key to format

返回:

the formatted unknown key

另请参阅:

isUnknownKey(String)

isUnknownKey

public static boolean isUnknownKey(java.lang.String value)

Returns true if the provided value matches the scheme "??? " + keyName + " ???", that is the value appears to be an unknown key.

Also returns true if the given value is null.

参数:

value - the value to check

返回:

true if the value is matches the scheme for unknown keys

另请参阅:

formatUnknownKey(String)

getBundle

public CmsMessages getBundle()

Returns the localized message bundle wrapped in this instance.

Mainly for API compatibility with the core localization methods.

返回:

the localized message bundle wrapped in this instance

getBundleName

public java.lang.String getBundleName()

Returns the name of the resource bundle.

返回:

the name of the resource bundle

getDate

public java.lang.String getDate(java.util.Date date)

Returns a formated date String from a Date value, the format being CmsDateTimeUtil.Format.SHORT and the locale based on this instance.

参数:

date - the Date object to format as String

返回:

the formatted date

getDate

public java.lang.String getDate(java.util.Date date,
                       CmsDateTimeUtil.Format format)

Returns a formated date String from a Date value, the formatting based on the provided option and the locale based on this instance.

参数:

date - the Date object to format as String

format - the format to use, see CmsDateTimeUtil.Format for possible values

返回:

the formatted date

getDate

public java.lang.String getDate(long time)

Returns a formated date String from a timestamp value, the format being CmsDateTimeUtil.Format.SHORT and the locale based on this instance.

参数:

time - the time value to format as date

返回:

the formatted date

getDateTime

public java.lang.String getDateTime(java.util.Date date)

Returns a formated date and time String from a Date value, the format being CmsDateTimeUtil.Format.SHORT and the locale based on this instance.

参数:

date - the Date object to format as String

返回:

the formatted date and time

getDateTime

public java.lang.String getDateTime(java.util.Date date,
                           CmsDateTimeUtil.Format format)

Returns a formated date and time String from a Date value, the formatting based on the provided option and the locale based on this instance.

参数:

date - the Date object to format as String

format - the format to use, see CmsDateTimeUtil.Format for possible values

返回:

the formatted date and time

getDateTime

public java.lang.String getDateTime(long time)

Returns a formated date and time String from a timestamp value, the format being CmsDateTimeUtil.Format.SHORT and the locale based on this instance.

参数:

time - the time value to format as date

返回:

the formatted date and time

getDictionary

public com.google.gwt.i18n.client.Dictionary getDictionary()

Returns the internal dictionary.

返回:

the internal dictionary

key

public java.lang.String key(java.lang.String keyName)

Returns the localized resource string for a given message key.

If the key was not found in the bundle, the return value is "??? " + keyName + " ???". This will also be returned if the bundle was not properly initialized first.

参数:

keyName - the key for the desired string

返回:

the resource string for the given key

key

public java.lang.String key(java.lang.String keyName,
                   boolean allowNull)

Returns the localized resource string for a given message key.

If the key was not found in the bundle, the return value depends on the setting of the allowNull parameter. If set to false, the return value is always a String in the format "??? " + keyName + " ???". If set to true, null is returned if the key is not found. This will also be returned if the bundle was not properly initialized first.

参数:

keyName - the key for the desired string

allowNull - if true, 'null' is an allowed return value

返回:

the resource string for the given key

key

public java.lang.String key(java.lang.String key,
                   java.lang.Object... args)

Returns the selected localized message for the initialized resource bundle and locale.

If the key was found in the bundle, it will be formatted using a MessageFormat using the provided parameters.

If the key was not found in the bundle, the return value is "??? " + keyName + " ???". This will also be returned if the bundle was not properly initialized first.

参数:

key - the message key

args - the message arguments

返回:

the selected localized message for the initialized resource bundle and locale

keyDefault

public java.lang.String keyDefault(java.lang.String keyName,
                          java.lang.String defaultValue)

Returns the localized resource string for a given message key.

If the key was not found in the bundle, the provided default value is returned.

参数:

keyName - the key for the desired string

defaultValue - the default value in case the key does not exist in the bundle

返回:

the resource string for the given key it it exists, or the given default if not

keyWithParams

public java.lang.String keyWithParams(java.lang.String keyName)

Returns the localized resource string for a given message key, treating all values appended with "|" as replacement parameters.

If the key was found in the bundle, it will be formatted using a MessageFormat using the provided parameters. The parameters have to be appended to the key separated by a "|". For example, the keyName error.message|First|Second would use the key error.message with the parameters First and Second. This would be the same as calling key(String, Object[]).

If no parameters are appended with "|", this is the same as calling key(String).

If the key was not found in the bundle, the return value is "??? " + keyName + " ???". This will also be returned if the bundle was not properly initialized first.

参数:

keyName - the key for the desired string, optionally containing parameters appended with a "|"

返回:

the resource string for the given key

另请参阅:

key(String, Object[]), key(String)