Cosminexus V9 ナビゲーション プラットフォーム 開発ガイド

[目次][用語][索引][前へ][次へ]

6.5.1 searchメソッド

検索を実行します。

<この項の構成>
(1) 形式
(2) 引数
(3) 戻り値
(4) 例外

(1) 形式

IHitData search(boolean guideFlag,boolean andFlag,int sortFlag,java.lang.String word)
                throws UCNPServerException;

(2) 引数

(a) guideFlag

ガイドごとの検索ヒット数の出力有無を指定します。

falseを指定した場合,戻り値に含まれるIHitContentDataオブジェクトのgetHitGuideDataListメソッドは常にnullを返します。

(b) andFlag

複数の要素を検索ワードとして指定するときのAND検索の有無を指定します。

(c) sortFlag

検索結果の業務コンテンツのソート順序を指定します。

業務コンテンツのソート順序には,SearcherConstantsクラスの次の定数のどれかを指定します。

SearcherConstantsクラスの定数の詳細は,「6.7 SearcherConstants(検索クラス)」を参照してください。

なお,不正な値を指定した場合はソートされません。

(d) word

検索ワードを指定します。検索を実行するとき,次に示す検索ワードの違いは区別されないので注意してください。

なお,指定した検索ワードは,部分一致で検索されます。例えば,「京都」という検索ワードを指定すると,「東京都」「京都市」などもヒットします。前方一致または後方一致の指定はできません。

指定できる検索ワードの条件を次に示します。

(3) 戻り値

検索結果のオブジェクト

wordパラメタにnull,空文字,またはスペースだけの文字列を指定した場合はnullを返します。

(4) 例外

UCNPServerException - 検索でエラーが発生した場合

このメソッドでエラーが発生した場合,検索は中断され,UCNPServerException例外がスローされます。エラーの一覧を次に示します。

表6-3 searchメソッドで発生するエラー一覧

エラー メッセージID
wordパラメタの文字数が500文字を超えている場合 KDCZ10206-E
wordパラメタに制御文字(ASCIIコードの0x00〜0x1Fと0x7F)が含まれている場合 KDCZ10207-E
wordパラメタに含まれる半角の引用符(")の使い方に誤りがある場合 KDCZ10208-E
wordパラメタの検索ワードの要素数が10個を超えている場合 KDCZ10209-E
ナビゲーション プラットフォームにログインしていない状態でこのメソッドを実行した場合 KDCZ10066-E
リソースアダプタが見つからない場合 KDCZ18028-E
リソースアダプタのホスト名が正しくない場合
データベースに検索用テーブルが存在しない場合
KDCZ18029-E
その他,環境不正などの場合 上記以外