com.vmware.vipclient.i18n.base.instances

Class TranslationMessage

java.lang.Object

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

All Implemented Interfaces:

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.

Constructor Summary

Constructors

Constructor and Description
TranslationMessage()

Method Summary

Modifier and Type	Method and Description
VIPCfg	getCfg()
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) get a translation under the component of the configured product
java.lang.String	getString2(java.lang.String component, java.lang.String bundle, java.util.Locale locale, java.lang.String key, 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.util.Map<java.lang.String,java.lang.String>	getStrings(java.util.Locale locale, java.lang.String component) get one component's translations from VIP of the configured product
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) post a source to remote VIP server
boolean	postStrings(java.util.Locale locale, java.lang.String component, java.util.List<org.json.simple.JSONObject> sources) post a set of sources to remote VIP server which is configured
void	setCfg(VIPCfg cfg)

Methods inherited from class java.lang.Object

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

Constructor Detail

TranslationMessage

public TranslationMessage()

Method Detail

getCfg

public VIPCfg getCfg()

setCfg

public void setCfg(VIPCfg cfg)

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)

get a translation under the component of the configured product

Parameters:

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

Returns:

string

postStrings

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

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

Parameters:

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).

Returns:

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)

post a source to remote VIP server

Parameters:

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.

Returns:

a boolean to indicate post succeeded or failed

getStrings

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

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

Parameters:

locale - a language tag to get the translations

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

Returns:

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

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

Parameters:

locales - locales to get the translations of them

components - names of the components to get translation

Returns:

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)

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

Parameters:

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

Returns:

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

Parameters:

component -

locale -

Returns:

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

Parameters:

component -

locale -

Returns: