org.xmldb.api.base
Interface Database
- All Superinterfaces:
- Configurable
- All Known Implementing Classes:
- DatabaseImpl, SimpleDatabase
- public interface Database
- extends Configurable
Database
is an encapsulation of the database driver
functionality that is
necessary to access an XML database. Each vendor must provide their own
implmentation of the Database
interface. The implementation
is registered with the
DatabaseManager
to provide access to the resources of the XML database.
In general usage client applications should only access Database
implementations directly during initialization.
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 Database instance. |
getName
public java.lang.String getName()
throws XMLDBException
- Returns the name associated with the Database instance.
- 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. The format of the URI is defined in the
documentation for DatabaseManager.getCollection().
Authentication is handled via username and password however it is not
required that the database support authentication. Databases that do not
support authentication MUST ignore the
username
and password
if those provided are not
null.
- 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:
- A
Collection
instance for the requested collection or
null if the collection could not be found. - 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. It should return true
if the Database instance knows how to handle the URI and false otherwise.
- 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. This can
be used by client programs to determine what functionality is available to
them.
- 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.
Copyright (c) 1999-2001 The dbXML Group, All rights reserved