Blog de Luis Arévalo

Hasta ahora sólo me he preocupado de enseñaros como utilizar las herramientas que proporciona eXist. Pero, ¿Cómo podemos interactuar desde nuestra aplicación Java con eXist?. Esta pregunta espero responderla en este post.

Antes de nada gracias a Victor Cima y a Carlos pues en su día sus páginas fueron mis referentes.

Afortunadamente para poder realizar esta labor, el grupo XMLDB ha propuesto un API que todos los proveedores deben implementar. Al igual que con otras aplicaciones la  API simplemente define un conjunto de interfaces que cada proveedor implementa. La API propuesta principalmente se basa en tres paquetes:

• org.xmldb.api: Interfaces, DatabaseManager

• org.xmldb.api.base: Interfaces, Collection, Configurable, Database, Resource, ResourceIterator, ResourceSet, Service , Classes, ErrorCodes , Exceptions, XMLDBException

• org.xmldb.api.modules: Interfaces, BinaryResource, CollectionManagementService, TransactionService, XMLResource, XPathQueryService, XUpdateQueryService

Para su uso con eXist únicamente debemos tener presente:

• Incluir las librerías oportunas en el proyecto: exist.jar, exist-optional.jar, xmldb.jar, xml-apis-1.3.04.jar, xmlrpc-common-3.1.1.jar, xmlrpc-common-3.1.1.jar situadas en la instalación de eXist.
• Importar las librerías oportunas:

import org.xmldb.api.base.*;
import org.xmldb.api.modules.*;
import org.xmldb.api.*;

• Conocer el driver a utilizar: «org.exist.xmldb.DatabaseImpl» ó «org.apache.xindice.client.xmldb.DatabaseImpl»
• Conocer la URL de la base de datos eXist.

En el siguiente ejemplo os muestro el código para lanzar una consulta XQuery sobre eXist desde Java usando la API XMLDB.

import org.xmldb.api.base.*;
import org.xmldb.api.modules.*;
import org.xmldb.api.*;

public class QueryExample {

    public static void main(String args[]) throws Exception {
        String driver = "org.exist.xmldb.DatabaseImpl"; //Driver
        Class cl = Class.forName(driver);//Cargar el driver
        Database database = (Database) cl.newInstance(); //Instancia de la BD
        database.setProperty("create-database", "true");
        DatabaseManager.registerDatabase(database); //Registrar la BD
        //Accedemos a la colección
        Collection col =DatabaseManager.getCollection("xmldb:exist://localhost:8080/exist/xmlrpc/db/", "USER", "PASSWORD");
        XPathQueryService service =(XPathQueryService) col.getService("XPathQueryService", "1.0");
        service.setProperty("pretty", "true");
        service.setProperty("encoding", "ISO-8859-1");
        //Consulta a lanzar
        ResourceSet result = service.query("for $b in doc('prueba.xml')//a return $b");
        ResourceIterator i = result.getIterator();
        while (i.hasMoreResources()) { //Procesamos el resultado
            Resource r = i.nextResource();
            System.out.println((String) r.getContent());
        }
    }
}

Espero que os sea útil, sucesivamente iré proporcionando otros códigos de utilidad.

Añadido en Enero: Es necesario también las librerías log4j-1.2.15.jar y ws-commons-util-1.0.2.jar.