DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> XML學習教程 >> XML詳解
以 XQEngine 為 XML 文件打造可查詢的搜尋引擎
編輯:XML詳解     

為什麼不用 XSLT

我曾花了不少時間尋找合適的 XML 搜尋工具。手邊的應用程式需要定期搜尋一批彼此關聯的 XML 檔,先確認裡面是否有符合條件的資料,接著把命中的部分輸出來。

最初的直覺是改用 XSLT 與 XPath,把搜尋問題轉化成 XSLT 能處理的形式。但試了一段時間後發現,XSLT 並沒有真正解決問題:我需要輸出以逗號分隔的數值,XSLT 做不到;它也不提供全文搜尋能力。於是轉而研究 XML 查詢語言(XQL)的各種實作,正好找到一個名為 XQEngine 的小工具能勝任,本文就來說明如何使用它。

XQEngine 是什麼

XQEngine 可從 www.fatdog.com 取得。它是一個 JavaBean,使用 SAX 解析器為一個或多個 XML 文件建立索引,之後就能在這些文件裡進行複合式搜尋。它採用的查詢語言是 XQL 的超集,語法與 XPath 相近。

程式結構

使用 XQEngine 的 Java 類別必須實作一個 results() 方法。搜尋完成後,引擎會呼叫這個方法把結果傳回。輸出格式共有三種可選。此外也能透過命令列參數控制行為,例如指定某檔案若含有 stop 這個詞就不建立索引,或要求引擎忽略少於指定字數的詞。

範例程式碼

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 {
      // 配置引擎
      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 );
  }
}

程式流程說明

main() 先建立引擎執行個體,接著從命令列取得三個參數:檔名、結果格式、查詢請求。然後依序設定 SAX 解析器的完整類別名稱(範例使用 Xerces,故為 org.apache.xerces.parsers.SAXParser)、索引參數(本例不索引數字,且忽略少於 3 個字元的詞),最後以 setDocument() 指定要索引的 XML 檔——若要索引多個檔案,多呼叫幾次即可。

三種輸出格式以數字 1、2、3 對應 STANDARD、SUMMARY 與 CSV(逗號分隔數值),透過 setListenerType() 切換。另有 printSessionState() 可輸出索引與引擎狀態,範例中將它註解掉了。

接著以 addXQLResultListener() 註冊一個 Search 執行個體(實作 XQLResultListener 介面),再用 setQuery() 傳入查詢字串,引擎便開始工作;查詢結束後回呼 results(),範例中只是簡單把結果印出。

編譯與執行

執行前需下載 XQEngine 與 SAX 解析器(我從 xml.apache.org 取得 Xerces)。環境為 Windows 2000 Professional、JDK 1.3。接著在「環境變數」中修改 CLASSPATH,加入:

c:\xql\XQEngine.jar;c:\xql\antlr.jar; c:\xerces\xerces.jar

之後即可編譯。為了實際跑起來,還需要一份 XML 檔——我借用 apache Tomcat 裡的 web.XML 作為示範。

三種輸出格式對比

STANDARD_LISTENER(1),查詢 //welcome-file-list/welcome-file:

C:\xql>Java Search web.XML 1 "//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"?>
<xql:result
query="//welcome-file-list/welcome-file"
hitCount="3" elemCount="3" docCount="1"
xmlns:xql="https://www.fatdog.com/Standard_Listener.html">
<welcome-file>
index.jsp
</welcome-file>
<welcome-file>
index.html
</welcome-file>
<welcome-file>
index.htm
</welcome-file>
</xql:result>

查詢要求找出 welcome-file-list 元素底下所有的 welcome-file 子元素。請注意,這種格式的結果基本上是把原文摘錄出來,無法建立結果與原始文件之間的對應關係。

SUMMARY_LISTENER(2) 則多了 docID 與 elemIx 兩個屬性,正好能解決上述問題:

<xql:result
query="//welcome-file-list/welcome-file"
hitCount="3" elemCount="3" docCount="1"
xmlns:xql="https://www.fatdog.com/Summary_Listener.html">
<welcome-file xql:docID="0" xql:elemIx="270"/>
<welcome-file xql:docID="0" xql:elemIx="271"/>
<welcome-file xql:docID="0" xql:elemIx="272"/>
</xql:result>

CSV_LISTENER(3) 對我的應用來說最實用,直接輸出逗號分隔的數值:

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

3,3,1,0
0,270,welcome-file
0,271,welcome-file
0,272,welcome-file

結語

XQEngine 的能耐遠不只上述這些。隨附文件中有豐富的程式碼與用法說明,值得對照研讀;甚至還附了一個 GUI 搜尋範例 SwingQueryDemo,有興趣做圖形介面的話可以直接從它下手。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved