org.apache.tika.language.translate

Class CachedTranslator

java.lang.Object

org.apache.tika.language.translate.CachedTranslator

All Implemented Interfaces:

Translator

public class CachedTranslator
extends Object
implements Translator

CachedTranslator. Saves a map of previous translations in order to prevent repetitive translation requests.

Constructor Summary

Constructors

Constructor and Description
CachedTranslator(Translator translator) Create a new CachedTranslator.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	contains(String text, String targetLanguage) Check whether this CachedTranslator's cache contains a translation of the text to the target language, attempting to auto-detect the source language.
boolean	contains(String text, String sourceLanguage, String targetLanguage) Check whether this CachedTranslator's cache contains a translation of the text from the source language to the target language.
int	getNumTranslationPairs() Get the number of different source/target translation pairs this CachedTranslator currently has in its cache.
int	getNumTranslationsFor(String sourceLanguage, String targetLanguage) Get the number of different translations from the source language to the target language this CachedTranslator has in its cache.
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.

Methods inherited from class java.lang.Object

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

Constructor Detail

CachedTranslator

public CachedTranslator(Translator translator)

Create a new CachedTranslator.

Parameters:

translator - The translator that should be used for the underlying translation service. The properties for that service must be set properly!

Method Detail

translate

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

Description copied from interface: Translator

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").

Specified by:

translate in interface Translator

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.

translate

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

Description copied from interface: Translator

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").

Specified by:

translate in interface Translator

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.

isAvailable

public boolean isAvailable()

Specified by:

isAvailable in interface Translator

Returns:

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

getNumTranslationPairs

public int getNumTranslationPairs()

Get the number of different source/target translation pairs this CachedTranslator currently has in its cache.

Returns:

Number of translation source/target pairs in this CachedTranslator's cache.

Since:

Tika 1.6

getNumTranslationsFor

public int getNumTranslationsFor(String sourceLanguage,
                        String targetLanguage)

Get the number of different translations from the source language to the target language this CachedTranslator has in its cache.

Parameters:

sourceLanguage - The source language of translation.

targetLanguage - The target language of translation.

Returns:

The number of translations between source and target.

Since:

Tika 1.6

contains

public boolean contains(String text,
               String sourceLanguage,
               String targetLanguage)

Check whether this CachedTranslator's cache contains a translation of the text from the source language to the target language.

Parameters:

text - What string to check for.

sourceLanguage - The source language of translation.

targetLanguage - The target language of translation.

Returns:

true if the cache contains a translation of the text, false otherwise.

contains

public boolean contains(String text,
               String targetLanguage)

Check whether this CachedTranslator's cache contains a translation of the text to the target language, attempting to auto-detect the source language.

Parameters:

text - What string to check for.

targetLanguage - The target language of translation.

Returns:

true if the cache contains a translation of the text, false otherwise.