Pluggable Connection Driver

Every BI Beans application must use two pluggable connection drivers. One driver handles connections to the BI Beans Catalog, and the other handles connections to the OLAP data source.

As an application developer, you can choose to use the default implementation of a pluggable connection driver that ships with BI Beans, or you can customize the connection driver for your application. You must register and turn on the pluggable connection drivers.

When a user attempts to start an application and make a connection, the authentication driver (if registered), is invoked before the connection driver.

ConnectionProvider interface specification

The driver must implement the ConnectionProvider interface from the oracle.dss.security package.


public interface ConnectionProvider {   public Object connect(Hashtable properties) throws BISecurityException;   public void disconnect(Object connection) throws BISecurityException; }

Connect method specification

The incoming arguments to the connect method specify the following:

  1. Properties set by the application developer.

  2. Properties set inside the authenticate method.

  3. The BIUser object, retrieved either from the BISession object or from the BIUser information that is provided in the BI Beans configuration file.

The connect method establishes the specified connection and passes the Connection object to the caller.

Default implementation of the pluggable connection driver for the Catalog

The default implementation of the connection driver for the BI Beans Catalog  involves a pluggable connection driver, which is implemented in the oracle.dss.persistence.storagemanager.bi.mapping.ReposConnectionDriver class. This class implements methods that throw a BISecurityException to indicate an error. The methods are as follows:

Default implementation of the pluggable connection driver for an OLAP data source

The default implementation of the connection driver for an OLAP data source involves a pluggable connection driver, which is implemented in the oracle.dss.connection.server.drivers.mdm.MDMPluggableConnectionDriverImpl class. This class implements methods that throw a BISecurityException to indicate an error. The methods are as follows: