Erfahren Sie, wie Sie die XML-Engine XQEngine verwenden

Autor：Eve Cole Aktualisierungszeit：2009-07-07 16:09:39

Kürzlich habe ich nach XML-Suchtools gesucht, die regelmäßig einige verwandte XML-Dateien durchsuchen müssen. Meine ursprüngliche Absicht war es, zu sehen, ob Daten mit den gewünschten Daten in der Datei übereinstimmen, aber manchmal möchte ich auch um die gefundenen Daten auszugeben. Zuerst habe ich XSLT und XPath ausprobiert, in der Hoffnung, das Suchproblem in ein Problem umzuwandeln, das mit XSLT gelöst werden könnte. Nach einer Zeit des Experimentierens stellte ich jedoch fest, dass die Verwendung von XSLT das Suchproblem, das ich lösen wollte, nicht wirklich löste. Da es sich bei den Daten, die ich ausgeben möchte, um durch Kommas getrennte Zahlen handelt, kann XSLT diese Anforderung nicht erfüllen und XLST kann keine Volltextsuchfunktion bereitstellen. Dann wollte ich es mit XML Query Language (XQL) versuchen, um zu sehen, ob ich es lösen könnte, also habe ich mir die Implementierung verschiedener Versionen von XQL genau angesehen. Zufälligerweise habe ich ein kleines Tool namens XQEngine gefunden, das dieses Problem lösen konnte. Daher möchte ich in diesem Artikel vorstellen, wie Sie mit XQEngine nach den Zeichenfolgendaten suchen, die Sie in Ihrer XML-Datei finden möchten.

XQEngine ist unter www.fatdog.com zu finden. Es handelt sich um eine JavaBean, die einen SAX-Parser verwendet, um ein oder mehrere XML-Dokumente zu indizieren, und Sie können dann komplexe Suchvorgänge in diesen Dokumenten durchführen. Die verwendete Suchsprache ist eine Obermenge von XQL und hat eine ähnliche Syntax wie XPath.

Die Java-Klasse, die XQEngine verwendet, muss eine result()-Methode implementieren. Nach Abschluss der Suche ruft die Engine diese Methode auf, um die Suchergebnisse an die result()-Methode zu übergeben. Verwenden Sie Befehlszeilenparameter, um die von Ihnen benötigten Suchparameter anzugeben. Sie können beispielsweise festlegen, dass eine Datei nicht indiziert wird, wenn sie das Wort „Stopp“ enthält, oder Sie können die Engine in den Parametern anweisen, Wörter zu ignorieren, die kleiner als die angegebenen sind Nummer.

Unten habe ich eine Routine mit XQEngine angegeben. Lassen Sie uns sie jetzt analysieren. Zuerst instanziiert die Methode main() eine Suchmaschine und ruft dann die Methode setSaxParserName() auf, um den vollständigen Namen des SAX-Parsers festzulegen. Da wir den Xerces-Parser verwenden, müssen wir „org.apache.xerces“ verwenden. parsers.SAXParser". Dann müssen wir die Suchparameter festlegen. In diesem Fall werden keine Zahlen oder Wörter mit weniger als 3 Zeichen indiziert. Detaillierte Beschreibungen der Konfigurationsparameter finden Sie in dem von Ihnen heruntergeladenen XQEngine-API-Dokument, daher werde ich hier nicht näher auf die Konfiguration der Parameter eingehen. Bitte lesen Sie selbst die entsprechenden Dokumente. Schließlich gibt die Methode setDocument() die XML-Datei an, die XQEngine indizieren oder durchsuchen wird. Wenn Sie mehrere Dateien indizieren möchten, müssen Sie natürlich nur mehrere entsprechende setDocument()-Methoden festlegen.

Aus dem folgenden Code können wir auch ersehen, dass die XQEngine-Engine Suchergebnisse in drei verschiedenen Formaten zurückgibt: STANDARD, ZUSAMMENFASSUNG und CSV (unter Verwendung von durch Kommas getrennten Werten) habe ich eines für jeden Rückgabeergebnistyp anstelle von () definiert. 1, 2, 3) und rufen Sie dann die Methode setListenerType() mit den entsprechenden Parametern auf. Ich werde jeden Rückgabeergebnistyp später im Detail beschreiben. Es gibt auch eine Methode printSessionState() zur Ausgabe von Index- und Engine-Informationen, aber ich habe sie nicht in die Routine geschrieben, daher gibt das obige Programm im nächsten Schritt nur die Suchergebnisse aus, ruft die Methode addXQLResultListener() auf und übergibt sie Die Suchinstanz wird verwendet, um die XQLResultListener-Schnittstelle zu implementieren. Anschließend wird die setQuery-Methode mit der Abfragezeichenfolge als Parameter aufgerufen und die Engine beginnt mit der Ausführung der Abfrageaufgabe. Nachdem die Abfrage abgeschlossen ist, ruft die Engine die Methode result() der Klasse Search auf und gibt die Abfrageergebnisse zurück. In der von mir bereitgestellten Routine gibt die Methode result() einfach die Ergebnisse aus.
Code:

java.io.* importieren;
import com.fatdog.textEngine.XmlEngine;
import com.fatdog.textEngine.Exceptions.*;
import com.fatdog.textEngine.query.XQLResultListener;
Die öffentliche Klasse Search implementiert XQLResultListener
{
public static void main( String[] args )
{
XmlEngine engine = new XmlEngine();
String searchFile = args[0];
String searchType = args[1];
String-Abfrage = args[2];
Versuchen Sie es mit { file://configuration engine
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);
}
anders {
engine.setListenerType(
XmlEngine.CSV_LISTENER);
}
}
Catch( MissingOrInvalidSaxParserException e ){
System.out.println(
„Fehlender oder nicht verfügbarer SAX-Parser“ );
zurückkehren;
}
Catch(FileNotFoundException e) {
System.out.println(
„Kann XML-Datei nicht finden:“);
zurückkehren;
}
Catch(CantParseDocumentException e) {
System.out.println(
„XML-Datei kann nicht geparst werden:“);
zurückkehren;
}
// engine.printSessionStats();
engine.addXQLResultListener( new Search() );
versuchen {
engine.setQuery( query );
}
Catch(InvalidQueryException e) {
System.out.println(
"Nicht verfügbare Abfrageanforderung: " + e.getMessage() );
zurückkehren;
}
}
public void results( String xqlResults )
{
System.out.println(xqlResults);
}
}

Okay, wir haben ein Programm mit XQEngine geschrieben, also führen wir diesen Code aus. Bevor wir diesen Code kompilieren, müssen wir XQEngine und den SAX-Parser herunterladen. Ich habe den Xerces-Parser von xml.apache.org heruntergeladen. Das Betriebssystem, das ich verwende, ist Windows 2000 Professional und das JDK ist Version 1.3. Nachdem Sie dies getan haben, folgen Sie mir, um CLASSPATH in „Umgebungsvariablen“ einzurichten und „c:xqlXQEngine.jar“ hinzuzufügen ;c: xqlantlr.jar; c:xercesxerces.jar". Jetzt kann der Code kompiliert werden, aber um das Programm auszuführen, benötigen wir auch eine XML-Datei. Zur Demonstration habe ich die Datei web.xml in Apache Tomcat verwendet. Wie ich bereits erwähnt habe, verwenden wir 1, 2 und 3, um die drei Ergebnisformate der Rückgabeabfrage zu ersetzen:

1. Verwenden Sie STANDARD_LISTENER (Nummer 1) und das Abfrageelement „//welcome-file-list/welcome-file“, C:xqlxql1>java Search web.xml 1 „//welcome-file-list/welcome- Datei "

Parser.installSaxParser:

erfolgreich installiert
1: Indizierung von web.xml
Abfrage: ( // ( / Welcome-File-List Welcome-File ) )
3 Treffer für Datei://welcome-file-list/welcome-file
＜?xml version="1.0"?＞
query="//welcome-file-list/welcome-file"
hitCount="3"
elemCount="3"
docCount="1"
xmlns:xql="http://www.fatdog.com/ Standard_Listener.html">
＜Willkommensdatei＞
index.jsp
＜/welcome-file＞
＜Willkommensdatei＞
index.html
＜/welcome-file＞
＜Willkommensdatei＞
index.htm
＜/welcome-file＞
＜/xql:result＞

Im obigen Beispiel erfordert das Abfrageelement das Finden aller „welcome-file“-Unterelemente eines beliebigen „welcome-file-list“-Elements. Bitte beachten Sie, dass es sich bei den Suchergebnissen grundsätzlich um Auszüge aus dem Original-XML-Dokument handelt und ein Zusammenhang zwischen den Suchergebnissen und dem Originaldokument nicht hergestellt werden kann. Der Rückgabetyp von SUMMARY_LISTENER(2) ist etwas anders. Er enthält eine „docID“-Nummer und eine „elemlx“-Nummer, damit das Ergebnis dem Originaldokument zugeordnet werden kann.

Das Folgende ist ein Beispiel für zurückgegebene Ergebnisse:

C:xqlxql1>java Search web.xml 2
"//welcome-file-list/welcome-file"
Parser.installSaxParser:
erfolgreich installiert

1: Indizierung von web.xml

Abfrage: ( // ( / Welcome-File-List Welcome-File ) )

3 Treffer für Datei://welcome-file-list/welcome-file

＜?xml version="1.0"?＞
query="//welcome-file-list/welcome-file"
hitCount="3"
elemCount="3"
docCount="1"
xmlns:xql="http://www.fatdog.com/
Summary_Listener.html">
＜Willkommensdatei xql:docID="0" xql:elemIx="270"/＞
＜Willkommensdatei xql:docID="0" xql:elemIx="271"/＞
＜Willkommensdatei xql:docID="0" xql:elemIx="272"/＞
＜/xql:result＞

Ich habe auch bereits gesagt, dass es für meine Anwendung am wichtigsten ist, durch Kommas getrennte Ergebnisse zurückzugeben. Daher ist CSV_LISTENER(3) sehr nützlich. Es kann wie folgt ein durch Kommas getrenntes Ergebnis zurückgeben:

C:xqlxql1>java Search web.xml 3
"//welcome-file-list/welcome-file"
Parser.installSaxParser:

erfolgreich installiert

1: Indizierung von web.xml

Abfrage: ( // ( / Welcome-File-List Welcome-File ) )

3 Treffer für Datei://welcome-file-list/welcome-file

3,3,1,0
0,270,Willkommensdatei
0,271,Willkommensdatei
0,272,Willkommensdatei

Natürlich verfügt XQEngine auch über viele leistungsstarke Funktionen, die ich hier nicht einzeln vorstellen kann. Sie können natürlich lernen, sie selbst zu verwenden Wenn Sie bereit sind, können Sie sogar ein GUI-Programm entwickeln. Das Dokument enthält ein GUI-basiertes Suchprogramm: SwingQueryDemo.