Aprende a utilizar el motor XML XQEngine

Autor：Eve Cole Fecha de actualización：2009-07-07 16:09:39

Recientemente he estado buscando herramientas de búsqueda XML. La aplicación que escribí necesita buscar periódicamente algunos archivos XML relacionados. Mi intención original era ver si hay datos que coincidan con los datos que quiero en el archivo, pero a veces también los hay. para generar los datos que encontré. Al principio, probé XSLT y XPath, con la esperanza de transformar el problema de búsqueda en un problema que pudiera resolverse usando XSLT. Sin embargo, después de un período de experimentación, descubrí que usar XSLT realmente no resolvió el problema de búsqueda que quería resolver. Porque los datos que quiero generar son números separados por comas, XSLT no puede cumplir con este requisito y XLST no puede proporcionar la función de búsqueda de texto completo. Luego quise intentar usar el lenguaje de consulta XML (XQL) para ver si podía resolverlo, así que miré detenidamente la implementación de varias versiones de XQL. Casualmente, encontré una pequeña herramienta llamada XQEngine que podía resolver este problema. Por lo tanto, en este artículo me gustaría presentarles cómo usar XQEngine para buscar los datos de cadena que desea encontrar en su archivo XML.

XQEngine se puede encontrar en www.fatdog.com. Es un JavaBean que utiliza un analizador SAX para indexar uno o más documentos XML y luego puede realizar búsquedas complejas en estos documentos. El lenguaje de búsqueda que utiliza es un superconjunto de XQL y tiene una sintaxis similar a XPath.

La clase Java que usa XQEngine debe implementar un método result() Después de completar la búsqueda, el motor llamará a este método para pasar los resultados de la búsqueda al método result(). Se pueden usar tres formatos para mostrar datos para generar los resultados. Utilice parámetros de línea de comando para especificar los parámetros de búsqueda que necesita. Por ejemplo, puede especificar que un archivo no se indexará si contiene la palabra detener o puede indicarle al motor en los parámetros que ignore las palabras que sean menores que las especificadas; número.

A continuación, proporcioné una rutina usando XQEngine, analicémosla ahora. Primero, el método main() crea una instancia de un motor de búsqueda: y luego llama al método setSaxParserName() para establecer el nombre completo del analizador SAX. Debido a que estamos usando el analizador Xerces, necesitamos usar "org.apache.xerces. analizadores.SAXParser". Luego debemos configurar los parámetros de búsqueda, en este caso no indexaremos números ni palabras de menos de 3 caracteres. Habrá descripciones detalladas de los parámetros de configuración en el documento API de XQEngine que descargó, por lo que no entraré en detalles sobre cómo configurar los parámetros aquí. Consulte los documentos relevantes usted mismo. Finalmente, el método setDocument() especifica el archivo XML que XQEngine indexará o buscará. Por supuesto, si desea indexar varios archivos, solo necesita configurar varios métodos setDocument() correspondientes.

También podemos ver en el código siguiente que el motor XQEngine devolverá resultados de búsqueda en tres formatos diferentes: ESTÁNDAR, RESUMEN y CSV (usando valores separados por comas, he definido uno para cada tipo de resultado devuelto en lugar de (). 1, 2, 3), y luego llame al método setListenerType() con los parámetros correspondientes. Describiré cada tipo de resultado devuelto en detalle más adelante. También hay un método printSessionState() que se usa para generar información de índice y motor, pero no lo escribí en la rutina, por lo que el programa anterior solo generará los resultados de la búsqueda en el siguiente paso, llame al método addXQLResultListener() y pase; la instancia de búsqueda se utiliza para implementar la interfaz XQLResultListener; luego se llama al método setQuery con la cadena de consulta como parámetro y el motor comenzará a ejecutar la tarea de consulta. Una vez completada la consulta, el motor llama al método result() de la clase de búsqueda y devuelve los resultados de la consulta. En la rutina que proporcioné, el método result() simplemente genera los resultados.
Código:

importar java.io.*;
importar com.fatdog.textEngine.XmlEngine;
importar com.fatdog.textEngine.exceptions.*;
importar com.fatdog.textEngine.query.XQLResultListener;
La búsqueda de clase pública implementa XQLResultListener
{
principal público estático vacío (cadena [] argumentos)
{
Motor XmlEngine = nuevo XmlEngine();
Cadena archivobúsqueda = args[0];
Tipo de búsqueda de cadena = args[1];
Consulta de cadena = args[2];
prueba {archivo://motor de configuración
motor.setSaxParserName( "org.apache.xerces.parsers.SAXParser");
motor.setMinIndexableWordLength(3);
motor.setDoIndexNumbers(falso);
motor.setDocument (archivo de búsqueda);

si (tipo de búsqueda.equals("1")) {
motor.setListenerType(
XmlEngine.STANDARD_LISTENER);
}
de lo contrario si (tipo de búsqueda.equals("2")) {
motor.setListenerType(
XmlEngine.SUMMARY_LISTENER);
}
demás {
motor.setListenerType(
XmlEngine.CSV_LISTENER);
}
}
captura (MissingOrInvalidSaxParserException e) {
System.out.println(
"Analizador SAX faltante o no disponible");
devolver;
}
atrapar(FileNotFoundException e) {
System.out.println(
"No se puede encontrar el archivo XML: ");
devolver;
}
atrapar(CantParseDocumentException e) {
System.out.println(
"No se puede analizar el archivo XML: ");
devolver;
}
// motor.printSessionStats();
motor.addXQLResultListener (nueva búsqueda ());
intentar {
motor.setQuery (consulta);
}
captura (InvalidQueryException e) {
System.out.println(
"Solicitud de consulta no disponible: " + e.getMessage() );
devolver;
}
}
resultados públicos vacíos (String xqlResults)
{
System.out.println(xqlResultados);
}
}

Bien, hemos escrito un programa usando XQEngine, así que ejecutemos este código. Antes de compilar este código, necesitamos descargar XQEngine y el analizador SAX. Descargué el analizador Xerces de xml.apache.org. El sistema operativo que uso es Windows 2000 Professional y el JDK es la versión 1.3. Bien, después de haber hecho esto, sígueme para configurar CLASSPATH en "Variables de entorno" y agrega "c:xqlXQEngine.jar. ;c:xqlantlr.jar;c:xercesxerces.jar". Ahora el código se puede compilar, pero para ejecutar el programa también necesitamos un archivo XML. Utilicé el archivo web.xml en Apache Tomcat como demostración. Como mencioné antes, usamos 1, 2 y 3 para reemplazar los tres formatos de resultados de la consulta de devolución:

1. Utilice STANDARD_LISTENER (número 1) y el elemento de consulta "//welcome-file-list/welcome-file", C:xqlxql1>java Search web.xml 1 "//welcome-file-list/welcome- archivo "

Analizador.installSaxParser:

<org.apache.xerces.parsers.SAXParser>
instalado exitosamente
1: indexación web.xml
Consulta: ( // ( / lista-de-archivos-de-bienvenida archivo-de-bienvenida ) )
3 resultados para el archivo://lista-de-archivos-de-bienvenida/archivo-de-bienvenida
＜?xml versión="1.0"?＞
<xql:resultado
query="//lista-de-archivos-de-bienvenida/archivo-de-bienvenida"
hitCount="3"
elemCount="3"
docCount="1"
xmlns:xql="http://www.fatdog.com/ Standard_Listener.html">
＜archivo-de-bienvenida＞
índice.jsp
＜/archivo-de-bienvenida＞
＜archivo-de-bienvenida＞
índice.html
＜/archivo-de-bienvenida＞
＜archivo-de-bienvenida＞
índice.htm
＜/archivo-de-bienvenida＞
＜/xql:resultado＞

En el ejemplo anterior, el elemento de consulta requiere encontrar todos los subelementos "archivo de bienvenida" de cualquier elemento "lista de archivos de bienvenida". Tenga en cuenta que los resultados de la búsqueda se extraen básicamente del documento XML original y no se puede establecer la relación entre los resultados de la búsqueda y el documento original. El tipo de retorno de SUMMARY_LISTENER(2) es algo diferente. Incluye un número "docID" y un número "elemlx", para que el resultado pueda asociarse con el documento original.

El siguiente es un ejemplo de resultados devueltos:

C:xqlxql1>java Buscar web.xml 2
"//lista-de-archivos-de-bienvenida/archivo-de-bienvenida"
Parser.installSaxParser: <org.apache.xerces.parsers.SAXParser>
instalado exitosamente

1: indexación web.xml

Consulta: ( // ( / lista-de-archivos-de-bienvenida archivo-de-bienvenida ) )

3 resultados para el archivo://lista-de-archivos-de-bienvenida/archivo-de-bienvenida

＜?xml versión="1.0"?＞
<xql:resultado
query="//lista-de-archivos-de-bienvenida/archivo-de-bienvenida"
hitCount="3"
elemCount="3"
docCount="1"
xmlns:xql="http://www.fatdog.com/
Resumen_Listener.html">
＜archivo de bienvenida xql:docID="0" xql:elemIx="270"/＞
＜archivo de bienvenida xql:docID="0" xql:elemIx="271"/＞
＜archivo de bienvenida xql:docID="0" xql:elemIx="272"/＞
＜/xql:resultado＞

También dije antes que para mi aplicación, lo más importante es devolver resultados separados por comas, por lo que CSV_LISTENER(3) es muy útil. Puede devolver un resultado separado por comas, de la siguiente manera:

C:xqlxql1>java Buscar web.xml 3
"//lista-de-archivos-de-bienvenida/archivo-de-bienvenida"
Analizador.installSaxParser:
<org.apache.xerces.parsers.SAXParser>
instalado exitosamente

1: indexación web.xml

Consulta: ( // ( / lista-de-archivos-de-bienvenida archivo-de-bienvenida ) )

3 resultados para el archivo://lista-de-archivos-de-bienvenida/archivo-de-bienvenida

3,3,1,0
0,270,archivo de bienvenida
0,271, archivo de bienvenida
0,272,archivo de bienvenida

Por supuesto, XQEngine también tiene muchas funciones poderosas. No puedo presentarlas una por una. La documentación que viene tiene una gran cantidad de programas fuente y métodos de uso. Por supuesto, si lo desea, puede aprender a usarlos. Si lo deseas, puedes Incluso puedes desarrollar un programa GUI. El documento viene con un programa de búsqueda basado en GUI: SwingQueryDemo. Puedes echarle un vistazo y estudiarlo.