com.ibm.watson.developer_cloud.language_translator.v2

Class LanguageTranslator

java.lang.Object

com.ibm.watson.developer_cloud.service.WatsonService

com.ibm.watson.developer_cloud.language_translator.v2.LanguageTranslator

public class LanguageTranslator
extends WatsonService

Language Translator translates text from one language to another. The service offers multiple domain-specific models that you can customize based on your unique terminology and language. Use Language Translator to take news from across the globe and present it in your language, communicate with your customers in their own language, and more.

See Also:

Language Translator

Field Summary

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

defaultHeaders, MESSAGE_CODE, MESSAGE_ERROR, skipAuthentication, VERSION

Constructor Summary

Constructors

Constructor and Description
LanguageTranslator() Instantiates a new `LanguageTranslator`.
LanguageTranslator(java.lang.String username, java.lang.String password) Instantiates a new `LanguageTranslator` with username and password.

Method Summary

Methods

Modifier and Type	Method and Description
ServiceCall<TranslationModel>	createModel(CreateModelOptions createModelOptions) Uploads a TMX glossary file on top of a domain to customize a translation model.
ServiceCall<java.lang.Void>	deleteModel(DeleteModelOptions deleteModelOptions) Deletes a custom translation model.
ServiceCall<TranslationModel>	getModel(GetModelOptions getModelOptions) Get information about the given translation model, including training status.
ServiceCall<IdentifiedLanguages>	identify(IdentifyOptions identifyOptions) Identifies the language of the input text.
ServiceCall<IdentifiableLanguages>	listIdentifiableLanguages() Lists all languages that can be identified by the API.
ServiceCall<IdentifiableLanguages>	listIdentifiableLanguages(ListIdentifiableLanguagesOptions listIdentifiableLanguagesOptions) Lists all languages that can be identified by the API.
ServiceCall<TranslationModels>	listModels() Lists available standard and custom models by source or target language.
ServiceCall<TranslationModels>	listModels(ListModelsOptions listModelsOptions) Lists available standard and custom models by source or target language.
ServiceCall<TranslationResult>	translate(TranslateOptions translateOptions) Translates the input text from the source language to the target language.

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

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

Methods inherited from class java.lang.Object

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

Constructor Detail

LanguageTranslator

public LanguageTranslator()

Instantiates a new `LanguageTranslator`.

LanguageTranslator

public LanguageTranslator(java.lang.String username,
                  java.lang.String password)

Instantiates a new `LanguageTranslator` with username and password.

Parameters:

username - the username

password - the password

Method Detail

translate

public ServiceCall<TranslationResult> translate(TranslateOptions translateOptions)

Translates the input text from the source language to the target language.

Parameters:

translateOptions - the TranslateOptions containing the options for the call

Returns:

a ServiceCall with a response type of TranslationResult

identify

public ServiceCall<IdentifiedLanguages> identify(IdentifyOptions identifyOptions)

Identifies the language of the input text.

Parameters:

identifyOptions - the IdentifyOptions containing the options for the call

Returns:

a ServiceCall with a response type of IdentifiedLanguages

listIdentifiableLanguages

public ServiceCall<IdentifiableLanguages> listIdentifiableLanguages(ListIdentifiableLanguagesOptions listIdentifiableLanguagesOptions)

Lists all languages that can be identified by the API. Lists all languages that the service can identify. Returns the two-letter code (for example, `en` for English or `es` for Spanish) and name of each language.

Parameters:

listIdentifiableLanguagesOptions - the ListIdentifiableLanguagesOptions containing the options for the call

Returns:

a ServiceCall with a response type of IdentifiableLanguages

listIdentifiableLanguages

public ServiceCall<IdentifiableLanguages> listIdentifiableLanguages()

Lists all languages that can be identified by the API. Lists all languages that the service can identify. Returns the two-letter code (for example, `en` for English or `es` for Spanish) and name of each language.

Returns:

a ServiceCall with a response type of IdentifiableLanguages

createModel

public ServiceCall<TranslationModel> createModel(CreateModelOptions createModelOptions)

Uploads a TMX glossary file on top of a domain to customize a translation model.

Parameters:

createModelOptions - the CreateModelOptions containing the options for the call

Returns:

a ServiceCall with a response type of TranslationModel

deleteModel

public ServiceCall<java.lang.Void> deleteModel(DeleteModelOptions deleteModelOptions)

Deletes a custom translation model.

Parameters:

deleteModelOptions - the DeleteModelOptions containing the options for the call

Returns:

a ServiceCall with a response type of Void

getModel

public ServiceCall<TranslationModel> getModel(GetModelOptions getModelOptions)

Get information about the given translation model, including training status.

Parameters:

getModelOptions - the GetModelOptions containing the options for the call

Returns:

a ServiceCall with a response type of TranslationModel

listModels

public ServiceCall<TranslationModels> listModels(ListModelsOptions listModelsOptions)

Lists available standard and custom models by source or target language.

Parameters:

listModelsOptions - the ListModelsOptions containing the options for the call

Returns:

a ServiceCall with a response type of TranslationModels

listModels

public ServiceCall<TranslationModels> listModels()

Lists available standard and custom models by source or target language.

Returns:

a ServiceCall with a response type of TranslationModels