dbxmlCreateContainer

Home > Books > Discovered Documentation > Discovered Documentation > BDBXML Library > dbxmlCreateContainer

Module

The dbxmlCreateContainer accessor is exported by the urn:org:ten60:netkernel:mod:dbxml module. Import this module to gain access to the accessor.

Syntax

URI

active:dbxmlCreateContainer

Argument	Rules	Description
operator	Mandatory	the container specification document

Example Usage

DPML

<instr>
  <type>dbxmlCreateContainer</type>
  <operator>
    <dbxml>
      <name>mycontainer</name>
    </dbxml>
  </operator>
</instr>

NetKernel Foundation API

req=context.createSubRequest("active:dbxmlCreateContainer");
req.addArgument("operator", [resource representation, aspect, or URI] );
result=context.issueSubRequest(req);

Purpose

The dbxmlCreateContainer accessor creates a new XML container in Berkeley DBXML. The container specification to be created is provided as the operator argument and is an XML fragment.

If successful the response is a voidAspect otherwise an exception is thrown.

Operator Format

The format for the operator is...

<dbxml>
  <name>mycontainer</name>
  <nodeContainer />
  <indexNodes />
  <allowValidation />
</dbxml>

The name tag is required and specifies the identity for the container in the BDBXML database. Optional tags that specify properties of the container include:

Option	Desc
nodeContainer	Specify that documents are broken down into their component nodes, and these nodes are stored individually in the container, or stored intact with all white space and formatting is preserved.
indexNodes	Causes the indexer to create index targets that reference nodes rather than documents.
allowValidation	Sets whether documents are validated when loaded into the container, if they refer to a DTD or XML Schema.

Reference

Berkeley DBXML can be downloaded from Sleepycat Software.
Javadoc for BDBXML