XmlContainer.remove

API Ref

import com.sleepycat.dbxml.*;

public void remove(DbTxn txn, int flags) throws XmlException;


Description: XmlContainer.remove

The XmlContainer.remove method removes the underlying file for the container from the file system.

The container must be closed; the system throws an exception if the container is open.

The container must have been opened at least once; the system throws an exception if the underlying file has not yet been created.

Parameters

txn
If the operation is to be transaction-protected, the txn parameter is a transaction handle returned from DbEnv.txnBegin, otherwise, NULL.

flags
must be set to zero, or a value created by bitwise inclusively OR'ing one or more of the following values:

Db.DB_AUTO_COMMIT
Automatically wrap the operation in a transaction.

Throws

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

CONTAINER_OPEN
The container is open.

DATABASE_ERROR
An error occurred in an underlying Berkeley DB database. The XmlException.getDbError method will return the error code for the error.

Class

XmlContainer, XmlDocument, XmlException, XmlIndexSpecification, XmlQueryContext, XmlQueryExpression, XmlResults, XmlUpdateContext, XmlValue

APIRef

Copyright (c) 1996-2003 Sleepycat Software, Inc. - All rights reserved.