org.apache.tika.language.translate

Interface Translator

All Known Implementing Classes:

DefaultTranslator

public interface Translator

Interface for Translator services.

Since:

Tika 1.6

Method Summary

Methods

Modifier and Type	Method and Description
boolean	isAvailable()
String	translate(String text, String targetLanguage) Translate text to the given language.
String	translate(String text, String sourceLanguage, String targetLanguage) Translate text between given languages.

Method Detail

translate

String translate(String text,
               String sourceLanguage,
               String targetLanguage)
                 throws Exception

Translate text between given languages. The following languages are supported: Arabic("ar"), Bulgarian("bg"), Catalan("ca"), Chinese-Simplified("zh-CHS"), Chinese-Traditional("zh-CHT"), Czech("cs"), Danish("da"), Dutch("nl"), English("en"), Estonian("et"), Innish("fi"), French("fr"), German("de"), Greek("el"), Haitian-Creole("ht"), Hebrew("he"), Hindi("hi"), Hmong-Daw("mww"), Hungarian("hu"), Indonesian("id"), Italian("it"), Japanese("ja"), Korean("ko"), Latvian("lv"), Lithuanian("lt"), Malay("ms"), Norwegian("no"), Persian("fa"), Polish("pl"), Portuguese("pt"), Romanian("ro"), Russian("ru"), Slovak("sk"), Slovenian("sl"), Spanish("es"), Swedish("sv"), Thai("th"), Turkish("tr"), Ukranian("uk"), Urdu("ur"), Vietnemese("vi").

Parameters:

text - The text to translate.

sourceLanguage - The input text language (for example, "en").

targetLanguage - The desired language to translate to (for example, "fr").

Returns:

The translation result. If translation is unavailable, returns the same text back.

Throws:

Exception - When there is an error with the API call.

Since:

Tika 1.6

translate

String translate(String text,
               String targetLanguage)
                 throws Exception

Translate text to the given language. This method attempts to auto-detect the source language of the text. The following languages are supported: Arabic("ar"), Bulgarian("bg"), Catalan("ca"), Chinese-Simplified("zh-CHS"), Chinese-Traditional("zh-CHT"), Czech("cs"), Danish("da"), Dutch("nl"), English("en"), Estonian("et"), Innish("fi"), French("fr"), German("de"), Greek("el"), Haitian-Creole("ht"), Hebrew("he"), Hindi("hi"), Hmong-Daw("mww"), Hungarian("hu"), Indonesian("id"), Italian("it"), Japanese("ja"), Korean("ko"), Latvian("lv"), Lithuanian("lt"), Malay("ms"), Norwegian("no"), Persian("fa"), Polish("pl"), Portuguese("pt"), Romanian("ro"), Russian("ru"), Slovak("sk"), Slovenian("sl"), Spanish("es"), Swedish("sv"), Thai("th"), Turkish("tr"), Ukranian("uk"), Urdu("ur"), Vietnemese("vi").

Parameters:

text - The text to translate.

targetLanguage - The desired language to translate to (for example, "hi").

Returns:

The translation result. If translation is unavailable, returns the same text back.

Throws:

Exception - When there is an error with the API call.

Since:

Tika 1.6

isAvailable

boolean isAvailable()

Returns:

true if this Translator is probably able to translate right now.

Since:

Tika 1.6