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 Translation service translate text from one language to another and identifies the language in which text is written.

Version:

v2

Author:

German Attanasio Ruiz (germanatt@us.ibm.com)

See Also:

Language Translation

Field Summary

Fields

Modifier and Type	Field and Description
static String	BASE_MODEL_ID The Constant BASE_MODEL_ID.
static String	DEFAULT The Constant DEFAULT.
static String	FORCED_GLOSSARY The Constant FORCED_GLOSSARY.
static String	MODEL_ID The Constant MODEL_ID.
static String	NAME The Constant NAME.
static String	SOURCE The Constant SOURCE.
static String	TARGET The Constant TARGET.
static String	TEXT The Constant TEXT.

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

FORWARD_SLASH

Constructor Summary

Constructors

Constructor and Description
LanguageTranslation() Instantiates a new Language Translation service.

Method Summary

Modifier and Type	Method and Description
TranslationModel	createModel(Map<String,Object> params) Creates a translation models.
void	deleteModel(String modelId) Deletes a translation models.
List<IdentifiableLanguage>	getIdentifiableLanguages() Retrieves the list of identifiable languages.
TranslationModel	getModel(String modelId) Retrieves a translation models.
List<TranslationModel>	getModels() Retrieves the list of translation models.
List<TranslationModel>	getModels(Boolean showDefault, String source, String target) Retrieves the list of models.
List<IdentifiedLanguage>	identify(String text) Identify language in which text is written.
String	toString()
TranslationResult	translate(Map<String,Object> params) Translate paragraphs of text using a model and or source and target.
TranslationResult	translate(String text, String modelId) Translate text using a model.
TranslationResult	translate(String text, String source, String target) Translate text using source and target languages.

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

execute, executeRequest, executeWithoutResponse, getApiKey, getDefaultContentType, getDefaultRequestParams, getEndPoint, getHttpClient, getThreadSafeClient, setApiKey, setAuthentication, setEndPoint, setUsernameAndPassword

Methods inherited from class java.lang.Object

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

Field Detail

BASE_MODEL_ID

public static final String BASE_MODEL_ID

The Constant BASE_MODEL_ID.

See Also:

Constant Field Values

FORCED_GLOSSARY

public static final String FORCED_GLOSSARY

The Constant FORCED_GLOSSARY.

See Also:

Constant Field Values

DEFAULT

public static final String DEFAULT

The Constant DEFAULT.

See Also:

Constant Field Values

MODEL_ID

public static final String MODEL_ID

The Constant MODEL_ID.

See Also:

Constant Field Values

SOURCE

public static final String SOURCE

The Constant SOURCE.

See Also:

Constant Field Values

TARGET

public static final String TARGET

The Constant TARGET.

See Also:

Constant Field Values

TEXT

public static final String TEXT

The Constant TEXT.

See Also:

Constant Field Values

NAME

public static final String NAME

The Constant NAME.

See Also:

Constant Field Values

Constructor Detail

LanguageTranslation

public LanguageTranslation()

Instantiates a new Language Translation service.

Method Detail

getIdentifiableLanguages

public List<IdentifiableLanguage> getIdentifiableLanguages()

Retrieves the list of identifiable languages.

Returns:

the identifiable languages

See Also:

TranslationModel

getModels

public List<TranslationModel> getModels()

Retrieves the list of translation models.

Returns:

the translation models

See Also:

TranslationModel

getModel

public TranslationModel getModel(String modelId)

Retrieves a translation models.

Parameters:

modelId - the model identifier

Returns:

the translation models

See Also:

TranslationModel

deleteModel

public void deleteModel(String modelId)

Deletes a translation models.

Parameters:

modelId - the model identifier

createModel

public TranslationModel createModel(Map<String,Object> params)

Creates a translation models.

Parameters:

params - String name the model name, String base_model_id the model id to use as base model, File forced_glossary the tmx file use in the model

Returns:

the translation model

getModels

public 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 List<IdentifiedLanguage> identify(String text)

Identify language in which text is written.

Parameters:

text - the text to identify

Returns:

the identified language

toString

public String toString()

Overrides:

toString in class WatsonService

translate

public TranslationResult translate(Map<String,Object> params)

Translate paragraphs of text using a model and or source and target. model_id or source and target needs to be specified. If both are specified, then only model_id will be used

Parameters:

params - the params

Returns:

The TranslationResult

translate

public TranslationResult translate(String text,
                                   String modelId)

Translate text using a model.

Parameters:

text - The submitted paragraphs to translate

modelId - the model id

Returns:

The TranslationResult

translate

public TranslationResult translate(String text,
                                   String source,
                                   String target)

Translate text using source and target languages.

Parameters:

text - The submitted paragraphs to translate

source - The source language

target - The target language

Returns:

The TranslationResult