Package org.xmldb.api.sdk

Class SimpleDatabase

java.lang.Object

org.xmldb.api.sdk.SimpleConfigurable

org.xmldb.api.sdk.SimpleDatabase

All Implemented Interfaces:

Configurable, Database

Direct Known Subclasses:

DatabaseImpl

public abstract class SimpleDatabase
extends SimpleConfigurable
implements Database

Simple Database implementation intended to be used as a base class for a specific implementation.

Extending classes MUST set INSTANCE_NAME and SHOULD set CONFORMANCE_LEVEL to values appropriate for their specific implementation.

Constructor Summary

Constructors

Constructor	Description
SimpleDatabase()

Method Summary

Modifier and Type	Method	Description
boolean	acceptsURI(String uri)	acceptsURI determines whether this Database implementation can handle the URI.
Collection	getCollection(String uri, String username, String password)	Retrieves a Collection instance based on the URI provided in the uri parameter.
String	getConformanceLevel()	Returns the XML:DB API Conformance level for the implementation.
String	getName()	Returns the name associated with the Configurable object.
String[]	getNames()	Returns an array of names associated with the Database instance.

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

getProperty, setProperty

Methods inherited from class java.lang.Object

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

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

getProperty, setProperty

Constructor Details

SimpleDatabase

public SimpleDatabase()

Method Details

getName

public String getName()
               throws XMLDBException

Returns the name associated with the Configurable object.

Specified by:

getName in interface Database

Returns:

the name of the object.

Throws:

XMLDBException - with expected error codes.
ErrorCodes.VENDOR_ERROR for any vendor specific errors that occur.

getNames

public String[] getNames()
                  throws XMLDBException

Description copied from interface: Database

Returns an array of names associated with the Database instance.

Specified by:

getNames in interface Database

Returns:

the array of name of the object.

Throws:

XMLDBException - with expected error codes.
ErrorCodes.VENDOR_ERROR for any vendor specific errors that occur.

getCollection

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

Retrieves a Collection instance based on the URI provided in the uri parameter. Implementations must override this method.

Specified by:

getCollection in interface Database

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.

acceptsURI

public boolean acceptsURI(String uri)
                   throws XMLDBException

acceptsURI determines whether this Database implementation can handle the URI.

Specified by:

acceptsURI in interface Database

Parameters:

uri - the URI to check for.

Returns:

true if the URI can be handled, false otherwise.

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.

getConformanceLevel

public String getConformanceLevel()
                           throws XMLDBException

Returns the XML:DB API Conformance level for the implementation.

Specified by:

getConformanceLevel in interface Database

Returns:

the XML:DB API conformance level for this implementation.

Throws:

XMLDBException - with expected error codes.
ErrorCodes.VENDOR_ERROR for any vendor specific errors that occur.