jp.go.nict.langrid.service_1_2.bilingualdictionary
インタフェース BilingualDictionaryService

既知のサブインタフェースの一覧:
BilingualDictionaryHeadwordsExtractionService, BilingualDictionaryWithLongestMatchSearchService
既知の実装クラスの一覧:
AbstractBilingualDictionaryService, AbstractBilingualDictionaryWithLongestMatchSearchService, AxisBilingualDictionaryWithLongestMatchSearchServiceExecutor, BilingualDictionaryService, BilingualDictionaryService, BilingualDictionaryWithLongestMatchSearch, BilingualDictionaryWithLongestMatchSearch, PbBilingualDictionaryWithLongestMatchSearchServiceExecutor, RewordingDictionaryService

public interface BilingualDictionaryService

対訳辞書サービスのインタフェースを定義します. 対訳辞書サービスを提供する場合,このインタフェースを実装すれば, langridから提供されるクライアントを使ってアクセスできます.

バージョン:
$Revision: 10411 $
作成者:
$Author: Takao Nakaguchi $

メソッドの概要
 Calendar getLastUpdate()
          辞書データの最終更新日を返す。
 LanguagePair[] getSupportedLanguagePairs()
          辞書の対応言語を取得する。
 String[] getSupportedMatchingMethods()
          辞書ラッパーが対応している検索手法を返す。
 Translation[] search(String headLang, String targetLang, String headWord, String matchingMethod)
          指定された検索語・検索方法で対訳辞書を検索し、対訳を返します。
 

メソッドの詳細

search

Translation[] search(String headLang,
                     String targetLang,
                     String headWord,
                     String matchingMethod)
                     throws AccessLimitExceededException,
                            InvalidParameterException,
                            LanguagePairNotUniquelyDecidedException,
                            NoAccessPermissionException,
                            NoValidEndpointsException,
                            ProcessFailedException,
                            ServerBusyException,
                            ServiceNotActiveException,
                            ServiceNotFoundException,
                            UnsupportedLanguagePairException,
                            UnsupportedMatchingMethodException
指定された検索語・検索方法で対訳辞書を検索し、対訳を返します。

パラメータ:
headLang - 対訳の元言語(RFC3066準拠)
targetLang - 対訳の対象言語(RFC3066準拠)
headWord - 対訳を検索する語
matchingMethod - マッチング方法("COMPLETE","PREFIX","SUFFIX","PARTIAL","REGEX"のいずれか)
戻り値:
検索結果
例外:
AccessLimitExceededException - アクセス制限に違反した
InvalidParameterException - headLang,targetLang,searchMethodのいずれかがnullまたは空文字列.headLang,targetLangがRFC3066に準拠していない.searchMethodが規定されている以外の文字列
LanguagePairNotUniquelyDecidedException - 対訳言語対候補が一意に求まらない(例:headLangもしくはtargetLangにzhを指定したときに,対応言語対にzh-Hansとzh-Hantが存在した場合)
NoAccessPermissionException - 呼び出しを行ったユーザに実行権限が無い
NoValidEndpointsException - 有効なエンドポイントが無い
ProcessFailedException - 検索処理に失敗した
ServerBusyException - サーバが混雑していて処理が実行できない
ServiceNotActiveException - サービスはアクティブではない
ServiceNotFoundException - 指定されたサービスが見つからない
UnsupportedLanguagePairException - 指定された言語対はサポートされていない
UnsupportedMatchingMethodException - 指定されたマッチング方法はサポートされていない

getSupportedLanguagePairs

LanguagePair[] getSupportedLanguagePairs()
                                         throws AccessLimitExceededException,
                                                NoAccessPermissionException,
                                                NoValidEndpointsException,
                                                ProcessFailedException,
                                                ServerBusyException,
                                                ServiceNotActiveException,
                                                ServiceNotFoundException
辞書の対応言語を取得する。

戻り値:
言語の配列
例外:
AccessLimitExceededException - アクセス制限に違反した
NoAccessPermissionException - 呼び出しを行ったユーザに実行権限が無い
NoValidEndpointsException - 有効なエンドポイントが無い
ProcessFailedException - 検索処理に失敗した
ServerBusyException - サーバが混雑していて処理が実行できない
ServiceNotActiveException - サービスはアクティブではない
ServiceNotFoundException - 指定されたサービスが見つからない

getSupportedMatchingMethods

String[] getSupportedMatchingMethods()
                                     throws AccessLimitExceededException,
                                            NoAccessPermissionException,
                                            NoValidEndpointsException,
                                            ProcessFailedException,
                                            ServerBusyException,
                                            ServiceNotActiveException,
                                            ServiceNotFoundException
辞書ラッパーが対応している検索手法を返す。

戻り値:
対応している検索方法の配列
例外:
AccessLimitExceededException - アクセス制限に違反した
NoAccessPermissionException - 呼び出しを行ったユーザに実行権限が無い
NoValidEndpointsException - 有効なエンドポイントが無い
ProcessFailedException - 検索処理に失敗した
ServerBusyException - サーバが混雑していて処理が実行できない
ServiceNotActiveException - サービスはアクティブではない
ServiceNotFoundException - 指定されたサービスが見つからない

getLastUpdate

Calendar getLastUpdate()
                       throws AccessLimitExceededException,
                              NoAccessPermissionException,
                              NoValidEndpointsException,
                              ProcessFailedException,
                              ServerBusyException,
                              ServiceNotActiveException,
                              ServiceNotFoundException
辞書データの最終更新日を返す。

戻り値:
最終更新日
例外:
AccessLimitExceededException - アクセス制限に違反した
NoAccessPermissionException - 呼び出しを行ったユーザに実行権限が無い
NoValidEndpointsException - 有効なエンドポイントが無い
ProcessFailedException - 検索処理に失敗した
ServerBusyException - サーバが混雑していて処理が実行できない
ServiceNotActiveException - サービスはアクティブではない
ServiceNotFoundException - 指定されたサービスが見つからない