เรียนรู้การใช้กลไก XML XQEngine

ผู้เขียน：Eve Cole เวลาอัปเดต：2009-07-07 16:09:39

เมื่อเร็วๆ นี้ ฉันมองหาเครื่องมือค้นหา XML แอปพลิเคชันที่ฉันเขียนจำเป็นต้องค้นหาไฟล์ XML ที่เกี่ยวข้องเป็นประจำ ความตั้งใจเดิมของฉันคือการดูว่ามีข้อมูลที่ตรงกับข้อมูลที่ฉันต้องการในไฟล์หรือไม่ แต่ก็มีบางครั้งฉันก็ต้องการเช่นกัน เพื่อส่งออกข้อมูลที่ฉันพบ ในตอนแรก ฉันลองใช้ XSLT และ XPath โดยหวังว่าจะเปลี่ยนปัญหาการค้นหาให้เป็นปัญหาที่สามารถแก้ไขได้โดยใช้ XSLT อย่างไรก็ตาม หลังจากการทดลองมาระยะหนึ่ง ฉันพบว่าการใช้ XSLT ไม่ได้แก้ปัญหาการค้นหาที่ฉันต้องการแก้ไขจริงๆ เนื่องจากข้อมูลที่ฉันต้องการส่งออกเป็นตัวเลขที่คั่นด้วยเครื่องหมายจุลภาค และ XSLT ไม่สามารถตอบสนองข้อกำหนดนี้ได้ และ XLST ไม่สามารถมีฟังก์ชันการค้นหาข้อความแบบเต็มได้ จากนั้นฉันก็อยากลองใช้ XML Query Language (XQL) เพื่อดูว่าจะแก้ปัญหาได้หรือไม่ ดังนั้นฉันจึงพิจารณาการใช้งาน XQL เวอร์ชันต่างๆ อย่างรอบคอบ โดยบังเอิญ ฉันบังเอิญพบเครื่องมือเล็กๆ ที่เรียกว่า XQEngine ที่สามารถแก้ปัญหานี้ได้ ดังนั้น ในบทความนี้ ฉันอยากจะแนะนำวิธีใช้ XQEngine เพื่อค้นหาข้อมูลสตริงที่คุณต้องการค้นหาในไฟล์ XML ของคุณ

XQEngine สามารถพบได้ที่ www.fatdog.com เป็น JavaBean ที่ใช้ SAX parser เพื่อสร้างดัชนีเอกสาร XML หนึ่งรายการขึ้นไป จากนั้นคุณสามารถค้นหาที่ซับซ้อนในเอกสารเหล่านี้ได้ ภาษาในการค้นหาที่ใช้คือชุดย่อยของ XQL และมีไวยากรณ์คล้ายกับ XPath

คลาส Java ที่ใช้ XQEngine ต้องใช้เมธอด result() หลังจากเสร็จสิ้นการค้นหา เอ็นจิ้นจะเรียกเมธอดนี้เพื่อส่งผลลัพธ์การค้นหาไปยังเมธอด result() ใช้พารามิเตอร์บรรทัดคำสั่งเพื่อระบุพารามิเตอร์การค้นหาที่คุณต้องการ ตัวอย่างเช่น คุณสามารถระบุได้ว่าไฟล์จะไม่ถูกจัดทำดัชนีหากมีคำว่าหยุด หรือคุณสามารถสั่งให้กลไกในพารามิเตอร์ละเว้นคำที่น้อยกว่าที่ระบุได้ ตัวเลข.

ด้านล่างนี้ ฉันได้กำหนดกิจวัตรโดยใช้ XQEngine แล้ว มาวิเคราะห์กันตอนนี้เลย ขั้นแรก เมธอด main() จะสร้างอินสแตนซ์ของเครื่องมือค้นหา: จากนั้นเรียกเมธอด setSaxParserName() เพื่อตั้งชื่อเต็มของ SAX parser เนื่องจากเราใช้ Xerces parser เราจึงจำเป็นต้องใช้ "org.apache.xerces parsers.SAXParser" จากนั้นเราจำเป็นต้องตั้งค่าพารามิเตอร์การค้นหา ในกรณีนี้ เราจะไม่สร้างดัชนีตัวเลขหรือคำใดๆ ที่น้อยกว่า 3 ตัวอักษร จะมีคำอธิบายพารามิเตอร์การกำหนดค่าโดยละเอียดในเอกสาร XQEngine API ที่คุณดาวน์โหลด ดังนั้นฉันจะไม่ลงรายละเอียดเกี่ยวกับวิธีกำหนดค่าพารามิเตอร์ที่นี่ โปรดดูเอกสารที่เกี่ยวข้องด้วยตนเอง สุดท้าย เมธอด setDocument() ระบุไฟล์ XML ที่ XQEngine จะสร้างดัชนีหรือค้นหา แน่นอนว่า หากคุณต้องการสร้างดัชนีหลายไฟล์ คุณจะต้องตั้งค่าเมธอด setDocument() ที่สอดคล้องกันหลายวิธีเท่านั้น

จากโค้ดด้านล่าง เรายังเห็นได้ว่ากลไก XQEngine จะส่งกลับผลการค้นหาในรูปแบบที่แตกต่างกันสามรูปแบบ: STANDARD, SUMMARY และ CSV (โดยใช้ค่าที่คั่นด้วยเครื่องหมายจุลภาค) เพื่อความง่าย ฉันได้กำหนดหนึ่งค่าสำหรับหมายเลขผลลัพธ์การส่งคืนแต่ละประเภทแทน ( 1, 2, 3) แล้วเรียกเมธอด setListenerType() ด้วยพารามิเตอร์ที่เกี่ยวข้อง ฉันจะอธิบายรายละเอียดผลลัพธ์การคืนสินค้าแต่ละประเภทในภายหลัง นอกจากนี้ยังมีเมธอด printSessionState() ที่ใช้ในการเอาท์พุตดัชนีและข้อมูลเอ็นจิ้น แต่ฉันไม่ได้เขียนมันลงในรูทีน ดังนั้นโปรแกรมด้านบนจะแสดงผลลัพธ์การค้นหาเท่านั้น ในขั้นตอนถัดไป ให้เรียกใช้เมธอด addXQLResultListener() แล้วส่งผ่าน ค้นหาอินสแตนซ์เพื่อใช้อินเทอร์เฟซ XQLResultListener จากนั้นเรียกใช้เมธอด setQuery โดยมีสตริงการสืบค้นเป็นพารามิเตอร์ และกลไกจะเริ่มดำเนินการงานการสืบค้น หลังจากการสืบค้นเสร็จสมบูรณ์ กลไกจะเรียกเมธอด result() ของคลาส Search และส่งกลับผลลัพธ์การสืบค้น ในรูทีนที่ฉันระบุ เมธอด result() จะแสดงผลลัพธ์ออกมา
รหัส:

นำเข้า java.io.*;
นำเข้า com.fatdog.textEngine.XmlEngine;
นำเข้า com.fatdog.textEngine.ข้อยกเว้น.*;
นำเข้า com.fatdog.textEngine.query.XQLResultListener;
การค้นหาคลาสสาธารณะใช้ XQLResultListener
-
โมฆะคงสาธารณะหลัก (สตริง [] args)
-
โปรแกรม XmlEngine = XmlEngine ใหม่ ();
สตริงการค้นหาไฟล์ = args [0];
สตริง searchType = args[1];
แบบสอบถามสตริง = args [2];
ลอง { file://configuration engine
engine.setSaxParserName( "org.apache.xerces.parsers.SAXParser");
engine.setMinIndexableWordLength(3);
engine.setDoIndexNumbers( เท็จ );
engine.setDocument( ค้นหาไฟล์ );

ถ้า (searchType.equals("1")) {
engine.setListenerType(
XmlEngine.STANDARD_LISTENER);
-
อื่นถ้า (searchType.equals("2")) {
engine.setListenerType(
XmlEngine.SUMMARY_LISTENER);
-
อื่น {
engine.setListenerType(
XmlEngine.CSV_LISTENER);
-
-
catch( MissingOrInvalidSaxParserException e ){
System.out.println(
"ตัวแยกวิเคราะห์ SAX หายไปหรือไม่พร้อมใช้งาน" );
กลับ;
-
จับ (FileNotFoundException จ) {
System.out.println(
"ไม่พบไฟล์ XML: ");
กลับ;
-
จับ (CantParseDocumentException e) {
System.out.println(
"ไม่สามารถแยกวิเคราะห์ไฟล์ XML: ");
กลับ;
-
// engine.printSessionStats();
engine.addXQLResultListener (ค้นหาใหม่ () );
พยายาม {
engine.setQuery(แบบสอบถาม);
-
จับ (InvalidQueryException จ) {
System.out.println(
"คำขอค้นหาไม่พร้อมใช้งาน: " + e.getMessage() );
กลับ;
-
-
ผลลัพธ์ที่เป็นโมฆะสาธารณะ ( String xqlResults )
-
System.out.println(xqlResults);
-
-

โอเค เราได้เขียนโปรแกรมโดยใช้ XQEngine ดังนั้นเรามารันโค้ดนี้ก่อน เราต้องดาวน์โหลด XQEngine และ SAX parser ก่อน ฉันดาวน์โหลด Xerces parser จาก xml.apache.org ระบบปฏิบัติการที่ฉันใช้คือ Windows 2000 Professional และ JDK เป็นเวอร์ชัน 1.3 หลังจากที่คุณดำเนินการนี้แล้ว ให้ติดตามฉันเพื่อตั้งค่า CLASSPATH ใน "ตัวแปรสภาพแวดล้อม" และเพิ่ม "c:xqlXQEngine.jar ;c: xqlantlr.jar; c:xercesxerces.jar" ตอนนี้สามารถคอมไพล์โค้ดได้ แต่เพื่อที่จะรันโปรแกรม เราจำเป็นต้องมีไฟล์ XML ด้วย ฉันใช้ไฟล์ web.xml ใน Apache Tomcat เป็นการสาธิต อย่างที่ผมแนะนำไปก่อนหน้านี้ เราใช้ 1, 2 และ 3 เพื่อแทนที่รูปแบบผลลัพธ์คิวรีส่งคืนสามรูปแบบ:

1. ใช้ STANDARD_LISTENER (หมายเลข 1) และรายการเคียวรี "//welcome-file-list/welcome-file", C:xqlxql1>java Search web.xml 1 "//welcome-file-list/welcome- ไฟล์ "

Parser.installSaxParser:

<org.apache.xerces.parsers.SAXParser>
ติดตั้งสำเร็จแล้ว
1: การจัดทำดัชนี web.xml
แบบสอบถาม: ( // ( / ยินดีต้อนรับรายการไฟล์ยินดีต้อนรับไฟล์ ) )
พบ 3 ครั้งสำหรับ file://welcome-file-list/welcome-file
＜?xml version="1.0"?>
<xql:ผลลัพธ์
query="//welcome-file-list/welcome-file"
ตีนับ = "3"
องค์ประกอบCount="3"
docCount="1"
xmlns:xql="http://www.fatdog.com/ Standard_Listener.html">
<ไฟล์ต้อนรับ>
ดัชนี.jsp
</ยินดีต้อนรับไฟล์>
<ไฟล์ต้อนรับ>
ดัชนี.html
</ยินดีต้อนรับไฟล์>
<ไฟล์ต้อนรับ>
index.htm
</ยินดีต้อนรับไฟล์>
＜/xql:ผลลัพธ์><

ในตัวอย่างข้างต้น รายการเคียวรีจำเป็นต้องค้นหาองค์ประกอบย่อย "welcome-file" ทั้งหมดขององค์ประกอบ "welcome-file-list" ใดๆ โปรดทราบว่าผลการค้นหานั้นโดยพื้นฐานแล้วคัดลอกมาจากเอกสาร XML ต้นฉบับ และไม่สามารถสร้างความสัมพันธ์ระหว่างผลการค้นหากับเอกสารต้นฉบับได้ ประเภทการส่งคืนของ SUMMARY_LISTENER(2) ค่อนข้างแตกต่างออกไป โดยจะมีหมายเลข "docID" และหมายเลข "elemlx" เพื่อให้สามารถเชื่อมโยงผลลัพธ์กับเอกสารต้นฉบับได้

ต่อไปนี้เป็นตัวอย่างของผลลัพธ์ที่ส่งคืน:

C:xqlxql1>java ค้นหา web.xml 2
"//ยินดีต้อนรับ-รายการไฟล์/ยินดีต้อนรับ-ไฟล์"
Parser.installSaxParser: <org.apache.xerces.parsers.SAXParser>
ติดตั้งสำเร็จแล้ว

1: การจัดทำดัชนี web.xml

แบบสอบถาม: ( // ( / ยินดีต้อนรับรายการไฟล์ยินดีต้อนรับไฟล์ ) )

พบ 3 ครั้งสำหรับ file://welcome-file-list/welcome-file

＜?xml version="1.0"?>
<xql:ผลลัพธ์
query="//welcome-file-list/welcome-file"
ตีนับ = "3"
องค์ประกอบCount="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:
<org.apache.xerces.parsers.SAXParser>
ติดตั้งสำเร็จแล้ว

1: การจัดทำดัชนี web.xml

แบบสอบถาม: ( // ( / ยินดีต้อนรับรายการไฟล์ยินดีต้อนรับไฟล์ ) )

พบ 3 ครั้งสำหรับ file://welcome-file-list/welcome-file

3,3,1,0
0,270,ยินดีต้อนรับ-ไฟล์
0,271,ยินดีต้อนรับ-ไฟล์
0,272,ยินดีต้อนรับ-ไฟล์

แน่นอนว่า XQEngine มีฟังก์ชันอันทรงพลังมากมาย ฉันไม่สามารถแนะนำพวกมันทีละอันได้ที่นี่ เอกสารที่มาพร้อมกับโปรแกรมต้นฉบับและวิธีการใช้งานมากมาย คุณสามารถเรียนรู้การใช้งานมันได้ด้วยตัวเอง ยินดีที่คุณสามารถพัฒนาโปรแกรม GUI ได้ เอกสารนี้มาพร้อมกับโปรแกรมค้นหาแบบ GUI: SwingQueryDemo คุณสามารถดูและศึกษาได้