Apache Xindice是一种本机XML数据库，可以在该数据库中保存、查询和修改XML文档。与关系数据库相比，本机数据库的优点是无须将XML映射到SQL。该数据库使用XPath查询Xindice数据库，使用XML:DB XUpdate来更新数据库。Xindice实现了Java XML:DB API，用于在Xindice数据库中添加、查询和更新XML文档。Xindice数据库中的XML文档保存在集合中；一个集合可以包含一个或多个XML文档。Xindice还提供一种命令行工具，该工具具有与XML:DB API相同的功能。

初始安装

　　Xindice数据库可作为一种Web应用程序安装在Web服务器上。安装Xindice数据库时需要Xindice API JAR文件和Xindice服务器Web应用程序。

• 下载Version 1.1b4 binary (JAR)，即xml-xindice-1.1b4-jar.zip，其中包含Xindice XML:DB API JAR文件。
• 下载Version 1.1b4 binary (webapp)，即xml-xindice-1.1b4-war.zip，其中包含Xindice服务器Web应用程序。
• 将xml-xindice-1.1b4-jar.zip解压缩到安装目录C:/xindice下。
• 将xerces-2.6.0.jar添加到CLASSPATH变量前面。然后将下面的Xindice JAR文件添加到CLASSPATH，其中，是Xindice安装目录。

表1 Xindice JAR文件

• 将/xindice-1.1b4/bin添加到PATH变量。
• 为XINDICE_HOME环境变量添加值/xindice-1.1b4。
• 将xml-xindice-1.1b4-war.zip解压缩到安装目录C:/xindice。
• Xindice Web应用程序部署在Web服务器/应用服务器中（本教程使用了WebLogic server 9.0，但也可以使用其他Web服务器/应用服务器）。安装WebLogic Server 9.0。然后使用WebLogic server配置向导创建一个WebLogic server域。创建的默认域为base_domain。

概述

　　可以使用XML:DB和XUpdate API或Xindice命令行工具访问和修改Xindice数据库。XML:DB API包括使用XPath查询数据库的XpathQueryService服务以及使用XUpdate更新数据库的XUpdateQueryService服务。XML:DB/XUpdate API和命令行工具用于创建Xindice数据库集合、将XML文档添加到数据库、从数据库检索XML文档、查询数据库和更新数据库。在下面的各小节中，我们将先演示命令行工具，然后演示Xindice API。

　　 使用xindice命令访问Xindice命令行工具。xindice命令的语法是：

xindice action [switch] [parameter]

　　表2列出了一些xindice命令操作值。

表 2. Xindice命令操作值

　　表3列出了一些xindice命令切换值。.

表 3. Xindice命令切换值

　　以下部分参考表2和表3,说明了xindice命令中使用的Xindice操作或切换。作为xindice命令的一个示例,使用以下命令列出了Xindice数据库中的集合：

xindice lc -c xmldb:xindice://localhost:7001/db

　　该xindice命令的输出结果是：

system meta Total collections: 2

使用WebLogic Server配置Xindice

　　需要使用Xerces解析器来配置Xindice 1.1.b4数据库。默认情况下，Xindice使用在JVM中配置的XML解析器。因为JDK 1.4.2中包括的XML解析器是Crimson解析器，将Xindice 1.1b4与JDK 1.4.2一起使用将发生以下错误：

Failed to create SAXParser  org.xml.sax.SAXNotSupportedException:   Feature: http://xml.org/sax/features/  external-general-entities

　　将JDK 5.0与Xindice 1.1b4一起使用。JDK 5.0包括Xerces解析器。WebLogic Server 9.0用于部署Xindice数据库。需要使用WebLogic 9.0（而不是8.1）版，因为9.0版本支持JDK 5.0。

　　 JDK 1.4.2可以与Xindice一起使用，方法是通过认可的标准覆盖机制将Xerces2-j 2.7.1中的Xerces实现类添加到JDK 1.4.2中Xerces类前面的类路径。要使用认可的标准覆盖机制，请使用安装Xerces2-j（如）的目录定义系统属性java.endorsed.dirs，或将JAR文件从xerces-2_7_1目录复制到/jre/lib/endorsed目录。

　　 本节中的配置过程仅适用于WebLogic Server 9.0：

• 将/Xindice-webapp/xindice-1.1b4/xindice-1.1b4.jar修改为xindice.jar。
• 从xindice.jar文件中解压缩WEB-INF/server.xml配置文件。
• 在server.xml文件中，将root集合元素中的dbroot属性值指定为C:/xindice/db，该目录路径是用于创建Xindice数据库的目录路径。
• 从xindice.jar文件删除WEB-INF/system.xml。将修改后的WEB-INF/server.xml 添加到xindice.jar。
• 将xindice.jar文件复制到/user_projects/domains/base_domain/autodeploy目录。
• 将JAVA_HOME环境变量定义为/jdk150_03，其中为安装WebLogic server的目录。
• 启动WebLogic server。这将启动WebLogic server中的Xindice数据库服务器，并打开默认的Xindice数据库db。在WebLogic server中部署Xindice服务器Web应用程序。使用URL http://localhost:7001/console访问WebLogic server管理控制台。选择base_domain>Deployments节点。选择Xindice Web应用程序链接和Testing选项卡。Xindice服务器URL显示为http://localhost:/7001/xindice。

在数据库中创建集合

　　在WebLogic server中配置了Xindice数据库服务器后，我们将使用命令行工具和XML:DB API创建一个Xindice数据库集合。在Xindice数据库中，集合是一组XML文档。

　　 使用Xindice命令创建顶级集合catalog：

>xindice ac -c xmldb:xindice://localhost:7001/db -n catalog

　　示例命令行命令中的集合上下文是db数据库实例，它是默认的Xindice数据库实例。还可以将db数据库作为根集合引用。这会在db数据库中创建集合catalog，并输出以下消息：

Created :xmldb:xindice://localhost:7001/db/catalog

　　可以使用以下命令删除创建的集合：

>xindice dc -c xmldb:xindice://localhost:7001/db -n catalog

　　这将删除集合，并显示如下消息：

Deleted: xmldb:xindice://localhost:7001/db/catalog

　　接下来，我们将使用XML:DB API创建一个集合，导入Xindice核心服务器类和XML:DB API类。

import org.apache.xindice.client.xmldb.services.*; import org.apache.xindice.util.XindiceException; import org.apache.xindice.xml.dom.*; import org.xmldb.api.*; import org.xmldb.api.base.*; import org.xmldb.api.modules.*;

　　创建一个Xindice数据库引擎实例。Xindice数据库的XML:DB驱动程序实现类为DatabaseImpl。向org.xmldb.api.DatabaseManager注册Xindice数据库，使用该数据库从XML:DB数据库获取集合。

String xindiceDriver =    "org.apache.xindice.client.xmldb.DatabaseImpl"; org.xmldb.api.base.Database xindiceDatabase =    (org.xmldb.api.base.Database)   ((Class.forName(xindiceDriver)).newInstance()); org.xmldb.api.DatabaseManager.    registerDatabase(xindiceDatabase);

　　接下来，从该数据库获取db集合。

 String url = "xmldb:xindice://localhost:7001/db";  org.xmldb.api.base.Collection  collection =      DatabaseManager.getCollection(url);

　　创建org.apache.xindice.client.xmldb.services.CollectionManager对象。要从数据库创建并删除集合，CollectionManager是必需的。指定一个XML配置以创建集合。在Xindice文档中没有详细介绍XML配置。请使用CollectionManager服务创建一个数据库集合。

CollectionManager collectionManagerService =     (CollectionManager)     collection.getService("CollectionManager", "1.0");  String collectionName = "catalog"; String collectionConfig = "" +   " " +   "";  catalogCollection =    collectionManagerService.createCollection   (collectionName,    DOMParser.toDocument(collectionConfig));

　　这将在db数据库中创建一个集合catalog。

将XML文档添加到数据库

　　接下来，将XML示例文档添加到数据库集合catalog。XML示例文档如下所示：

       
         Sunil Patil   
       
         James Elliott   
       
         Daniel Steinberg   
   

　　使用命令行工具通过以下命令将XML文档添加到Xindice数据库：

>xindice ad -c xmldb:xindice://localhost:7001/db/catalog  -f c:/xindice/catalog.xml -n catalog.xml

　　这将catalog.xml文档添加到catalog集合，并输出以下确认：

Added document xmldb:xindice://localhost:7001/db/catalog/catalog.xml

　　接下来，我们将使用XML:DB API添加集合。导入前一节列出的XML:DB API和核心服务器类。创建并注册“在数据库中创建集合”一节中的数据库驱动程序。从数据库获取catalog集合：

Collection collection = DatabaseManager.getCollection   ("xmldb:xindice://localhost:7001/db/catalog");

　　获取添加到数据库的XML文档的Document对象。

DocumentBuilderFactory factory =    DocumentBuilderFactory.newInstance(); File datafile = new File("c:/Xindice/catalog.xml"); DocumentBuilder builder = factory.newDocumentBuilder(); Document document = builder.parse(datafile);

　　创建添加到集合的XML文档资源的ID。ID将集合与标识符关联起来。为从集合添加的XML文档创建org.xmldb.api.modules.XMLResource。在Xindice数据库中，XMLResource对象表示XML资源，如Document对象。从Document对象设置XMLResource的内容。将XML资源添加到集合。

String  resourceID = collection.createId();  XMLResource resource = (XMLResource)   (collection.createResource(resourceID,               "XMLResource")); resource.setContentAsDOM(document); collection.storeResource(resource);

　　这将XML文档添加到数据库集合。

从数据库检索XML文档

　　接下来，检索在上一节中添加的XML文档。使用下列命令从Xindice数据库检索XML文档：

>xindice rd -c xmldb:xindice://localhost:7001/db/catalog   -n catalog.xml

　　这将检索XML文档。接下来，使用XML:DB API检索XML文档。获取“将XML文档添加到数据库”一节中的catalog集合。获取用于XML文档的XML资源。输出XML资源中的XML文档。

XMLResource resource = (XMLResource)   (collection.getResource(resourceID)); System.out.println(resource.getContent());

　　这将检索上一节中添加的XML文档。

使用XPath查询数据库

　　Xindice提供XPath查询引擎，以便使用XPath查询数据库的XML文档。接下来，使用XPath查询Xindice数据库中的XML文档。首先，使用命令行工具通过xindice命令xpath操作查询Xindice数据库集合。例如，检索第一个元素中

>xindice xpath -c xmldb:xindice://localhost:7001/db/catalog    -q /catalog/journal[1]/article/title

>xindice xpath -c xmldb:xindice://localhost:7001/db/catalog     -q /catalog/@publisher

String xpath = "/catalog/journal[1]/article/title";

XPathQueryService queryService =    (XPathQueryService)    collection.getService("XPathQueryService","1.0"); ResourceSet resourceSet = queryService.query(xpath); ResourceIterator iterator = resourceSet.getIterator();    while (iterator.hasMoreResources()) {        Resource resource = iterator.nextResource();        System.out.println(resource.getContent());    }

        Aug 2005    
           Sunil Patil    
      

>xindice xupdate -c   xmldb:xindice://localhost:7001/db/catalog -n catalog.xml   -f  c:/xindice/xupdate.xml

1 documents updated

   Maven with Swing 

>xindice xupdate -c   xmldb:xindice://localhost:7001/db/catalog -n catalog.xml   -f  c:/xindice/xupdate.xml

String xupdate =  "" + "    " + "    " + " 
" + "    " + "    Sunil Patil" + " 
" + "    " + "    " + "";

XUpdateQueryService queryService = (XUpdateQueryService) collection.getService("XUpdateQueryService",                    "1.0"); queryService.update(xupdate);

xupdate = "" +     "    " +     ""; queryService.update(xupdate);

xupdate = "" + "     + "    Maven with Swing" + "";  queryService.update(xupdate);

       
         James Elliott   
       
         Daniel Steinberg   
         
             Sunil Patil      
           

>xindice dd -c   xmldb:xindice://localhost:7001/db/catalog -n catalog.xml

DELETED: xmldb:xindice://localhost:7001/db/catalog/catalog.xml

XMLResource resource = (XMLResource)   (collection.getResource(resourceID)); collection.removeResource(resource);