io.github.firemaples.translate

Class Translate

java.lang.Object

io.github.firemaples.MicrosoftTranslatorAPI<TextArrayRequest,TranslationResult>

io.github.firemaples.translate.Translate

public final class Translate
extends MicrosoftTranslatorAPI<TextArrayRequest,TranslationResult>

Translate

Makes calls to the Microsoft Translator API /Translate service

Uses the AJAX Interface V2 - see: http://msdn.microsoft.com/en-us/library/ff512406.aspx

Field Summary

Fields inherited from class io.github.firemaples.MicrosoftTranslatorAPI

apiKey, ENCODING, HTTP_GET, HTTP_POST, PARAM_APP_ID, PARAM_FROM_LANG, PARAM_LANGUAGE_CODES, PARAM_LOCALE, PARAM_SCOPE, PARAM_SENTENCES_LANGUAGE, PARAM_SPOKEN_LANGUAGE, PARAM_TEXT_ARRAY, PARAM_TEXT_SINGLE, PARAM_TO_LANG, protocol, PROTOCOL_HTTP, PROTOCOL_HTTPS

Method Summary

Modifier and Type	Method and Description
static java.lang.String[]	execute(java.lang.String[] texts, Language to) Translates an array of texts from an Automatically detected language to another given Language using Microsoft Translator's TranslateArray service
static java.lang.String[]	execute(java.lang.String[] texts, Language from, Language to) Translates an array of texts from a given Language to another given Language using Microsoft Translator's TranslateArray service
static java.lang.String	execute(java.lang.String text, Language to) Translates text from a given Language to another given Language using Microsoft Translator.
static java.lang.String	execute(java.lang.String text, Language from, Language to) Translates text from a given Language to another given Language using Microsoft Translator.
static TranslationResult	retrieveResult(Language from, Language to, java.lang.String... texts) Translates an array of texts from a given Language to another given Language using Microsoft Translator's TranslateArray service

Methods inherited from class io.github.firemaples.MicrosoftTranslatorAPI

buildStringArrayParam, getProtocol, getToken, isUsingSSL, resetToken, retrieveIntArray, retrieveResponseV3, retrieveResponseV3, retrieveString, retrieveStringArr, retrieveStringArr, setContentType, setHttpReferrer, setKey, setSubscriptionKey, setUsingSSL, toJsonString, validateServiceState

Methods inherited from class java.lang.Object

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

Method Detail

execute

public static java.lang.String execute(java.lang.String text,
                                       Language from,
                                       Language to)
                                throws java.lang.Exception

Translates text from a given Language to another given Language using Microsoft Translator.

Parameters:

text - The String to translate.

from - The language code to translate from.

to - The language code to translate to.

Returns:

The translated String.

Throws:

java.lang.Exception - on error.

execute

public static java.lang.String execute(java.lang.String text,
                                       Language to)
                                throws java.lang.Exception

Translates text from a given Language to another given Language using Microsoft Translator.

Default the from to AUTO_DETECT

Parameters:

text - The String to translate.

to - The language code to translate to.

Returns:

The translated String.

Throws:

java.lang.Exception - on error.

execute

public static java.lang.String[] execute(java.lang.String[] texts,
                                         Language from,
                                         Language to)
                                  throws java.lang.Exception

Translates an array of texts from a given Language to another given Language using Microsoft Translator's TranslateArray service

Note that the Microsoft Translator expects all source texts to be of the SAME language.

Parameters:

texts - The Strings Array to translate.

from - The language code to translate from.

to - The language code to translate to.

Returns:

The translated Strings Array[].

Throws:

java.lang.Exception - on error.

execute

public static java.lang.String[] execute(java.lang.String[] texts,
                                         Language to)
                                  throws java.lang.Exception

Translates an array of texts from an Automatically detected language to another given Language using Microsoft Translator's TranslateArray service

Note that the Microsoft Translator expects all source texts to be of the SAME language.

This is an overloaded convenience method that passes Language.AUTO_DETECT as fromLang to execute(texts[],fromLang,toLang)

Parameters:

texts - The Strings Array to translate.

to - The language code to translate to.

Returns:

The translated Strings Array[].

Throws:

java.lang.Exception - on error.

retrieveResult

public static TranslationResult retrieveResult(Language from,
                                               Language to,
                                               java.lang.String... texts)
                                        throws java.lang.Exception

Translates an array of texts from a given Language to another given Language using Microsoft Translator's TranslateArray service

Note that the Microsoft Translator expects all source texts to be of the SAME language.

Parameters:

from - The language code to translate from.

to - The language code to translate to.

texts - The Strings Array to translate.

Returns:

The translated Strings Array[].

Throws:

java.lang.Exception - on error.