Package mondrian.olap
Interface Connection
- All Known Implementing Classes:
ConnectionBase
,RolapConnection
public interface Connection
Connection to a multi-dimensional database.
- Author:
- jhyde
- See Also:
-
Method Summary
Modifier and TypeMethodDescriptionvoid
close()
Closes thisConnection
.Deprecated.This method is deprecated and will be removed in mondrian-4.0.Returns an object with which to explicitly control the contents of the cache.Get the name of the Catalog associated with this Connection.Get the Connect String associated with this Connection.Returns the data source this connection uses to create connections to the underlying JDBC database.Returns the locale this connection belongs to.getProperty
(String name) Returns the value of a connection property.getRole()
Returns the access-control profile for this connection.Get the Schema associated with this Connection.Returns a schema reader with access control appropriate to the current role.Parses an expresion.parseQuery
(String s) Parses a query.parseStatement
(String mdx) Parses a statement.void
Sets the privileges for the this connection.
-
Method Details
-
getConnectString
String getConnectString()Get the Connect String associated with this Connection.- Returns:
- the Connect String (never null).
-
getCatalogName
String getCatalogName()Get the name of the Catalog associated with this Connection.- Returns:
- the Catalog name (never null).
-
getSchema
Schema getSchema()Get the Schema associated with this Connection.- Returns:
- the Schema (never null).
-
close
void close()Closes thisConnection
. You may not use thisConnection
after closing it. -
execute
Deprecated.This method is deprecated and will be removed in mondrian-4.0. It operates by internally creating a statement. Better to use olap4j and explicitly create a statement.Executes a query.- Throws:
RuntimeException
- if another thread cancels the query's statement.
-
getLocale
Locale getLocale()Returns the locale this connection belongs to. Determines, for example, the currency string used in formatting cell values.- See Also:
-
parseExpression
Parses an expresion. -
parseQuery
Parses a query. -
parseStatement
Parses a statement.- Parameters:
mdx
- MDX string- Returns:
- A
Query
if it is a SELECT statement, aDrillThrough
if it is a DRILLTHROUGH statement
-
setRole
Sets the privileges for the this connection. -
getRole
Role getRole()Returns the access-control profile for this connection. -
getSchemaReader
SchemaReader getSchemaReader()Returns a schema reader with access control appropriate to the current role. -
getProperty
Returns the value of a connection property.- Parameters:
name
- Name of property, for example "JdbcUser".- Returns:
- Value of property, or null if property is not defined.
-
getCacheControl
Returns an object with which to explicitly control the contents of the cache.- Parameters:
pw
- Writer to which to write logging information; may be null
-
getDataSource
DataSource getDataSource()Returns the data source this connection uses to create connections to the underlying JDBC database.- Returns:
- Data source
-