rocks.xmpp.extensions.langtrans

Class LanguageTranslationManager

java.lang.Object

rocks.xmpp.core.session.Manager

rocks.xmpp.extensions.langtrans.LanguageTranslationManager

public final class LanguageTranslationManager
extends Manager

Manages XMPP language translation protocol.

It lets you discover language translation providers and ask them to translate a text.

See Also:

XEP-0171: Language Translation

Method Summary

Modifier and Type	Method and Description
List<LanguageSupport.Item>	discoverLanguageSupport(rocks.xmpp.addr.Jid translationProvider) Discovers language support for a translation provider.
Collection<Item>	discoverTranslationProviders() Discovers the language provider on the connected server.
List<LanguageTranslation.Translation>	translate(rocks.xmpp.addr.Jid translationProvider, String text, String sourceLanguage, String... destinationLanguage) Translates a text by sending a query to a translation provider.

Methods inherited from class rocks.xmpp.core.session.Manager

isEnabled, setEnabled

Methods inherited from class java.lang.Object

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

Method Detail

discoverTranslationProviders

public Collection<Item> discoverTranslationProviders()
                                              throws XmppException

Discovers the language provider on the connected server.

Returns:

The list of translation providers.

Throws:

StanzaException - If the entity returned a stanza error.

NoResponseException - If the entity did not respond.

XmppException

See Also:

4.2 Discovering Translation Providers

discoverLanguageSupport

public List<LanguageSupport.Item> discoverLanguageSupport(rocks.xmpp.addr.Jid translationProvider)
                                                   throws XmppException

Discovers language support for a translation provider.

Parameters:

translationProvider - The translation provider.

Returns:

The list of supported languages with details.

Throws:

StanzaException - If the entity returned a stanza error.

NoResponseException - If the entity did not respond.

XmppException

See Also:

4.2.3 Discovering Language Support

translate

public List<LanguageTranslation.Translation> translate(rocks.xmpp.addr.Jid translationProvider,
                                                       String text,
                                                       String sourceLanguage,
                                                       String... destinationLanguage)
                                                throws XmppException

Translates a text by sending a query to a translation provider.

Parameters:

translationProvider - The translation provider.

text - The text to be translated.

sourceLanguage - The source language.

destinationLanguage - The destination language.

Returns:

The translations.

Throws:

StanzaException - If the entity returned a stanza error.

NoResponseException - If the entity did not respond.

XmppException

See Also:

4.3 Requesting a Translation from a Service