jp.go.nict.langrid.service_1_2.adjacencypair

Interface AdjacencyPairService

All Known Implementing Classes:

AbstractAdjacencyPairService, AdjacencyPairService

public interface AdjacencyPairService

Defines the interface for the adjacency pair service. If you're providing the adjacency pair service, then if you implement this class, you can access it with a client provided by langrid.

Version:

$Revision: 587 $

Author:

$Author: t-nakaguchi $

Method Summary

Methods

Modifier and Type	Method and Description
AdjacencyPair[]	search(String category, String language, String firstTurn, String matchingMethod) Gets a list of responses corresponding to the specified utterance.

Method Detail

search

AdjacencyPair[] search(String category,
                     String language,
                     String firstTurn,
                     String matchingMethod)
                       throws AccessLimitExceededException,
                              InvalidParameterException,
                              NoAccessPermissionException,
                              NoValidEndpointsException,
                              LanguageNotUniquelyDecidedException,
                              ProcessFailedException,
                              ServerBusyException,
                              ServiceNotActiveException,
                              ServiceNotFoundException,
                              UnsupportedLanguageException,
                              UnsupportedMatchingMethodException

Gets a list of responses corresponding to the specified utterance.

Parameters:

category - Category. an empty string when omitted

language - Language of utterance (RFC3066 compliant.)

firstTurn - Utterance(required)

matchingMethod - Search method (MatchingMethod enumerated value)

Returns:

Search results

Throws:

AccessLimitExceededException - Violated an access restriction

InvalidParameterException - language, firstPart or searchMethod is null or else an empty string.language does not comply with RFC3066. String not provided for by searchMethod

NoAccessPermissionException - The user executing the call lacks execution privileges

NoValidEndpointsException - There is no valid endpoint

LanguageNotUniquelyDecidedException - A supported language candidate could not be singly determined (Ex: when the language is specified as zh, the case where zh-Hans and zh-Hant exist as supported languages)

ProcessFailedException - Response search failed due to some cause

ServerBusyException - The server is loaded and cannot process it.

ServiceNotActiveException - The service is not active

ServiceNotFoundException - The specified service was not found

UnsupportedLanguageException - The specified language is not supported

UnsupportedMatchingMethodException - The specified matching method is not supported