com.ibm.watson.developer_cloud.language_translation.v2

Class LanguageTranslation

java.lang.Object

com.ibm.watson.developer_cloud.service.WatsonService

com.ibm.watson.developer_cloud.language_translation.v2.LanguageTranslation

public class LanguageTranslation
extends WatsonService

The IBM Watson Language Translator service translate text from one language to another and identifies the language in which text is written.

Version:

v2

See Also:

Language translation

Field Summary

Fields inherited from class com.ibm.watson.developer_cloud.service.WatsonService

MESSAGE_CODE, MESSAGE_ERROR, VERSION

Constructor Summary

Constructors

Constructor and Description
LanguageTranslation() Instantiates a new Language Translator service.
LanguageTranslation(String username, String password) Instantiates a new language translation service by username and password.

Method Summary

Modifier and Type	Method and Description
ServiceCall<TranslationModel>	createModel(CreateModelOptions options) Creates a translation models.
ServiceCall<Void>	deleteModel(String modelId) Deletes a translation models.
ServiceCall<List<IdentifiableLanguage>>	getIdentifiableLanguages() Gets the The identifiable languages.
ServiceCall<TranslationModel>	getModel(String modelId) Gets a translation models.
ServiceCall<List<TranslationModel>>	getModels() Gets the translation models.
ServiceCall<List<TranslationModel>>	getModels(Boolean showDefault, String source, String target) Retrieves the list of models.
ServiceCall<List<IdentifiedLanguage>>	identify(String text) Identify language in which text is written.
ServiceCall<TranslationResult>	translate(List<String> texts, Language source, Language target) Translate multiple texts using source and target languages.
ServiceCall<TranslationResult>	translate(List<String> texts, String modelId) Translate multiple texts using a given model.
ServiceCall<TranslationResult>	translate(String text, Language source, Language target) Translate text using source and target languages. Here is an example of how to translate "hello" from English to Spanish:
ServiceCall<TranslationResult>	translate(String text, String modelId) Translate text using a given model.

Methods inherited from class com.ibm.watson.developer_cloud.service.WatsonService

configureHttpClient, createServiceCall, getApiKey, getEndPoint, getName, getToken, processServiceCall, setApiKey, setAuthentication, setDefaultHeaders, setEndPoint, setSkipAuthentication, setUsernameAndPassword, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

LanguageTranslation

public LanguageTranslation()

Instantiates a new Language Translator service.

LanguageTranslation

public LanguageTranslation(String username,
                           String password)

Instantiates a new language translation service by username and password.

Parameters:

username - the username

password - the password

Method Detail

createModel

public ServiceCall<TranslationModel> createModel(CreateModelOptions options)

Creates a translation models.

Parameters:

options - the create model options

Returns:

the translation model

deleteModel

public ServiceCall<Void> deleteModel(String modelId)

Deletes a translation models.

Parameters:

modelId - the model identifier

Returns:

the service call

getIdentifiableLanguages

public ServiceCall<List<IdentifiableLanguage>> getIdentifiableLanguages()

Gets the The identifiable languages.

Returns:

the identifiable languages

See Also:

See {@link IdentifiableLanguage}

getModel

public ServiceCall<TranslationModel> getModel(String modelId)

Gets a translation models.

Parameters:

modelId - the model identifier

Returns:

the translation models

See Also:

TranslationModel

getModels

public ServiceCall<List<TranslationModel>> getModels()

Gets the translation models.

Returns:

the translation models

See Also:

TranslationModel

getModels

public ServiceCall<List<TranslationModel>> getModels(Boolean showDefault,
                                                     String source,
                                                     String target)

Retrieves the list of models.

Parameters:

showDefault - show default models

source - the source

target - the target

Returns:

the translation models

See Also:

TranslationModel

identify

public ServiceCall<List<IdentifiedLanguage>> identify(String text)

Identify language in which text is written.

Parameters:

text - the text to identify

Returns:

the identified language

translate

public ServiceCall<TranslationResult> translate(String text,
                                                String modelId)

Translate text using a given model.

Parameters:

text - The submitted paragraphs to translate

modelId - the model id

Returns:

The TranslationResult

translate

public ServiceCall<TranslationResult> translate(String text,
                                                Language source,
                                                Language target)

Translate text using source and target languages.

Here is an example of how to translate "hello" from English to Spanish:

 LanguageTranslation service = new LanguageTranslation();
 service.setUsernameAndPassword("USERNAME", "PASSWORD");

 TranslationResult translationResult = service.translate("hello", Language.SPANISH, Language.ENGLISH).execute();

 System.out.println(translationResult);
 

Parameters:

text - The paragraphs to translate

source - The source language

target - The target language

Returns:

The TranslationResult

translate

public ServiceCall<TranslationResult> translate(List<String> texts,
                                                String modelId)

Translate multiple texts using a given model.

Parameters:

texts - The submitted texts to translate

modelId - the model id

Returns:

The TranslationResult with translations in the same order as the supplied texts.

translate

public ServiceCall<TranslationResult> translate(List<String> texts,
                                                Language source,
                                                Language target)

Translate multiple texts using source and target languages.

Parameters:

texts - The texts to translate

source - The source language

target - The target language

Returns:

The TranslationResult with translations in the same order as the supplied texts.