使用XQEngine來搜索XML文件內容

時間：2024-07-07 20:14:59 XML DOM 我要投稿

相關推薦

　　最近我一直在尋找XML搜索工具，我編寫的應用程序需要定期的搜索一些有關聯(lián)的XML文件，我本來的意思是為了看一看文件中是否有與我想要的數(shù)據匹配的數(shù)據，但是有時候，我也想把找到的這些數(shù)據輸出出來。一開始，我試用了一下XSLT和XPath，想通過把搜索的問題轉化成使用XSLT能夠解決的問題，但是經過一段時間的試驗，我發(fā)現(xiàn)，使用XSLT并沒有真正解決我想要處理的搜索問題，因為我想要輸出的數(shù)據是使用逗號隔開的數(shù)，而XSLT不能滿足這個要求，而且XLST也不能提供全文搜索功能。然后我想嘗試一下使用XML查詢語言(XQL)，來看看能不能解決，所以我仔細的著了一下XQL的各種版本的實現(xiàn)，很巧，正好發(fā)現(xiàn)一個叫XQEngine的小工具能解決這個問題，所以，在本文中我想介紹一下如何使用XQEngine來在你的XML文件中搜尋你想要找的字符串數(shù)據。

　　XQEngine可以在www.fatdog.com網站下找到，它是一個JavaBean，使用一個SAX解析器來索引一個或多個XML文檔，然后你就可以在這些文檔中進行復合式搜索了。它所使用的搜索語言是XQL的超集，與XPath有相似的語法。

　　使用XQEngine的Java類必須實現(xiàn)一個result()方法，完成搜索后，引擎將調用這個方法把搜索結果傳到result()方法中，可以使用三種顯示數(shù)據的格式來輸出數(shù)據結果。使用命令行參數(shù)指明你所需要的搜索參數(shù)，比如說你可以指明一個文件假如含有stop這個詞，就不會被索引；又如你可以在參數(shù)中命令引擎忽略那些少于指定子數(shù)的詞。

　　下面，我給出了一個使用XQEngine的例程，現(xiàn)在讓我們來分析一下。首先，main()方法實例化一個搜索引擎：XmlEngine engine = new XmlEngine()，然后它從命令行中取得文件名、返回結果格式和搜索請求這三個參數(shù)，再使用各種配置方法來設置引擎，接著調用setSaxParserName()方法來設置SAX解析器的全名，因為我們使用的是Xerces解析器，所以要用到 "org.apache.xerces.parsers.SAXParser"。然后我們就需要設置搜索參數(shù)，再本例中，我們將不索引數(shù)字或任何少于3個字符的詞。在你下載到的XQEngine的API文檔當中會有詳細的配置參數(shù)說明，所以在此我就不細說如何配置參數(shù)了，請大家自己參閱相關文檔。最后，setDocument()方法指定XQEngine將要索引或搜索的XML文件。當然，如果你想要索引多個文件的話，只需設置幾個相應的setDocument()方法就可以了。

　　從下面的代碼中我們還可以看到，XQEngine引擎將用三種不同的格式返回搜索結果：STANDARD、SUMMARY和CSV（使用逗號分開的數(shù)值)為了簡單起見，我為每種返回結果類型定義了一個數(shù)字來代替（1，2，3），然后使用相應的參數(shù)調用setListenerType()方法。我將在后面詳細介紹每一種返回結果類型。還有個方法printSessionState()用來輸出索引和引擎的信息，但是我沒有把它寫進例程中，所以上面的程序只會輸出搜索結果；下一步再調用addXQLResultListener()方法，并傳遞Search的一個實例，用來實現(xiàn)XQLResultListener的接口；然后再把查詢字符串作為一個參數(shù)來調用setQuery方法，引擎就會開始執(zhí)行查詢任務。等到查詢結束后，引擎調用Search類的result()方法，把查詢結果傳回，在我提供的例程中，result()方法只是簡單的把結果輸出出來。

　　代碼：

　　import java.io.*;

　　import com.fatdog.textEngine.XmlEngine;

　　import com.fatdog.textEngine.exceptions.*;

　　import com.fatdog.textEngine.query.XQLResultListener;

　　public class Search implements XQLResultListener

　　{

　　public static void main( String[] args )

　　{

　　XmlEngine engine = new XmlEngine();

　　String searchFile = args[0];

　　String searchType = args[1];

　　String query = args[2];

　　try { 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);

　　}

　　else {

　　engine.setListenerType(

　　XmlEngine.CSV_LISTENER);

　　}

　　catch( MissingOrInvalidSaxParserException e ){

　　System.out.println(

　　"缺少或不可用的 SAX解析器" );

　　return;

　　}

　　catch( FileNotFoundException e ) {

　　System.out.println(

　　"不能找到 XML 文件: ");

　　return;

　　}

　　catch( CantParseDocumentException e ) {

　　System.out.println(

　　"不能解析 XML 文件: ");

　　return;

　　}

　　// engine.printSessionStats();

　　engine.addXQLResultListener( new Search() );

　　try {

　　engine.setQuery( query );

　　}

　　catch( InvalidQueryException e ) {

　　System.out.println(

　　"不可用的查詢請求: " + e.getMessage() );

　　return;

　　}

　　public void results( String xqlResults )

　　{

　　System.out.println( xqlResults );

　　}

　　好，我們已經把一個使用XQEngine的程序編寫出來了，那么就讓我們來運行這段代碼，在編譯這段代碼之前，我們需要下載到XQEngine和SAX解析器。我是從xml.apache.org上下載到Xerces解析器的。我使用的操作系統(tǒng)是Windows 2000 Professional，JDK為1.3版，好，搞定這些以后就跟我來設置CLASSPATH吧，在"環(huán)境變量"中修改CLASSPATH，添加"c:xqlXQEngine.jar;c:xqlantlr.jar; c:xercesxerces.jar"�，F(xiàn)在就可以編譯代碼了，不過為了能夠運行程序，我們還需要一個XML文件，我使用了Apache Tomcat里的web.xml文件作為演示。前面我也介紹過了，我們使用1，2，3來分別代替三種返回查詢結果格式：

　　1、使用STANDARD_LISTENER (數(shù)字1)和查詢項"//welcome-file-list/welcome-file"，C:xqlxql1＞java Search web.xml 1 "//welcome-file-list/welcome-file"

　　Parser.installSaxParser:

　�。紀rg.apache.xerces.parsers.SAXParser＞

　　installed successfully

　　1: indexing web.xml

　　Query: ( // ( / welcome-file-list welcome-file ) )

　　3 hit(s) for file://welcome-file-list/welcome-file

　�。�?xml version="1.0"?＞

　　＜xql:result

　　query="//welcome-file-list/welcome-file"

　　hitCount="3"

　　elemCount="3"

　　docCount="1"

　　xmlns:xql="http://www.fatdog.com/ Standard_Listener.html"＞

　�。紈elcome-file＞

　　index.jsp

　�。�/welcome-file＞

　�。紈elcome-file＞

　　index.html

　�。�/welcome-file＞

　�。紈elcome-file＞

　　index.htm

　�。�/welcome-file＞

　�。�/xql:result＞

　　上面的例子中，查詢項要求找到任何"welcome-file-list"元素的所有的"welcome-file"子元素。請注意，搜索的結果基本上是從原XML文檔中摘錄出來的，不能夠建立搜索結果和原文檔之間的關系。SUMMARY_LISTENER(2)返回類型則有些不同，它包括一個"docID"號和一個"elemlx"號，這樣就能夠把結果和原文檔聯(lián)系起來了。

　　如下是返回結果的示例：

　　C:xqlxql1＞java Search web.xml 2

　　"//welcome-file-list/welcome-file"

　　Parser.installSaxParser: ＜org.apache.xerces.parsers.SAXParser＞

　　installed successfully

　　1: indexing web.xml

　　Query: ( // ( / welcome-file-list welcome-file ) )

　　3 hit(s) for file://welcome-file-list/welcome-file

　　＜?xml version="1.0"?＞

　�。紉ql:result

　　query="//welcome-file-list/welcome-file"

　　hitCount="3"