#include <DbXml.hpp>

XmlContainer XmlManager::createContainer(const std::string &name)
XmlContainer XmlManager::createContainer(
    XmlTransaction &txn, const std::string &name)
XmlContainer XmlManager::createContainer(const std::string &name, const XmlContainerConfig &config)
XmlContainer XmlManager::createContainer(
    XmlTransaction &txn, const std::string &name, XmlContainerConfig config)
XmlContainer XmlManager::createContainer(const std::string &name,
    const XmlContainerConfig &flags, XmlContainer::ContainerType type, int mode = 0)
XmlContainer XmlManager::createContainer(XmlTransaction &txn,
    const std::string &name, const XmlContainerConfig &flags,
    XmlContainer::ContainerType type, int mode = 0)

Creates and opens a container, returning a handle to an XmlContainer object. If the container already exists at the time this method is called, an exception is thrown.

Use XmlManager::openContainer to open a container that has already been created.

Containers always remain open until the last handle referencing the container is destroyed.

Creates a default container. The container is created using the settings XmlContainerConfig::setAllowCreate and XmlContainerConfig::setExclusiveCreate set to true unless the default behavior has been overridden using XmlManager::setDefaultContainerConfig. In addition, the container is set up to use node-level storage unless XmlManager::setDefaultContainerConfig is used.

• The XmlTransaction object to use for this container creation.

• The container's name. The container is created relative to the underlying environment's home directory (see XmlManager for more information) unless an absolute path is used for the name; in that case the container is created in the location identified by the path.

The name provided here must be unique for the environment or an exception is thrown.

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

• Error: Db::open: File exists

Creates a container.

• The XmlTransaction object to use for this container creation.

• The container's name. The container is created relative to the underlying environment's home directory (see XmlManager for more information) unless an absolute path is used for the name; in that case the container is created in the location identified by the path.

The name provided here must be unique for the environment or an exception is thrown.

• The XmlContainerConfig used to set the flags to use for this container creation.

• If the container does not currently exist, create it.

• 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.

• Return an error if the container already exists. The DB_EXCL flag is only meaningful when specified with the DB_CREATE flag.

• Open the database with support for multiversion concurrency control. This will cause updates to the container to follow a copy-on-write protocol, which is required to support snapshot isolation. The DB_MULTIVERSION flag requires that the container be transactionally protected during its open.

• Do not map this container into process memory (see the UNREF==dbenv_set_mp_mmapsize method for further information).

• Open the container for reading only. Any attempt to modify items in the container will fail, regardless of the actual permissions of any underlying files.

• Cause the container handle to be free-threaded; that is, concurrently usable by multiple threads in the address space.

• Do checksum verification of pages read into the cache from the backing filestore. Berkeley DB XML uses the SHA1 Secure Hash Algorithm if encryption is configured and a general hash algorithm if it is not.

• Encrypt the database using the cryptographic password specified to UNREF==dbenv_set_encrypt.

• If set, Berkeley DB XML will not write log records for this database. This means that updates of this database exhibit the ACI (atomicity, consistency, and isolation) properties, but not D (durability); that is, database integrity will be maintained, but if the application or system fails, integrity will not persist. The database file must be verified and/or restored from backup after a failure.

• Causes the indexer to create index targets that reference nodes rather than documents. This allows index lookups during query processing to more efficiently find target nodes and avoid walking the document tree. It can apply to both container types, and is the default for containers of type XmlContainer::NodeContainer.

• Causes the indexer to create index targets that reference documents rather than nodes. This can be more desirable for simple queries that only need to return documents and do relatively little navigation during querying. It can apply to both container types, and is the default for containers of type XmlContainer::WholedocContainer.

• Causes the container to be created to include structural statistics information, which is very useful for cost based query optimisation. Containers created with these statistics will take longer to load and update, since the statistics must also be updated. This is the default.

• Causes the container to be created without structural statistics information - by default structural statistics are created.

• Cause the container to support transactions. If this flag is set, an XmlTransaction object may be used with any method that supports transactional protection. Also, if this flag is used, and if an XmlTransaction object is not provided to a method that modifies an XmlContainer or XmlDocument object, then auto commit is automatically used for the operation.

• When loading documents into the container, validate the XML if it refers to a DTD or XML Schema.

Note that regardless the setting of your flags, XmlContainerConfig::setAllowCreate and XmlContainerConfig::setExclusiveCreate will be set to true.

• The type of container to create.

• Documents are broken down into their component nodes, and these nodes are stored individually in the container. This is the preferred container storage type.

• Documents are stored intact; all white space and formatting is preserved.

• The XmlContainerConfig object used to set the properties of the container.

• On Windows systems, the mode parameter is ignored.

  On UNIX systems or in IEEE/ANSI Std 1003.1 (POSIX) environments, files created by are created with mode mode (as described in chmod(2)) and modified by the process' umask value at the time of creation (see umask(2)). Created files are owned by the process owner; the group ownership of created files is based on the system and directory defaults, and is not further specified by Berkeley DB. System shared memory segments created by are created with mode mode, unmodified by the process' umask value. If mode is 0, will use a default mode of readable and writable by both owner and group.

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

• Error: Db::open: File exists

• Invalid flags to method XmlManager::openContainer