#include <DbXml.hpp>

void XmlContainer::setIndexSpecification(const XmlIndexSpecification &index,
    XmlUpdateContext &context)

void XmlContainer::setIndexSpecification(XmlTransaction &txn,
    const XmlIndexSpecification &index, XmlUpdateContext &context)

Defines the type of indexing to be maintained for a container of documents. The currently defined indexing specification can be retrieved with the XmlContainer::getIndexSpecification method.

If the container is not empty then the contained documents are incrementally indexed. Index keys for disabled index strategies are removed and index keys for enabled index strategies are added. Note that the length of time taken to perform this re-indexing operation is proportional to the size of the container.

• If the operation is to be transaction-protected, the txn parameter is an XmlTransaction handle returned from XmlManager::createTransaction.

• The indexing specification for the container.

• The update context to use for the index modification.

The XmlContainer::setIndexSpecification method may fail and throw XmlException, encapsulating one of the following non-zero errors:

• An error occurred in an underlying Berkeley DB database. The XmlException::getDbErrno method will return the error code for the error.