com.vmware.vipclient.i18n.base.instances

类 TranslationMessage

java.lang.Object

com.vmware.vipclient.i18n.base.instances.TranslationMessage

所有已实现的接口:

I18n, Message

public class TranslationMessage
extends java.lang.Object
implements Message

This class provide some APIs to get translation from VIP service in string-based, component-based level.

构造器概要

构造器

构造器和说明
TranslationMessage()

方法概要

限定符和类型	方法和说明
VIPCfg	getCfg()
java.lang.String	getMessage(java.util.Locale locale, java.lang.String component, java.lang.String key, java.lang.Object... args) Retrieves the localized message
java.util.Map<java.lang.String,java.lang.String>	getMessages(java.util.Locale locale, java.lang.String component) Retrieves the set of localized messages from the cache.
java.lang.String	getString(java.util.Locale locale, java.lang.String component, java.lang.String key, java.lang.String source, java.lang.String comment, java.util.Map<java.lang.String,java.lang.Object> args) get a translation under the component of the configured product
java.lang.String	getString(java.util.Locale locale, java.lang.String component, java.lang.String key, java.lang.String source, java.lang.String comment, java.lang.Object... args) 已过时。 Replaced by getMessage(Locale, String, String, Object...) which fetches source messages from messages_source.json of the component. This method only supports English as both the default and the source locale.
java.lang.String	getString2(java.lang.String component, java.lang.String bundle, java.util.Locale locale, java.lang.String key, java.util.Map<java.lang.String,java.lang.Object> args) get one translation of the configured product from VIP, if message not found will get the English message from specified bundle.
java.lang.String	getString2(java.lang.String component, java.lang.String bundle, java.util.Locale locale, java.lang.String key, java.lang.Object... args) 已过时。 Replaced by getMessage(Locale, String, String, Object...) which fetches source messages from messages_source.json of the component. This method only supports English as both the default and the source locale.
java.util.Map<java.lang.String,java.lang.String>	getStrings(java.util.Locale locale, java.lang.String component) 已过时。 Replaced by getMessages(Locale, String)
java.util.Map<java.util.Locale,java.util.Map<java.lang.String,java.util.Map<java.lang.String,java.lang.String>>>	getStrings(java.util.Set<java.util.Locale> locales, java.util.Set<java.lang.String> components) get multiple components' translations from VIP server
boolean	isAvailable(java.lang.String component, java.util.Locale locale) check if the translations of specified component is available
boolean	isAvailable(java.lang.String component, java.lang.String key, java.util.Locale locale) check if one translation of specified key is available
boolean	postString(java.util.Locale locale, java.lang.String component, java.lang.String key, java.lang.String source, java.lang.String comment) 已过时。 Collection of source message is not supported at runtime.
boolean	postStrings(java.util.Locale locale, java.lang.String component, java.util.List<org.json.simple.JSONObject> sources) 已过时。 Collection of source message is not supported at runtime.
void	setCfg(VIPCfg cfg)

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

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

构造器详细资料

TranslationMessage

public TranslationMessage()

方法详细资料

getCfg

public VIPCfg getCfg()

setCfg

public void setCfg(VIPCfg cfg)

getMessage

public java.lang.String getMessage(java.util.Locale locale,
                                   java.lang.String component,
                                   java.lang.String key,
                                   java.lang.Object... args)

Retrieves the localized message

参数:

locale - The locale in which the message is requested to be localized

component - The Singleton component in which the message belongs

key - The key that represents the message

args - Values to replace placeholders in the message with

返回:

One of the items in the following priority-ordered list:.

抛出:

VIPJavaClientException - If none from the list below is available

• The source message, if source message hasn't been collected and translated
• The message in the requested locale
• The message in the next available fallback locale
• The source message

getString

public java.lang.String getString(java.util.Locale locale,
                                  java.lang.String component,
                                  java.lang.String key,
                                  java.lang.String source,
                                  java.lang.String comment,
                                  java.lang.Object... args)

已过时。 Replaced by getMessage(Locale, String, String, Object...) which fetches source messages from messages_source.json of the component. This method only supports English as both the default and the source locale.

get a translation under the component of the configured product

参数:

locale - an object used to get the source's translation

component - defined on VIP service, it will be created automatically if not exist

key - identify the source

source - it's English source which will be return if no translation available

comment - used to describe the source to help understand the source for the translators.

args - used to format the message with placeholder, it's not required if the message doesn't contain any placeholder

返回:

string

getString

public java.lang.String getString(java.util.Locale locale,
                                  java.lang.String component,
                                  java.lang.String key,
                                  java.lang.String source,
                                  java.lang.String comment,
                                  java.util.Map<java.lang.String,java.lang.Object> args)

get a translation under the component of the configured product

参数:

locale - an object used to get the source's translation

component - defined on VIP service, it will be created automatically if not exist

key - identify the source

source - it's English source which will be return if no translation available

comment - used to describe the source to help understand the source for the translators.

args - named arguments used to format the message with placeholder

返回:

string

postStrings

public boolean postStrings(java.util.Locale locale,
                           java.lang.String component,
                           java.util.List<org.json.simple.JSONObject> sources)

已过时。 Collection of source message is not supported at runtime.

post a set of sources to remote VIP server which is configured

参数:

locale - currently no matter which locale it is, all sources will be considered as English

component - the component name used to categorize the sources and auto-created first time

sources - the JSONObject should contain three attributes(key, source, commentForSource).

返回:

a boolean to indicate the post status

postString

public boolean postString(java.util.Locale locale,
                          java.lang.String component,
                          java.lang.String key,
                          java.lang.String source,
                          java.lang.String comment)

已过时。 Collection of source message is not supported at runtime.

post a source to remote VIP server

参数:

locale - an object used to get the source's translation

component - defined on VIP service, it will be created automatically if not exist

key - identify the source

source - it's English source which will be return if no translation available

comment - used to describe the source to help understand the source for the translators.

返回:

a boolean to indicate post succeeded or failed

getStrings

@Deprecated
public java.util.Map<java.lang.String,java.lang.String> getStrings(java.util.Locale locale,
                                                                               java.lang.String component)

已过时。 Replaced by getMessages(Locale, String)

get one component's translations from VIP of the configured product

参数:

locale - a language tag to get the translations

component - defined on VIP service, it will be created automatically if not exist

返回:

a map contains all translations of the component mapped by the source's key

getMessages

public java.util.Map<java.lang.String,java.lang.String> getMessages(java.util.Locale locale,
                                                                    java.lang.String component)

Retrieves the set of localized messages from the cache. It applies locale fallback mechanism in case of failure.

参数:

component - The Singleton component

locale - The locale in which the messages are requested to be localized

返回:

One of the items in the following priority-ordered list:

• The messages in the requested locale
• The messages in the default locale
• The source messages

getStrings

public java.util.Map<java.util.Locale,java.util.Map<java.lang.String,java.util.Map<java.lang.String,java.lang.String>>> getStrings(java.util.Set<java.util.Locale> locales,
                                                                                                                                   java.util.Set<java.lang.String> components)

get multiple components' translations from VIP server

参数:

locales - locales to get the translations of them

components - names of the components to get translation

返回:

a map contains all translations of the components of specified locales. Key is loale; value is also a map whose key is component and value is the messages belong to this component.

getString2

public java.lang.String getString2(java.lang.String component,
                                   java.lang.String bundle,
                                   java.util.Locale locale,
                                   java.lang.String key,
                                   java.lang.Object... args)

已过时。 Replaced by getMessage(Locale, String, String, Object...) which fetches source messages from messages_source.json of the component. This method only supports English as both the default and the source locale.

get one translation of the configured product from VIP, if message not found will get the English message from specified bundle.

参数:

component - defined on VIP service, it will be created automatically if not exist

bundle - properties file name, normally it should be put under the root 'src' path

locale - an object used to get the source's translation

key - identify the source

args - used to format the message with placeholder, it's not required if the message doesn't contain any placeholder

返回:

a message of translation, if the translation is not found from VIP service, it will return the value defined in the bundle searching by the key

getString2

public java.lang.String getString2(java.lang.String component,
                                   java.lang.String bundle,
                                   java.util.Locale locale,
                                   java.lang.String key,
                                   java.util.Map<java.lang.String,java.lang.Object> args)

get one translation of the configured product from VIP, if message not found will get the English message from specified bundle.

参数:

component - defined on VIP service, it will be created automatically if not exist

bundle - properties file name, normally it should be put under the root 'src' path

locale - an object used to get the source's translation

key - identify the source

args - named arguments used to format the message with placeholder

返回:

a message of translation, if the translation is not found from VIP service, it will return the value defined in the bundle searching by the key

isAvailable

public boolean isAvailable(java.lang.String component,
                           java.util.Locale locale)

check if the translations of specified component is available

参数:

component -

locale -

返回:

isAvailable

public boolean isAvailable(java.lang.String component,
                           java.lang.String key,
                           java.util.Locale locale)

check if one translation of specified key is available

参数:

component -

locale -

返回: