org.xquark.xml.xdbc
Interface XMLDriver

All Known Implementing Classes:
ExtractorDriver

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.


Copyright © 2004 Université de Versailles Saint-Quentin, XQuark Group. All rights reserved.