XML:DB API SDK

org.xmldb.api.sdk
Class SimpleDatabase

java.lang.Object
  extended byorg.xmldb.api.sdk.SimpleConfigurable
      extended byorg.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
SimpleDatabase()
           
 
Method Summary
 boolean acceptsURI(java.lang.String uri)
          acceptsURI determines whether this Database implementation can handle the URI.
 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.
 java.lang.String getConformanceLevel()
          Returns the XML:DB API Conformance level for the implementation.
 java.lang.String getName()
          Returns the name associated with the Configurable object.
 
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 Detail

SimpleDatabase

public SimpleDatabase()
Method Detail

getName

public java.lang.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.

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. 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(java.lang.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 java.lang.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.

XML:DB API SDK

Copyright (c) 2001 The XML:DB Initiative All rights reserved