oracle.dss.security
Interface ConnectionProvider

public interface ConnectionProvider

The interface for the pluggable connection driver. An application must implement this interface or use the default implementation. Pluggable connection drivers are required for BI Beans to function.

There are two types of pluggable connection drivers -- one for connections to Oracle OLAP and one for connections to the BI Beans Catalog. You register an implemention of the pluggable connection driver by using the BI Beans configuration file.

Method Summary

java.lang.Object	connect(java.util.Hashtable properties) Connects to Oracle OLAP or to the BI Beans Catalog using a table of properties as an argument.
void	disconnect(java.lang.Object connection) Disconnects from an existing connection, using the name of the Connection object as an argument.

Method Detail

connect

public java.lang.Object connect(java.util.Hashtable properties)
                         throws BISecurityException

Connects to Oracle OLAP or to the BI Beans Catalog using a table of properties as an argument. You must implement this method so that the application can use pluggable connection drivers.

Parameters:

properties - The hash table of properties that the application sets.

Returns:

The Java object that represents the connection. If the connection is to the Catalog, then BI Beans expects that the returned object is of type java.sql.Connection. If the connection is to Oracle OLAP, then the BIBeans expects the object to be of type .org.omg.CORBA.Object.

Throws:

BISecurityException - if the connection fails.

See Also:

Connection, Object

disconnect

public void disconnect(java.lang.Object connection)
                throws BISecurityException

Disconnects from an existing connection, using the name of the Connection object as an argument. You must implement this method if you want to implement a custom pluggable connection driver.

Parameters:

connection - The Connection object that was created when the original connection was successfully established.

Throws:

BISecurityException - if the disconnection fails.