org.xquark.xml.xdbc
Interface XMLDriver

All Known Implementing Classes:

MediatorDriver

public interface XMLDriver

The interface that every driver class must implement.

It allows new connections from XMLDBC client.

Method Summary

boolean	acceptsURI(java.lang.String uri) Returns true if the driver understand the specified connection string
XMLDataSource	getDataSource(java.lang.String uri) To obtain a handle to a data source with the specified URI.
XMLDataSource	getDataSource(java.lang.String uri, java.lang.String user, java.lang.String password) To obtain a handle to a data source with the specified URI, user name and password.
java.lang.String	getSpecificPart(java.lang.String uri) Returns the driver-specific part of the URI

Method Detail

acceptsURI

public boolean acceptsURI(java.lang.String uri)
                   throws XMLDBCException

Returns true if the driver understand the specified connection string

Parameters:

uri - the connection string

Returns:

a boolean

Throws:

XMLDBCException

getSpecificPart

public java.lang.String getSpecificPart(java.lang.String uri)
                                 throws XMLDBCException

Returns the driver-specific part of the URI

Parameters:

uri -

Returns:

a string

Throws:

XMLDBCException - if the URI is not recognized by the driver

getDataSource

public XMLDataSource getDataSource(java.lang.String uri)
                            throws XMLDBCException

To obtain a handle to a data source with the specified URI.

Parameters:

uri - an URI corresponding to a data source.

Returns:

an instance of the specified data source, or null if the driver does not know this type of data source

Throws:

XMLDBCException - if a data source access error occurs.

getDataSource

public XMLDataSource getDataSource(java.lang.String uri,
                                   java.lang.String user,
                                   java.lang.String password)
                            throws XMLDBCException

To obtain a handle to a data source with the specified URI, user name and password.

Parameters:

uri - a URI corresponding to a data source.

user - a user name

password - a user password

Returns:

an instance of the specified data source, or null if the driver does not know this type of data source

Throws:

XMLDBCException - if a data source access error occurs.