Package org.xmldb.api.reference

Class DatabaseImpl

java.lang.Object

org.xmldb.api.sdk.SimpleConfigurable

org.xmldb.api.sdk.SimpleDatabase

org.xmldb.api.reference.DatabaseImpl

All Implemented Interfaces:

Configurable, Database

public class DatabaseImpl
extends SimpleDatabase

Reference Database implmentation. The reference Database simply resides on the file system. It isn't speedy but it serves the purpose of illustrating how a driver should work..

The path where the data files are located is specified through the property xmldb.data.dir. If this property is not specified it defaults to a directory named data in the current working directory. If the directory does not exist an attempt will be made to create it.

Constructor Summary

Constructors

Constructor	Description
DatabaseImpl()

Method Summary

Modifier and Type	Method	Description
Collection	getCollection(java.lang.String uri, java.lang.String username, java.lang.String password)	Retrieves a Collection instance based on the URI provided in the uri parameter.

Methods inherited from interface org.xmldb.api.base.Configurable

getProperty, setProperty

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from class org.xmldb.api.sdk.SimpleConfigurable

getProperty, setProperty

Methods inherited from class org.xmldb.api.sdk.SimpleDatabase

acceptsURI, getConformanceLevel, getName, getNames

Constructor Detail

DatabaseImpl

public DatabaseImpl()

Method Detail

getCollection

public Collection getCollection(java.lang.String uri,
                                java.lang.String username,
                                java.lang.String password)
                         throws XMLDBException

Retrieves a Collection instance based on the URI provided in the uri parameter. The URI format for this implementation is ref:///path where path is a path in the file system. To locate the data files the database expects a directory data to exist in the current directory.

Specified by:

getCollection in interface Database

Overrides:

getCollection in class SimpleDatabase

Parameters:

uri - the URI to use to locate the collection.

password - The password to use for authentication to the database or null if the database does not support authentication.

Returns:

The Collection instance

Throws:

XMLDBException - with expected error codes.
ErrorCodes.VENDOR_ERROR for any vendor specific errors that occur.
ErrroCodes.INVALID_URI If the URI is not in a valid format.
ErrroCodes.PERMISSION_DENIED If the username and password were not accepted by the database.