jp.go.nict.langrid.wrapper.ws_1_2.translation

Class AbstractTranslationService

java.lang.Object

jp.go.nict.langrid.servicecontainer.service.AbstractService

jp.go.nict.langrid.wrapper.ws_1_2.AbstractService

jp.go.nict.langrid.wrapper.ws_1_2.AbstractLanguagePairService

jp.go.nict.langrid.wrapper.ws_1_2.translation.AbstractTranslationService

All Implemented Interfaces:

BackTranslationService, MultihopTranslationService, TranslationService

Direct Known Subclasses:

AbstractTranslationWithInternalDictionaryService

public abstract class AbstractTranslationService
extends AbstractLanguagePairService
implements TranslationService, BackTranslationService, MultihopTranslationService

Base class for the translation service.

Version:

$Revision: 507 $

Author:

$Author: t-nakaguchi $

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AbstractTranslationService.DivisionType

Field Summary

Fields inherited from class jp.go.nict.langrid.wrapper.ws_1_2.AbstractService

ALL_MATCHINGMETHODS, EMPTY_LANGUAGEPAIRS, EMPTY_LANGUAGEPATHS, EMPTY_LANGUAGES, MINIMUM_MATCHINGMETHODS

Constructor Summary

Constructors

Constructor and Description
AbstractTranslationService() Constructor that doesn't take parameter(s).
AbstractTranslationService(ServiceContext serviceContext) Constructor that takes the service context as a parameter(s).
AbstractTranslationService(ServiceContext serviceContext, Collection<LanguagePair> supportedPairs) Constructor that takes the service context and supported language pair(s) as a parameter(s).

Method Summary

Methods

Modifier and Type	Method and Description
BackTranslationResult	backTranslate(String sourceLang, String interMediateLang, String source) Runs back translation.
protected String[]	doMultistatementTranslation(Language sourceLang, Language targetLang, String[] sources)
protected abstract String	doTranslation(Language sourceLang, Language targetLang, String source) Template method supporting transtlate.
MultihopTranslationResult	multihopTranslate(String sourceLang, String[] intermediateLangs, String targetLang, String source) When the LanguagePathNotUnizuelyDecidedException occurs, only one language path data is returned as a candidate.
String	multistatementTranslate(String sourceLang, String targetLang, String source, String delimiterRegx)
void	setMaxSourceLength(int maxSourceLength)
void	setSentenceDivision(AbstractTranslationService.DivisionType sentenceDivision)
String	translate(String sourceLang, String targetLang, String source) Run translation.
protected LanguagePair	validateLanguagePair(LanguagePairValidator languagePair)

Methods inherited from class jp.go.nict.langrid.wrapper.ws_1_2.AbstractLanguagePairService

getSupportedLanguagePairCollection, getSupportedLanguagePairs, setSupportedLanguagePairs

Methods inherited from class jp.go.nict.langrid.wrapper.ws_1_2.AbstractService

acquireSemaphore, checkStartupException, convertLanguagePairs, convertLanguages, doGetLastUpdate, getCurrentServiceContext, getDoDoubleSearch, getEliminateDuplicates, getInitParameter, getInitParameterBoolean, getInitParameterInt, getInitParameterLong, getInitParameters, getInitParameterString, getInitParameterUsingTransformer, getLastUpdate, getLogListener, getMaxResults, getMaxWaitMillisForExternalProcess, getRequestMimeHeaders, getServiceContext, getWorkDirectory, getWorkFile, log, parseDateMacro, processEnd, processEnd, processLap, processStart, releaseSemaphore, setCurrentServiceContext, setDoubleSearchResults, setEliminateDuplicates, setLogListener, setMaxResults, setMaxThreads, setMaxWaitMillisForExternalProcess, setMaxWaitMillisForThread, setMeasureProcessTime, setProcessTimeWarningThreasholdMillis, setStartupException

Methods inherited from class jp.go.nict.langrid.servicecontainer.service.AbstractService

getComponentServiceFactory, getFile, getServiceName, setComponentServiceFactory, setServiceName

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractTranslationService

public AbstractTranslationService()

Constructor that doesn't take parameter(s).

AbstractTranslationService

public AbstractTranslationService(ServiceContext serviceContext)

Constructor that takes the service context as a parameter(s).

Parameters:

serviceContext - Service context

AbstractTranslationService

public AbstractTranslationService(ServiceContext serviceContext,
                          Collection<LanguagePair> supportedPairs)

Constructor that takes the service context and supported language pair(s) as a parameter(s).

Parameters:

serviceContext - Service context

supportedPairs - Supported language pairs

Method Detail

setMaxSourceLength

public void setMaxSourceLength(int maxSourceLength)

setSentenceDivision

public void setSentenceDivision(AbstractTranslationService.DivisionType sentenceDivision)

translate

public String translate(String sourceLang,
               String targetLang,
               String source)
                 throws AccessLimitExceededException,
                        InvalidParameterException,
                        LanguagePairNotUniquelyDecidedException,
                        NoAccessPermissionException,
                        NoValidEndpointsException,
                        ProcessFailedException,
                        ServerBusyException,
                        ServiceNotActiveException,
                        ServiceNotFoundException,
                        UnsupportedLanguagePairException

Description copied from interface: TranslationService

Run translation.

Specified by:

translate in interface TranslationService

Parameters:

sourceLang - Translation source language (RFC3066 compliant)

targetLang - Target language of the translation (RFC3066 compliant)

source - String to be translated

Returns:

The translated string

Throws:

AccessLimitExceededException - Violated an access restriction

InvalidParameterException - An invalid parameter was passed

LanguagePairNotUniquelyDecidedException - Multiple candidate language pairs exist

UnsupportedLanguagePairException - An unsupported language pair was specified

NoAccessPermissionException - The user executing the call lacks execution privileges

NoValidEndpointsException - There is no valid endpoint

ProcessFailedException - Translation process failed

ServerBusyException - The server is loaded and cannot process it.

ServiceNotActiveException - The service is not active

ServiceNotFoundException - The specified service was not found

backTranslate

public final BackTranslationResult backTranslate(String sourceLang,
                                  String interMediateLang,
                                  String source)
                                          throws AccessLimitExceededException,
                                                 InvalidParameterException,
                                                 LanguagePairNotUniquelyDecidedException,
                                                 NoAccessPermissionException,
                                                 NoValidEndpointsException,
                                                 ProcessFailedException,
                                                 ServerBusyException,
                                                 ServiceNotActiveException,
                                                 UnsupportedLanguagePairException

Description copied from interface: BackTranslationService

Runs back translation.

Specified by:

backTranslate in interface BackTranslationService

Parameters:

sourceLang - Translation source language (RFC3066 compliant)

interMediateLang - Intermediate language (RFC3066 compliant)

source - String to be translated

Returns:

Result of back translation

Throws:

AccessLimitExceededException - Violated an access restriction

InvalidParameterException - An invalid parameter was passed

LanguagePairNotUniquelyDecidedException - Multiple candidate language pairs exist

UnsupportedLanguagePairException - An unsupported language pair was specified

NoAccessPermissionException - The user executing the call lacks execution privileges

NoValidEndpointsException - There is no valid endpoint

ProcessFailedException - Response search failed due to some cause

ServerBusyException - The server is loaded and cannot process it.

ServiceNotActiveException - The service is not active

multihopTranslate

public final MultihopTranslationResult multihopTranslate(String sourceLang,
                                          String[] intermediateLangs,
                                          String targetLang,
                                          String source)
                                                  throws AccessLimitExceededException,
                                                         InvalidParameterException,
                                                         LanguagePathNotUniquelyDecidedException,
                                                         NoAccessPermissionException,
                                                         NoValidEndpointsException,
                                                         ProcessFailedException,
                                                         ServerBusyException,
                                                         ServiceNotActiveException,
                                                         UnsupportedLanguagePathException

When the LanguagePathNotUnizuelyDecidedException occurs, only one language path data is returned as a candidate. (It is not a formal interface, so the constructor of the language path data is omitted).

Specified by:

multihopTranslate in interface MultihopTranslationService

Parameters:

sourceLang - Translation source language (RFC3066 compliant)

intermediateLangs - Intermediate languages (RFC3066 compliant)

targetLang - Target language of the translation (RFC3066 compliant)

source - String to be translated

Returns:

Translated results

Throws:

AccessLimitExceededException - Violated an access restriction

InvalidParameterException - An invalid parameter was passed

LanguagePathNotUniquelyDecidedException - Multiple language path candidates were found

UnsupportedLanguagePathException - An unsupported language path was specified

NoAccessPermissionException - The user executing the call lacks execution privileges

NoValidEndpointsException - There is no valid endpoint

ProcessFailedException - Translation process failed

ServerBusyException - The server is loaded and cannot process it.

ServiceNotActiveException - Service not active

multistatementTranslate

public final String multistatementTranslate(String sourceLang,
                             String targetLang,
                             String source,
                             String delimiterRegx)
                                     throws AccessLimitExceededException,
                                            InvalidParameterException,
                                            LanguagePairNotUniquelyDecidedException,
                                            NoAccessPermissionException,
                                            NoValidEndpointsException,
                                            ProcessFailedException,
                                            ServerBusyException,
                                            ServiceNotActiveException,
                                            ServiceNotFoundException,
                                            UnsupportedLanguagePairException

Throws:

AccessLimitExceededException

InvalidParameterException

LanguagePairNotUniquelyDecidedException

NoAccessPermissionException

NoValidEndpointsException

ProcessFailedException

ServerBusyException

ServiceNotActiveException

ServiceNotFoundException

UnsupportedLanguagePairException

doMultistatementTranslation

protected String[] doMultistatementTranslation(Language sourceLang,
                                   Language targetLang,
                                   String[] sources)
                                        throws InvalidParameterException,
                                               ProcessFailedException

Throws:

InvalidParameterException

ProcessFailedException

doTranslation

protected abstract String doTranslation(Language sourceLang,
                   Language targetLang,
                   String source)
                                 throws InvalidParameterException,
                                        ProcessFailedException

Template method supporting transtlate.

Parameters:

sourceLang - Source language

targetLang - Target language

source - String to be translated

Returns:

The translated string

Throws:

InvalidParameterException - An invalid parameter was passed

ProcessFailedException - Process failed

validateLanguagePair

protected LanguagePair validateLanguagePair(LanguagePairValidator languagePair)
                                     throws InvalidParameterException,
                                            LanguagePairNotUniquelyDecidedException,
                                            UnsupportedLanguagePairException

Parameters:

languagePair -

Returns:

Throws:

InvalidParameterException - An invalid parameter was passed

LanguagePairNotUniquelyDecidedException - Multiple candidate language pairs exist

UnsupportedLanguagePairException - An unsupported language pair was specified