XML エンジン XQEngine の使い方を学ぶ

著者：Eve Cole 更新時間：2009-07-07 16:09:39

最近、私が作成したアプリケーションでは、関連する XML ファイルを定期的に検索する必要があります。その目的は、ファイル内に必要なデータと一致するデータがあるかどうかを確認することでした。見つけたデータを出力します。最初は、検索問題を XSLT を使用して解決できる問題に変換したいと考えて、XSLT と XPath を試しました。しかし、しばらく実験した後、XSLT を使用しても、私が解決したい検索問題を実際には解決できないことがわかりました。出力したいデータはカンマ区切りの数値であり、XSLT はこの要件を満たすことができず、XLST は全文検索機能を提供できないためです。そこで、XML Query Language (XQL) を使用してこの問題を解決できるかどうかを試してみたいと思い、XQL のさまざまなバージョンの実装を注意深く調べました。偶然、この問題を解決できる XQEngine という小さなツールを見つけました。 , そこで今回は、XQEngineを使ってXMLファイルの中から探したい文字列データを検索する方法を紹介したいと思います。

XQEngine は www.fatdog.com にあります。これは、SAX パーサーを使用して 1 つ以上の XML ドキュメントにインデックスを付け、これらのドキュメント内で複雑な検索を実行できる JavaBean です。使用する検索言語は XQL のスーパーセットであり、XPath と似た構文を持っています。

XQEngine を使用する Java クラスは、result() メソッドを実装する必要があります。検索が完了すると、エンジンはこのメソッドを呼び出して、データを表示するための 3 つの形式を使用してデータ結果を出力できます。コマンドラインパラメーターを使用して、必要な検索パラメーターを指定します。たとえば、ファイルに stop という単語が含まれる場合はインデックスを作成しないように指定したり、指定した単語よりも小さい単語を無視するようにパラメーターでエンジンに指示したりできます。番号。

以下に、XQEngine を使用したルーチンを示しました。これを分析してみましょう。まず、main() メソッドは検索エンジンをインスタンス化します。次に setSaxParserName() メソッドを呼び出して、SAX パーサーの完全名を設定します。Xerces パーサーを使用しているため、「org.apache.xerces.パーサー.SAXParser」。次に、検索パラメータを設定する必要があります。この場合、数字や 3 文字未満の単語にはインデックスを付けません。ダウンロードした XQEngine API ドキュメントに詳細な設定パラメータの説明があるため、ここではパラメータの設定方法については詳しく説明しません。関連するドキュメントを参照してください。最後に、setDocument() メソッドは、XQEngine がインデックス付けまたは検索する XML ファイルを指定します。もちろん、複数のファイルにインデックスを付けたい場合は、対応する setDocument() メソッドをいくつか設定するだけで済みます。

以下のコードから、XQEngine エンジンが 3 つの異なる形式で検索結果を返すこともわかります: STANDARD、SUMMARY、および CSV (カンマ区切り値を使用)。 1、2、3)、対応するパラメータを指定して setListenerType() メソッドを呼び出します。各戻り結果の型については後ほど詳しく説明します。インデックスとエンジン情報を出力するために使用されるメソッド printSessionState() もありますが、これをルーチンに記述しなかったので、上記のプログラムは次のステップで検索結果を出力するだけで、 addXQLResultListener() メソッドを呼び出して渡します。 Search An インスタンスを使用して XQLResultListener インターフェイスを実装し、クエリ文字列をパラメータとして setQuery メソッドを呼び出し、エンジンがクエリタスクの実行を開始します。クエリが完了すると、エンジンは Search クラスの result() メソッドを呼び出し、クエリ結果を返します。このルーチンでは、result() メソッドは単に結果を出力します。
コード：

java.io.* をインポートします。
com.fatdog.textEngine.XmlEngine をインポートします。
com.fatdog.textEngine.Exceptions.* をインポートします。
com.fatdog.textEngine.query.XQLResultListener をインポートします。
パブリッククラス Search は XQLResultListener を実装します
{
public static void main( String[] args )
{
XmlEngine エンジン = new XmlEngine();
文字列検索ファイル = args[0];
文字列検索タイプ = args[1];
文字列クエリ = args[2];
{ file://構成エンジンを試してください
Engine.setSaxParserName( "org.apache.xerces.parsers.SAXParser");
Engine.setMinIndexableWordLength(3);
Engine.setDoIndexNumbers( false );
Engine.setDocument( searchFile );

if (searchType.equals("1")) {
Engine.setListenerType(
XmlEngine.STANDARD_LISTENER);
}
else if (searchType.equals("2")) {
Engine.setListenerType(
XmlEngine.SUMMARY_LISTENER);
}
それ以外 {
Engine.setListenerType(
XmlEngine.CSV_LISTENER);
}
}
catch( MissingOrInvalidSaxParserException e ){
System.out.println(
"SAX パーサーが見つからないか、利用できません" );
戻る;
}
catch(FileNotFoundException e) {
System.out.println(
"XML ファイルが見つかりません: ");
戻る;
}
catch(CantParseDocumentException e) {
System.out.println(
"XML ファイルを解析できません: ");
戻る;
}
// エンジン.printSessionStats();
Engine.addXQLResultListener( new Search() );
試す {
Engine.setQuery(クエリ);
}
catch(InvalidQueryException e) {
System.out.println(
"利用できないクエリリクエスト: " + e.getMessage() );
戻る;
}
}
public void results( String xqlResults )
{
System.out.println(xqlResults);
}
}

さて、XQEngine を使用してプログラムを作成したので、このコードを実行しましょう。このコードをコンパイルする前に、XQEngine と SAX パーサーをダウンロードする必要があります。 Xerces パーサーを xml.apache.org からダウンロードしました。私が使用しているオペレーティングシステムは Windows 2000 Professional で、JDK はバージョン 1.3 です。これが完了したら、「環境変数」の CLASSPATH を変更し、「c:xqlXQEngine.jar」を追加します。 ;c: xqlantlr.jar; c:xercesxerces.jar"。これでコードをコンパイルできるようになりましたが、プログラムを実行するには XML ファイルも必要です。デモとして Apache Tomcat の web.xml ファイルを使用しました。前に紹介したように、1、2、3 を使用して、返される 3 つのクエリ結果形式を置き換えます。

1. STANDARD_LISTENER (番号 1) とクエリ項目「//welcome-file-list/welcome-file」を使用します。C:xqlxql1>java Search web.xml 1 "//welcome-file-list/welcome-ファイル "

Parser.installSaxParser:

正常にインストールされました
1: web.xml のインデックス作成
クエリ: ( // ( / ウェルカムファイルリストウェルカムファイル ) )
file://welcome-file-list/welcome-file の 3 件のヒット
＜?xmlバージョン="1.0"?＞
query="//ウェルカムファイルリスト/ウェルカムファイル"
ヒットカウント = "3"
elemCount="3"
docCount="1"
xmlns:xql="http://www.fatdog.com/Standard_Listener.html">
＜ウェルカムファイル＞
インデックス.jsp
＜/ウェルカムファイル＞
＜ウェルカムファイル＞
インデックス.html
＜/ウェルカムファイル＞
＜ウェルカムファイル＞
インデックス.htm
＜/ウェルカムファイル＞
＜/xql:結果＞

上記の例では、クエリ項目は、任意の「welcome-file-list」要素のすべての「welcome-file」サブ要素を検索する必要があります。検索結果は基本的に元のXML文書からの抜粋であり、検索結果と元の文書との関連性は確立できませんのでご了承ください。 SUMMARY_LISTENER(2) の戻り値の型は若干異なり、結果を元のドキュメントに関連付けることができるように、「docID」番号と「elemlx」番号が含まれています。

以下は返される結果の例です。

C:xqlxql1>java web.xml を検索 2
"//ウェルカムファイルリスト/ウェルカムファイル"
Parser.installSaxParser:
正常にインストールされました

1: web.xml のインデックス作成

クエリ: ( // ( / ウェルカムファイルリストウェルカムファイル ) )

file://welcome-file-list/welcome-file の 3 件のヒット

＜?xmlバージョン="1.0"?＞
query="//ウェルカムファイルリスト/ウェルカムファイル"
ヒットカウント = "3"
elemCount="3"
docCount="1"
xmlns:xql="http://www.fatdog.com/
概要_Listener.html">
＜ウェルカムファイル xql:docID="0" xql:elemIx="270"/＞
＜ウェルカムファイル xql:docID="0" xql:elemIx="271"/＞
＜ウェルカムファイル xql:docID="0" xql:elemIx="272"/＞
＜/xql:結果＞

また、私のアプリケーションにとって最も重要なことは、カンマで区切られた結果を返すことであると前に述べました。そのため、次のように、CSV_LISTENER(3) はカンマで区切られた結果を返すことができ、非常に便利です。

C:xqlxql1>java web.xml を検索 3
"//ウェルカムファイルリスト/ウェルカムファイル"
Parser.installSaxParser:

正常にインストールされました

1: web.xml のインデックス作成

クエリ: ( // ( / ウェルカムファイルリストウェルカムファイル ) )

file://welcome-file-list/welcome-file の 3 件のヒット

3,3,1,0
0,270,ウェルカムファイル
0,271,ウェルカムファイル
0,272,ウェルカムファイル

もちろん、XQEngine には多くの強力な機能があり、ここで 1 つずつ紹介することはできません。もちろん、付属のドキュメントには豊富なソースプログラムと使用方法が記載されています。 GUI プログラムを開発することもできます。このドキュメントには GUI ベースの検索プログラム SwingQueryDemo が付属しています。それを見て勉強することができます。