Belajar menggunakan mesin XML XQEngine

Penulis：Eve Cole Waktu Pembaruan：2009-07-07 16:09:39

Baru-baru ini saya mencari alat pencarian XML. Aplikasi yang saya tulis perlu mencari secara teratur beberapa file XML terkait. Niat awal saya adalah untuk melihat apakah ada data yang cocok dengan data yang saya inginkan di file tersebut, tetapi kadang-kadang, saya juga menginginkannya untuk menampilkan data yang saya temukan. Pada awalnya, saya mencoba XSLT dan XPath, berharap untuk mengubah masalah pencarian menjadi masalah yang dapat diselesaikan dengan menggunakan XSLT. Namun, setelah beberapa periode percobaan, saya menemukan bahwa menggunakan XSLT tidak benar-benar menyelesaikan masalah pencarian yang ingin saya selesaikan. Karena data yang ingin saya keluarkan adalah angka yang dipisahkan koma, dan XSLT tidak dapat memenuhi persyaratan ini, dan XLST tidak dapat menyediakan fungsionalitas pencarian teks lengkap. Kemudian saya ingin mencoba menggunakan XML Query Language (XQL) untuk melihat apakah saya bisa menyelesaikannya, jadi saya hati-hati melihat implementasi berbagai versi XQL. Secara kebetulan, saya menemukan alat kecil bernama XQEngine yang bisa menyelesaikan masalah ini. , jadi, dalam artikel ini saya ingin memperkenalkan cara menggunakan XQEngine untuk mencari data string yang ingin Anda temukan di file XML Anda.

XQEngine dapat ditemukan di www.fatdog.com. Ini adalah JavaBean yang menggunakan parser SAX untuk mengindeks satu atau lebih dokumen XML, dan kemudian Anda dapat melakukan pencarian kompleks dalam dokumen tersebut. Bahasa pencarian yang digunakannya adalah superset dari XQL dan memiliki sintaks yang mirip dengan XPath.

Kelas Java yang menggunakan XQEngine harus mengimplementasikan metode result(). Setelah menyelesaikan pencarian, mesin akan memanggil metode ini untuk meneruskan hasil pencarian ke metode result(). Tiga format untuk menampilkan data dapat digunakan untuk menampilkan hasil data. Gunakan parameter baris perintah untuk menentukan parameter pencarian yang Anda perlukan. Misalnya, Anda dapat menentukan bahwa file tidak akan diindeks jika berisi kata stop; atau Anda dapat memerintahkan mesin di parameter untuk mengabaikan kata-kata yang kurang dari yang ditentukan nomor.

Di bawah ini saya telah memberikan rutinitas penggunaan XQEngine, mari kita analisa sekarang. Pertama, metode main() membuat instance mesin pencari:, lalu memanggil metode setSaxParserName() untuk menyetel nama lengkap parser SAX. Karena kita menggunakan parser Xerces, kita perlu menggunakan "org.apache.xerces. parser.SAXParser". Kemudian kita perlu mengatur parameter pencarian, dalam hal ini kita tidak akan mengindeks angka atau kata apa pun yang kurang dari 3 karakter. Akan ada deskripsi detail parameter konfigurasi dalam dokumen API XQEngine yang Anda unduh, jadi saya tidak akan menjelaskan secara detail tentang cara mengonfigurasi parameter di sini. Terakhir, metode setDocument() menentukan file XML yang akan diindeks atau dicari oleh XQEngine. Tentu saja, jika Anda ingin mengindeks banyak file, Anda hanya perlu menyetel beberapa metode setDocument() yang sesuai.

Kita juga dapat melihat dari kode di bawah bahwa mesin XQEngine akan mengembalikan hasil pencarian dalam tiga format berbeda: STANDAR, RINGKASAN, dan CSV (menggunakan nilai yang dipisahkan koma). Untuk mempermudah, saya telah menetapkan satu untuk setiap jenis hasil pengembalian, bukan (). 1, 2, 3), lalu panggil metode setListenerType() dengan parameter yang sesuai. Saya akan menjelaskan setiap jenis hasil pengembalian secara detail nanti. Ada juga metode printSessionState() yang digunakan untuk menampilkan indeks dan informasi mesin, tetapi saya tidak menuliskannya ke dalam rutinitas, jadi program di atas hanya akan menampilkan hasil pencarian; pada langkah berikutnya, panggil metode addXQLResultListener() dan teruskan Pencarian Sebuah instance digunakan untuk mengimplementasikan antarmuka XQLResultListener, kemudian metode setQuery dipanggil dengan string kueri sebagai parameter, dan mesin akan mulai menjalankan tugas kueri. Setelah kueri selesai, mesin memanggil metode result() dari kelas Pencarian dan mengembalikan hasil kueri. Dalam rutinitas yang saya berikan, metode result() hanya menampilkan hasilnya.
Kode:

import java.io.*;
impor com.fatdog.textEngine.XmlEngine;
import com.fatdog.textEngine.Exceptions.*;
impor com.fatdog.textEngine.query.XQLResultListener;
Pencarian kelas publik mengimplementasikan XQLResultListener
{
public static void main( String[] args )
{
Mesin XmlEngine = XmlEngine baru();
String pencarianFile = args[0];
Tipe pencarian string = args[1];
Kueri string = args[2];
coba { file://configuration engine
engine.setSaxParserName( "org.apache.xerces.parsers.SAXParser");
mesin.setMinIndexableWordLength(3);
mesin.setDoIndexNumbers( false );
mesin.setDocument( searchFile );

if (searchType.equals("1")) {
mesin.setListenerType(
XmlEngine.STANDARD_LISTENER);
}
else if (searchType.equals("2")) {
mesin.setListenerType(
XmlEngine.SUMMARY_LISTENER);
}
kalau tidak {
mesin.setListenerType(
XmlEngine.CSV_LISTENER);
}
}
tangkapan( MissingOrInvalidSaxParserException e ){
Sistem.keluar.println(
"Pengurai SAX tidak ada atau tidak tersedia" );
kembali;
}
menangkap(FileNotFoundException e) {
Sistem.keluar.println(
"Tidak dapat menemukan file XML: ");
kembali;
}
menangkap(CantParseDocumentException e) {
Sistem.keluar.println(
"Tidak dapat mengurai file XML: ");
kembali;
}
// mesin.printSessionStats();
mesin.addXQLResultListener( Pencarian baru() );
mencoba {
mesin.setQuery( kueri );
}
tangkapan(InvalidQueryException e) {
Sistem.keluar.println(
"Permintaan kueri tidak tersedia: " + e.getMessage() );
kembali;
}
}
hasil kekosongan publik (String xqlResults)
{
Sistem.keluar.println(xqlResults);
}
}

Oke, kita telah menulis program menggunakan XQEngine, jadi mari kita jalankan kode ini. Sebelum mengkompilasi kode ini, kita perlu mendownload XQEngine dan parser SAX. Saya mengunduh parser Xerces dari xml.apache.org. Sistem operasi yang saya gunakan adalah Windows 2000 Professional, dan JDKnya adalah versi 1.3. OK, setelah Anda melakukan ini, ikuti saya untuk mengatur CLASSPATH. Ubah CLASSPATH di "Variabel Lingkungan" dan tambahkan "c:xqlXQEngine.jar ;c: xqlantlr.jar; c:xercesxerces.jar". Sekarang kodenya dapat dikompilasi, tetapi untuk menjalankan program, kita juga memerlukan file XML. Saya menggunakan file web.xml di Apache Tomcat sebagai demonstrasi. Seperti yang saya perkenalkan sebelumnya, kami menggunakan 1, 2, dan 3 untuk menggantikan tiga format hasil kueri pengembalian:

1. Gunakan STANDARD_LISTENER (nomor 1) dan item kueri "//welcome-file-list/welcome-file", C:xqlxql1>java Search web.xml 1 "//welcome-file-list/welcome- mengajukan "

Parser.installSaxParser:

berhasil diinstal
1: mengindeks web.xml
Pertanyaan: ( // ( / daftar-file-selamat datang-file-selamat datang ) )
3 klik untuk file://welcome-file-list/welcome-file
＜?xml versi="1.0"?＞
query="//daftar-file-selamat datang/file-selamat datang"
hitCount = "3"
elemCount="3"
docCount="1"
xmlns:xql="http://www.fatdog.com/ Standard_Listener.html">
＜file selamat datang＞
indeks.jsp
＜/file selamat datang＞
＜file selamat datang＞
indeks.html
＜/file selamat datang＞
＜file selamat datang＞
indeks.htm
＜/file selamat datang＞
＜/xql:hasil＞

Dalam contoh di atas, item kueri memerlukan pencarian semua sub-elemen "file selamat datang" dari elemen "daftar file selamat datang". Harap dicatat bahwa hasil pencarian pada dasarnya dikutip dari dokumen XML asli, dan hubungan antara hasil pencarian dan dokumen asli tidak dapat dibuat. Tipe pengembalian SUMMARY_LISTENER(2) agak berbeda. Ini mencakup nomor "docID" dan nomor "elemlx", sehingga hasilnya dapat dikaitkan dengan dokumen asli.

Berikut ini adalah contoh hasil yang dikembalikan:

C:xqlxql1>java Pencarian web.xml 2
"//daftar-file-selamat datang/file-selamat datang"
Parser.installSaxParser:
berhasil diinstal

1: mengindeks web.xml

Pertanyaan: ( // ( / daftar-file-selamat datang-file-selamat datang ) )

3 klik untuk file://welcome-file-list/welcome-file

＜?xml versi="1.0"?＞
query="//daftar-file-selamat datang/file-selamat datang"
hitCount = "3"
elemCount="3"
docCount="1"
xmlns:xql="http://www.fatdog.com/
Ringkasan_Listener.html">
＜file selamat datang xql:docID="0" xql:elemIx="270"/＞
＜file selamat datang xql:docID="0" xql:elemIx="271"/＞
＜file selamat datang xql:docID="0" xql:elemIx="272"/＞
＜/xql:hasil＞

Saya juga sudah mengatakan sebelumnya bahwa untuk aplikasi saya, yang terpenting adalah mengembalikan hasil yang dipisahkan dengan koma, jadi CSV_LISTENER(3) sangat berguna. Dapat mengembalikan hasil yang dipisahkan dengan koma, sebagai berikut:

C:xqlxql1>java Pencarian web.xml 3
"//daftar-file-selamat datang/file-selamat datang"
Parser.installSaxParser:

berhasil diinstal

1: mengindeks web.xml

Pertanyaan: ( // ( / daftar-file-selamat datang-file-selamat datang ) )

3 klik untuk file://welcome-file-list/welcome-file

3,3,1,0
0,270,file selamat datang
0,271,file selamat datang
0,272,file selamat datang

Tentu saja, XQEngine juga memiliki banyak fungsi yang kuat. Saya tidak dapat memperkenalkannya satu per satu di sini. Dokumentasi yang disertakan memiliki banyak sumber program dan metode penggunaan bersedia, Anda bahkan dapat mengembangkan program GUI. Dokumen tersebut dilengkapi dengan program pencarian berbasis GUI: SwingQueryDemo.