#include <DbXml.hpp>

XmlResults XmlContainer::getAllDocuments(u_int32_t flags)

XmlResults XmlContainer::getAllDocuments(XmlTransaction &txn, u_int32_t flags)

Return all of the documents in the container in a lazily evaluated XmlResult set.

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

• The flags parameter must be set to 0 or by bitwise inclusively OR'ing together one or more of the following values:
  DBXML_LAZY_DOCS
  • Retrieve the document lazily. That is, retrieve document content and document metadata only on an as needed basis when reading the document.
  DBXML_WELL_FORMED_ONLY
  • Force the use of a scanner that will neither validate nor read schema or dtds associated with the document during parsing. This is efficient, but can cause parsing errors if the document references information that might have come from a schema or dtd, such as entity references.
  DBXML_LAZY_DOCS defaults to on. DB_READ_UNCOMMITTED
  • This operation will support degree 1 isolation; that is, read operations may return data that has been modified by other transactions but which has not yet been committed. Silently ignored if the DB_READ_UNCOMMITTED flag was not specified when the underlying container was opened.
  DB_READ_COMMITTED
  • This operation will have degree 2 isolation. This provides for cursor stability but not repeatable reads. Data items which have been previously read by this transaction may be deleted or modified by other transactions before this transaction completes.
  DB_RMW
  • Acquire write locks instead of read locks when doing the read, if locking is configured. Setting this flag can eliminate deadlock during a read-modify-write cycle by acquiring the write lock during the read part of the cycle so that another thread of control acquiring a read lock for the same item, in its own read-modify-write cycle, will not result in deadlock.
  DBXML_REVERSE_ORDER
  • Return results in reverse order relative to the sort of the index.