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 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 this Connection. You may not use this Connection after closing it.
    • execute

      Result execute(Query query)
      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

      Exp parseExpression(String s)
      Parses an expresion.
    • parseQuery

      Query parseQuery(String s)
      Parses a query.
    • parseStatement

      QueryPart parseStatement(String mdx)
      Parses a statement.
      Parameters:
      mdx - MDX string
      Returns:
      A Query if it is a SELECT statement, a DrillThrough if it is a DRILLTHROUGH statement
    • setRole

      void setRole(Role role)
      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

      Object getProperty(String name)
      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

      CacheControl getCacheControl(PrintWriter pw)
      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