Apprenez à utiliser le moteur XML XQEngine

Auteur：Eve Cole Date de mise à jour：2009-07-07 16:09:39

Récemment, j'ai recherché des outils de recherche XML. L'application que j'ai écrite doit rechercher régulièrement certains fichiers XML associés. Mon intention initiale était de voir s'il y avait des données correspondant aux données que je souhaitais dans le fichier, mais parfois, je veux aussi. pour afficher les données que j'ai trouvées. Au début, j'ai essayé XSLT et XPath, dans l'espoir de transformer le problème de recherche en un problème pouvant être résolu à l'aide de XSLT. Cependant, après une période d'expérimentation, j'ai découvert que l'utilisation de XSLT ne résolvait pas vraiment le problème de recherche que je souhaitais résoudre. Parce que les données que je souhaite générer sont des nombres séparés par des virgules, que XSLT ne peut pas répondre à cette exigence et que XLST ne peut pas fournir de fonctionnalité de recherche en texte intégral. Ensuite, j'ai voulu essayer d'utiliser le langage de requête XML (XQL) pour voir si je pouvais le résoudre, j'ai donc soigneusement examiné l'implémentation de différentes versions de XQL. Par coïncidence, j'ai trouvé un petit outil appelé XQEngine qui pourrait résoudre ce problème. , donc, dans cet article, j'aimerais vous présenter comment utiliser XQEngine pour rechercher les données de chaîne que vous souhaitez trouver dans votre fichier XML.

XQEngine peut être trouvé sur www.fatdog.com. Il s'agit d'un JavaBean qui utilise un analyseur SAX pour indexer un ou plusieurs documents XML, et vous pouvez ensuite effectuer des recherches complexes dans ces documents. Le langage de recherche qu'il utilise est un sur-ensemble de XQL et possède une syntaxe similaire à XPath.

La classe Java utilisant XQEngine doit implémenter une méthode result(). Une fois la recherche terminée, le moteur appellera cette méthode pour transmettre les résultats de la recherche à la méthode result(). Trois formats d'affichage des données peuvent être utilisés pour afficher les résultats des données. Utilisez les paramètres de ligne de commande pour spécifier les paramètres de recherche dont vous avez besoin. Par exemple, vous pouvez spécifier qu'un fichier ne sera pas indexé s'il contient le mot stop ou vous pouvez demander au moteur dans les paramètres d'ignorer les mots inférieurs à ceux spécifiés. nombre.

Ci-dessous, j'ai donné une routine utilisant XQEngine, analysons-la maintenant. Tout d'abord, la méthode main() instancie un moteur de recherche : , puis appelle la méthode setSaxParserName() pour définir le nom complet de l'analyseur SAX. Parce que nous utilisons l'analyseur Xerces, nous devons utiliser "org.apache.xerces. analyseurs.SAXParser". Ensuite, nous devons définir les paramètres de recherche, dans ce cas, nous n'indexerons pas les nombres ni les mots de moins de 3 caractères. Il y aura des descriptions détaillées des paramètres de configuration dans le document de l'API XQEngine que vous avez téléchargé, je n'entrerai donc pas dans les détails sur la façon de configurer les paramètres ici. Veuillez vous référer vous-même aux documents pertinents. Enfin, la méthode setDocument() spécifie le fichier XML que XQEngine indexera ou recherchera. Bien entendu, si vous souhaitez indexer plusieurs fichiers, il vous suffit de définir plusieurs méthodes setDocument() correspondantes.

Nous pouvons également voir dans le code ci-dessous que le moteur XQEngine renverra les résultats de recherche dans trois formats différents : STANDARD, SUMMARY et CSV (en utilisant des valeurs séparées par des virgules, j'en ai défini un pour chaque type de résultat de retour au lieu de (). 1, 2, 3), puis appelez la méthode setListenerType() avec les paramètres correspondants. Je décrirai chaque type de résultat de retour en détail plus tard. Il existe également une méthode printSessionState() utilisée pour générer des informations sur l'index et le moteur, mais je ne l'ai pas écrite dans la routine, donc le programme ci-dessus affichera uniquement les résultats de la recherche à l'étape suivante, appellera la méthode addXQLResultListener() et transmettra. l'instance Search An est utilisée pour implémenter l'interface XQLResultListener ; puis la méthode setQuery est appelée avec la chaîne de requête comme paramètre et le moteur commencera à exécuter la tâche de requête. Une fois la requête terminée, le moteur appelle la méthode result() de la classe Search et renvoie les résultats de la requête. Dans la routine que j'ai fournie, la méthode result() génère simplement les résultats.
Code:

importer java.io.* ;
importer com.fatdog.textEngine.XmlEngine ;
importer com.fatdog.textEngine.exceptions.* ;
importer com.fatdog.textEngine.query.XQLResultListener ;
La recherche de classe publique implémente XQLResultListener
{
public static void main (String[] arguments)
{
Moteur XmlEngine = new XmlEngine();
Chaîne searchFile = args[0];
Chaîne searchType = args[1];
Requête de chaîne = args[2] ;
essayez { fichier://moteur de configuration
engine.setSaxParserName( "org.apache.xerces.parsers.SAXParser");
moteur.setMinIndexableWordLength(3);
moteur.setDoIndexNumbers( false );
moteur.setDocument( searchFile );

if (searchType.equals("1")) {
moteur.setListenerType(
XmlEngine.STANDARD_LISTENER);
}
sinon if (searchType.equals("2")) {
moteur.setListenerType(
XmlEngine.SUMMARY_LISTENER);
}
autre {
moteur.setListenerType(
XmlEngine.CSV_LISTENER);
}
}
catch( MissingOrInvalidSaxParserException e ){
System.out.println(
"Analyseur SAX manquant ou indisponible" );
retour;
}
catch(FileNotFoundException e) {
System.out.println(
"Impossible de trouver le fichier XML : ");
retour;
}
catch (CantParseDocumentException e) {
System.out.println(
"Impossible d'analyser le fichier XML : ");
retour;
}
// moteur.printSessionStats();
moteur.addXQLResultListener( new Search() );
essayer {
moteur.setQuery( requête );
}
catch (InvalidQueryException e) {
System.out.println(
"Demande de requête indisponible : " + e.getMessage() );
retour;
}
}
résultats publics vides (String xqlResults)
{
System.out.println(xqlResults);
}
}

D'accord, nous avons écrit un programme utilisant XQEngine, alors exécutons ce code. Avant de compiler ce code, nous devons télécharger XQEngine et l'analyseur SAX. J'ai téléchargé l'analyseur Xerces depuis xml.apache.org. Le système d'exploitation que j'utilise est Windows 2000 Professionnel et le JDK est la version 1.3. OK, après avoir fait cela, suivez-moi pour configurer CLASSPATH dans "Variables d'environnement" et ajoutez "c:xqlXQEngine.jar. ;c: xqlantlr.jar; c:xercesxerces.jar". Le code peut maintenant être compilé, mais pour exécuter le programme, nous avons également besoin d'un fichier XML. J'ai utilisé le fichier web.xml dans Apache Tomcat comme démonstration. Comme je l'ai présenté précédemment, nous utilisons 1, 2 et 3 pour remplacer les trois formats de résultat de requête de retour :

1. Utilisez STANDARD_LISTENER (numéro 1) et l'élément de requête "//welcome-file-list/welcome-file", C:xqlxql1>java Search web.xml 1 "//welcome-file-list/welcome- déposer "

Parser.installSaxParser :

<org.apache.xerces.parsers.SAXParser>
installé avec succès
1 : indexation du fichier web.xml
Requête : ( // ( / liste-fichier-accueil-fichier-accueil ) )
3 résultat(s) pour le fichier://welcome-file-list/welcome-file
＜?version XML="1.0"?＞
<xql:résultat
query="//liste-de-fichiers-de-bienvenue/fichier-de-bienvenue"
hitCount="3"
elemCount="3"
docCount="1"
xmlns:xql="http://www.fatdog.com/Standard_Listener.html">
＜fichier de bienvenue＞
index.jsp
＜/fichier-de-bienvenue＞
＜fichier de bienvenue＞
index.html
＜/fichier-de-bienvenue＞
＜fichier de bienvenue＞
index.htm
＜/fichier-de-bienvenue＞
＜/xql:résultat＞

Dans l'exemple ci-dessus, l'élément de requête nécessite de trouver tous les sous-éléments « welcome-file » de tout élément « welcome-file-list ». Veuillez noter que les résultats de la recherche sont essentiellement extraits du document XML original et que la relation entre les résultats de la recherche et le document original ne peut pas être établie. Le type de retour de SUMMARY_LISTENER(2) est quelque peu différent. Il inclut un numéro « docID » et un numéro « elemlx », afin que le résultat puisse être associé au document original.

Voici un exemple de résultats renvoyés :

C:xqlxql1>java Recherche web.xml 2
"//liste-de-fichiers-de-bienvenue/fichier-de-bienvenue"
Parser.installSaxParser : <org.apache.xerces.parsers.SAXParser>
installé avec succès

1 : indexation du fichier web.xml

Requête : ( // ( / liste-fichier-accueil-fichier-accueil ) )

3 résultat(s) pour le fichier://welcome-file-list/welcome-file

＜?version XML="1.0"?＞
<xql:résultat
query="//liste-de-fichiers-de-bienvenue/fichier-de-bienvenue"
hitCount="3"
elemCount="3"
docCount="1"
xmlns:xql="http://www.fatdog.com/
Résumé_Listener.html">
＜fichier de bienvenue xql:docID="0" xql:elemIx="270"/＞
＜fichier de bienvenue xql:docID="0" xql:elemIx="271"/＞
＜fichier de bienvenue xql:docID="0" xql:elemIx="272"/＞
＜/xql:résultat＞

J'ai aussi dit auparavant que pour mon application, le plus important est de renvoyer des résultats séparés par des virgules, donc CSV_LISTENER(3) est très utile. Il peut renvoyer un résultat séparé par des virgules, comme suit :

C:xqlxql1>java Recherche web.xml 3
"//liste-de-fichiers-de-bienvenue/fichier-de-bienvenue"
Parser.installSaxParser :
<org.apache.xerces.parsers.SAXParser>
installé avec succès

1 : indexation du fichier web.xml

Requête : ( // ( / liste-fichier-accueil-fichier-accueil ) )

3 résultat(s) pour le fichier://welcome-file-list/welcome-file

3,3,1,0
0,270,fichier de bienvenue
0,271,fichier de bienvenue
0,272,fichier de bienvenue

Bien sûr, XQEngine possède également de nombreuses fonctions puissantes. Je ne peux pas les présenter une par une ici. La documentation qui l'accompagne contient une multitude de programmes sources et de méthodes d'utilisation. Vous pouvez bien sûr apprendre à les utiliser par vous-même. le souhaitez, vous pouvez Vous pouvez même développer un programme GUI. Le document est livré avec un programme de recherche basé sur une GUI : SwingQueryDemo Vous pouvez y jeter un œil et l'étudier.