تعلم كيفية استخدام محرك XML XQEngine

الكاتب：Eve Cole وقت التحديث：2009-07-07 16:09:39

لقد كنت أبحث مؤخرًا عن أدوات بحث XML، يحتاج التطبيق الذي كتبته إلى البحث بانتظام في بعض ملفات XML ذات الصلة لإخراج البيانات التي وجدتها. في البداية قمت بتجريب XSLT و XPath، على أمل تحويل مشكلة البحث إلى مشكلة يمكن حلها باستخدام XSLT، لكن بعد فترة من التجارب، وجدت أن استخدام XSLT لم يحل مشكلة البحث التي أردت حلها حقًا. لأن البيانات التي أريد إخراجها هي أرقام مفصولة بفواصل، ولا يمكن لـ XSLT تلبية هذا المطلب، ولا يمكن لـ XLST توفير وظيفة البحث عن النص الكامل. ثم أردت أن أحاول استخدام لغة استعلام XML (XQL) لمعرفة ما إذا كان بإمكاني حلها، لذلك نظرت بعناية في تنفيذ الإصدارات المختلفة من XQL، وبالصدفة، وجدت أداة صغيرة تسمى XQEngine يمكنها حل هذه المشكلة. لذا، أود في هذه المقالة أن أعرض كيفية استخدام XQEngine للبحث عن بيانات السلسلة التي تريد العثور عليها في ملف XML الخاص بك.

يمكن العثور على XQEngine على www.fatdog.com وهو عبارة عن JavaBean يستخدم محلل SAX لفهرسة مستند XML واحد أو أكثر، ومن ثم يمكنك إجراء عمليات بحث معقدة في هذه المستندات. لغة البحث التي يستخدمها هي مجموعة شاملة من XQL ولها بناء جملة مشابه لـ XPath.

يجب على فئة Java التي تستخدم XQEngine تنفيذ طريقة النتيجة () بعد الانتهاء من البحث، سيقوم المحرك باستدعاء هذه الطريقة لتمرير نتائج البحث إلى طريقة النتيجة () ويمكن استخدام ثلاثة تنسيقات لعرض البيانات لإخراج نتائج البيانات. استخدم معلمات سطر الأوامر لتحديد معلمات البحث التي تحتاجها، على سبيل المثال، يمكنك تحديد عدم فهرسة الملف إذا كان يحتوي على كلمة توقف، أو يمكنك توجيه المحرك في المعلمات لتجاهل الكلمات الأقل من المحدد رقم.

أدناه، قدمت روتينًا باستخدام XQEngine، دعنا نحلله الآن. أولاً، تقوم الطريقة main() بإنشاء محرك بحث: ثم استدعاء طريقة setSaxParserName() لتعيين الاسم الكامل لمحلل SAX لأننا نستخدم محلل Xerces، نحتاج إلى استخدام "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() لفئة البحث ويعيد نتائج الاستعلام. في الروتين الذي قدمته، تقوم طريقة result() ببساطة بإخراج النتائج.
شفرة:

استيراد java.io.*;
import com.fatdog.textEngine.XmlEngine;
import com.fatdog.textEngine.exceptions.*;
import com.fatdog.textEngine.query.XQLResultListener;
يطبق بحث الفئة العامة XQLResultListener
{
الفراغ العام الثابت الرئيسي (String[] args)
{
محرك XmlEngine = جديد XmlEngine();
String searchFile = args[0];
String searchType = args[1];
استعلام السلسلة = args[2];
حاول { الملف: // محرك التكوين
Engine.setSaxParserName( "org.apache.xerces.parsers.SAXParser");
Engine.setMinIndexableWordLength(3);
Engine.setDoIndexNumbers(خطأ);
Engine.setDocument(searchFile);

إذا (searchType.equals("1")) {
محرك.setListenerType(
XmlEngine.STANDARD_LISTENER);
}
وإلا إذا (searchType.equals("2")) {
محرك.setListenerType(
XmlEngine.SUMMARY_LISTENER);
}
آخر {
محرك.setListenerType(
XmlEngine.CSV_LISTENER);
}
}
التقاط (MissingOrInvalidSaxParserException e ){
System.out.println(
"محلل SAX مفقود أو غير متوفر" );
يعود؛
}
قبض على (FileNotFoundException ه) {
System.out.println(
"لا يمكن العثور على ملف XML:");
يعود؛
}
الصيد (CantParseDocumentException e) {
System.out.println(
"لا يمكن تحليل ملف XML:");
يعود؛
}
// المحرك.printSessionStats();
Engine.addXQLResultListener(new Search() );
يحاول {
Engine.setQuery(استعلام);
}
التقاط (InvalidQueryException e) {
System.out.println(
"طلب استعلام غير متاح: " + e.getMessage() );
يعود؛
}
}
نتائج باطلة عامة (سلسلة 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. لقد استخدمت ملف 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 نقرات للملف://welcome-file-list/welcome-file
＜?xml الإصدار = "1.0"?＞
<xql:النتيجة
الاستعلام = "// قائمة ملف الترحيب/ملف الترحيب"
عدد النتائج = "3"
عدد العناصر = "3"
عدد المستندات = "1"
xmlns:xql="http://www.fatdog.com/ Standard_Listener.html">
＜ملف الترحيب＞
Index.jsp
＜/ملف الترحيب＞
＜ملف الترحيب＞
Index.html
＜/ملف الترحيب＞
＜ملف الترحيب＞
Index.htm
＜/ملف الترحيب＞
＜/xql:النتيجة＞

في المثال أعلاه، يتطلب عنصر الاستعلام العثور على جميع العناصر الفرعية "ملف الترحيب" لأي عنصر "قائمة ملف الترحيب". يرجى ملاحظة أن نتائج البحث مقتطفة بشكل أساسي من مستند XML الأصلي، ولا يمكن إنشاء العلاقة بين نتائج البحث والمستند الأصلي. يختلف نوع الإرجاع SUMMARY_LISTENER(2) إلى حد ما، فهو يتضمن رقم "docID" ورقم "elemlx"، بحيث يمكن ربط النتيجة بالمستند الأصلي.

وفيما يلي مثال على النتائج التي تم إرجاعها:

C:xqlxql1>بحث جافا web.xml 2
"// قائمة ملف الترحيب/ملف الترحيب"
Parser.installSaxParser: <org.Apache.xerces.parsers.SAXParser>
تم التثبيت بنجاح

1: فهرسة web.xml

الاستعلام: ( // ( / قائمة ملف الترحيب ملف الترحيب ) )

3 نقرات للملف://welcome-file-list/welcome-file

＜?xml الإصدار = "1.0"?＞
<xql:النتيجة
الاستعلام = "// قائمة ملف الترحيب/ملف الترحيب"
عدد النتائج = "3"
عدد العناصر = "3"
عدد المستندات = "1"
xmlns:xql = "http://www.fatdog.com/
Summary_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>بحث جافا web.xml 3
"// قائمة ملف الترحيب/ملف الترحيب"
Parser.installSaxParser:
<org.apache.xerces.parsers.SAXParser>
تم التثبيت بنجاح

1: فهرسة web.xml

الاستعلام: ( // ( / قائمة ملف الترحيب ملف الترحيب ) )

3 نقرات للملف://welcome-file-list/welcome-file

3,3,1,0
0,270، ملف الترحيب
0,271، ملف الترحيب
0,272، ملف الترحيب

بالطبع، يحتوي XQEngine أيضًا على العديد من الوظائف القوية، ولا يمكنني تقديمها واحدة تلو الأخرى هنا إذا كنت على استعداد، يمكنك حتى تطوير برنامج واجهة المستخدم الرسومية. يأتي المستند مع برنامج بحث قائم على واجهة المستخدم الرسومية: SwingQueryDemo. يمكنك إلقاء نظرة عليه ودراسته.