mondrian.xmla
Interface XmlaHandler.ConnectionFactory

All Known Implementing Classes:

MondrianServerImpl

Enclosing class:

XmlaHandler

public static interface XmlaHandler.ConnectionFactory

Creates an olap4j connection for responding to XMLA requests.

A typical implementation will probably just use a DataSource or a connect string, but it is important that the connection is assigned to the correct catalog, schema and role consistent with the client's XMLA context.

Method Summary

OlapConnection	getConnection(String catalog, String schema, String roleName, Properties props) Creates a connection.
Map<String,Object>	getPreConfiguredDiscoverDatasourcesResponse() Returns a map of property name-value pairs with which to populate the response to the DISCOVER_DATASOURCES request.

Method Detail

getConnection

OlapConnection getConnection(String catalog,
                             String schema,
                             String roleName,
                             Properties props)
                             throws SQLException

Creates a connection.

The implementation passes the properties to the underlying driver.

Parameters:

catalog - The name of the catalog to use.

schema - The name of the schema to use.

roleName - The name of the role to use, or NULL.

props - Properties to be passed to the underlying native driver.

Returns:

An OlapConnection object.

Throws:

SQLException - on error

getPreConfiguredDiscoverDatasourcesResponse

Map<String,Object> getPreConfiguredDiscoverDatasourcesResponse()

Returns a map of property name-value pairs with which to populate the response to the DISCOVER_DATASOURCES request.

Properties correspond to the columns of that request: ""DataSourceName", et cetera.

Returns null if there is no pre-configured response; in which case, the driver will have to connect to get a response.

Returns:

Column names and values for the DISCOVER_DATASOURCES response