org.opencms.i18n

类 CmsMultiMessages

java.lang.Object

org.opencms.i18n.CmsMessages

org.opencms.i18n.CmsMultiMessages

直接已知子类:

CmsWorkplaceMessages

public class CmsMultiMessages
extends CmsMessages

Provides access to the localized messages for several resource bundles simultaneously.

Messages are cached for faster lookup. If a localized key is contained in more then one resource bundle, it will be used only from the resource bundle where it was first found in. The resource bundle order is undefined. It is therefore recommended to ensure the uniqueness of all module keys by placing a special prefix in front of all keys of a resource bundle.

从以下版本开始:

6.0.0

字段概要

字段

限定符和类型	字段和说明
static java.lang.String	MULTI_BUNDLE_NAME Constant for the multi bundle name.
static java.lang.String	NULL_STRING Null String value for caching of null message results.

从类继承的字段 org.opencms.i18n.CmsMessages

KEY_SHORT_SUFFIX, UNKNOWN_KEY_EXTENSION

构造器概要

构造器

构造器和说明
CmsMultiMessages(java.util.Locale locale) Constructor for creating a new messages object initialized with the given locale.

方法概要

方法

限定符和类型	方法和说明
void	addBundle(I_CmsMessageBundle bundle) Adds a bundle instance to this multi message bundle.
void	addMessages(CmsMessages messages) Adds a messages instance to this multi message bundle.
void	addMessages(java.util.List<CmsMessages> messages) Adds a list a messages instances to this multi message bundle.
java.util.List<CmsMessages>	getMessages() Returns the list of all individual message objects in this multi message instance.
java.lang.String	getString(java.lang.String keyName) Directly calls the getString(String) method of the wrapped ResourceBundle.
boolean	isInitialized() Checks if the bundle was properly initialized.
java.lang.String	key(java.lang.String keyName, boolean allowNull) Returns the localized resource string for a given message key.

从类继承的方法 org.opencms.i18n.CmsMessages

equals, formatUnknownKey, getBundleName, getDate, getDate, getDate, getDateTime, getDateTime, getDateTime, getLocale, getResourceBundle, hashCode, isUncacheable, isUnknownKey, key, key, key, key, key, keyDefault, keyWithParams, setBundleName, setLocale, setResourceBundle, toString

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

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

字段详细资料

MULTI_BUNDLE_NAME

public static final java.lang.String MULTI_BUNDLE_NAME

Constant for the multi bundle name.

NULL_STRING

public static final java.lang.String NULL_STRING

Null String value for caching of null message results.

另请参阅:

常量字段值

构造器详细资料

CmsMultiMessages

public CmsMultiMessages(java.util.Locale locale)

Constructor for creating a new messages object initialized with the given locale.

参数:

locale - the locale to use for localization of the messages

方法详细资料

addBundle

public void addBundle(I_CmsMessageBundle bundle)

Adds a bundle instance to this multi message bundle.

The added bundle will be localized with the locale of this multi message bundle.

参数:

bundle - the bundle instance to add

addMessages

public void addMessages(CmsMessages messages)
                 throws CmsIllegalArgumentException

Adds a messages instance to this multi message bundle.

The messages instance should have been initialized with the same locale as this multi bundle, if not, the locale of the messages instance is automatically replaced. However, this will not work if the added messages instance is in face also of type CmsMultiMessages.

参数:

messages - the messages instance to add

抛出:

CmsIllegalArgumentException - if the locale of the given CmsMultiMessages does not match the locale of this multi messages

addMessages

public void addMessages(java.util.List<CmsMessages> messages)

Adds a list a messages instances to this multi message bundle.

参数:

messages - the messages instance to add

getMessages

public java.util.List<CmsMessages> getMessages()

Returns the list of all individual message objects in this multi message instance.

返回:

the list of all individual message objects in this multi message instance

getString

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

从类复制的说明: CmsMessages

Directly calls the getString(String) method of the wrapped ResourceBundle.

If you use this this class on a template, you should consider using the CmsMessages.key(String) method to get the value from the ResourceBundle because it handles the exception for you in a convenient way.

覆盖:

getString 在类中 CmsMessages

参数:

keyName - the key

返回:

the resource string for the given key

另请参阅:

CmsMessages.getString(java.lang.String)

isInitialized

public boolean isInitialized()

从类复制的说明: CmsMessages

Checks if the bundle was properly initialized.

覆盖:

isInitialized 在类中 CmsMessages

返回:

true if bundle was initialized, false otherwise

另请参阅:

CmsMessages.isInitialized()

key

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

从类复制的说明: CmsMessages

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.

覆盖:

key 在类中 CmsMessages

参数:

keyName - the key for the desired string

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

返回:

the resource string for the given key

另请参阅:

CmsMessages.key(java.lang.String, boolean)