jp.go.nict.langrid.wrapper.ws_1_2.bilingualdictionary

Class AbstractBilingualDictionaryService

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.bilingualdictionary.AbstractBilingualDictionaryService

All Implemented Interfaces:

BilingualDictionaryService

public abstract class AbstractBilingualDictionaryService
extends AbstractLanguagePairService
implements BilingualDictionaryService

$Id:AbstractBilingualDictionaryService.java 1495 2006-10-12 18:42:55 +0900 (Thu, 12 10 2006) nakaguchi $ Base class for the bilingual dictionary service

Version:

$Revision: 265 $

Author:

$Author: t-nakaguchi $

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
AbstractBilingualDictionaryService() Constructor.
AbstractBilingualDictionaryService(Collection<LanguagePair> supportedPairs) Constructor.
AbstractBilingualDictionaryService(ServiceContext context) Constructor.
AbstractBilingualDictionaryService(ServiceContext context, Collection<LanguagePair> supportedPairs) Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
protected abstract Collection<Translation>	doSearch(Language headLang, Language targetLang, String headWord, MatchingMethod matchingMethod)
protected Translation[]	doubleSearch(Translation[] result, String headWord, MatchingMethod matchingMethod)
String[]	getSupportedMatchingMethods() Returns the search methods supported by the dictionary wrapper.
Translation[]	search(String headLang, String targetLang, String headWord, String matchingMethod) Searches the bilingual dictionary using the specified search term(s) and matching method, and returns bilingual translation.
protected void	setSupportedMatchingMethods(Set<MatchingMethod> supportedMatchingMethods)

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

Methods inherited from interface jp.go.nict.langrid.service_1_2.bilingualdictionary.BilingualDictionaryService

getLastUpdate, getSupportedLanguagePairs

Constructor Detail

AbstractBilingualDictionaryService

public AbstractBilingualDictionaryService()

Constructor. It does not take parameter(s).

AbstractBilingualDictionaryService

public AbstractBilingualDictionaryService(ServiceContext context)

Constructor. Takes the set of supported language pairs as a parameter.

Parameters:

context - Service context

AbstractBilingualDictionaryService

public AbstractBilingualDictionaryService(Collection<LanguagePair> supportedPairs)

Constructor. Takes the set of supported language pairs as a parameter.

Parameters:

supportedPairs - Set of supported language pairs

AbstractBilingualDictionaryService

public AbstractBilingualDictionaryService(ServiceContext context,
                                  Collection<LanguagePair> supportedPairs)

Constructor. Takes the set of supported language pairs as a parameter.

Parameters:

context - Service context

supportedPairs - Set of supported language pairs

Method Detail

search

public Translation[] search(String headLang,
                   String targetLang,
                   String headWord,
                   String matchingMethod)
                     throws AccessLimitExceededException,
                            InvalidParameterException,
                            LanguagePairNotUniquelyDecidedException,
                            NoAccessPermissionException,
                            NoValidEndpointsException,
                            ProcessFailedException,
                            ServerBusyException,
                            ServiceNotActiveException,
                            ServiceNotFoundException,
                            UnsupportedLanguagePairException,
                            UnsupportedMatchingMethodException

Description copied from interface: BilingualDictionaryService

Searches the bilingual dictionary using the specified search term(s) and matching method, and returns bilingual translation.

Specified by:

search in interface BilingualDictionaryService

Parameters:

headLang - Source language of bilingual translation(RFC3066 compliant)

targetLang - Target language of bilingual translation (RFC3066 compliant)

headWord - Bilingual translation search phrase

matchingMethod - Matching method (one of either "COMPLETE","PREFIX","SUFFIX","PARTIAL","REGEX")

Returns:

Search results

Throws:

AccessLimitExceededException - Violated an access restriction

InvalidParameterException - One of either headLang,targetLang,searchMethod is null or else is an empty string. headLang or targetLang do not comply with RFC3066.String not provided for by searchMethod

LanguagePairNotUniquelyDecidedException - The bilingual translation language pair candidates could not be singly resolved(Ex:When headLang, or else targetLang is specified as zh, the case where zh-Hans and zh-Hant both exist as supported language pairs)

UnsupportedLanguagePairException - The specified language pair is not supported.

UnsupportedMatchingMethodException - The specified matching method is not supported

NoAccessPermissionException - The user executing the call lacks execution privileges

NoValidEndpointsException - There is no valid endpoint

ProcessFailedException - Search process failed

ServerBusyException - The server is loaded and cannot process it.

ServiceNotActiveException - The service is not active

ServiceNotFoundException - The specified service was not found

getSupportedMatchingMethods

public String[] getSupportedMatchingMethods()
                                     throws AccessLimitExceededException,
                                            NoAccessPermissionException,
                                            NoValidEndpointsException,
                                            ProcessFailedException,
                                            ServerBusyException,
                                            ServiceNotActiveException,
                                            ServiceNotFoundException

Description copied from interface: BilingualDictionaryService

Returns the search methods supported by the dictionary wrapper.

Specified by:

getSupportedMatchingMethods in interface BilingualDictionaryService

Returns:

Array of supported search methods

Throws:

AccessLimitExceededException - Violated an access restriction

NoAccessPermissionException - The user executing the call lacks execution privileges

NoValidEndpointsException - There is no valid endpoint

ProcessFailedException - Search process failed

ServerBusyException - The server is loaded and cannot process it.

ServiceNotActiveException - The service is not active

ServiceNotFoundException - The specified service was not found

setSupportedMatchingMethods

protected void setSupportedMatchingMethods(Set<MatchingMethod> supportedMatchingMethods)

doubleSearch

protected Translation[] doubleSearch(Translation[] result,
                         String headWord,
                         MatchingMethod matchingMethod)

doSearch

protected abstract Collection<Translation> doSearch(Language headLang,
                               Language targetLang,
                               String headWord,
                               MatchingMethod matchingMethod)
                                             throws InvalidParameterException,
                                                    ProcessFailedException

Throws:

InvalidParameterException

ProcessFailedException