org.olap4j.metadata
Interface Database


public interface Database

Highest level element in the hierarchy of metadata objects.

A Database contains one or more Catalogs.

To obtain the collection of databases in the current server, call the OlapConnection.getOlapDatabases() method. To obtain the current active catalog object, to which a connection is bound, use OlapConnection.getOlapDatabase().

The hierarchy of metadata objects, rooted at the connection from which they are accessed, is as follows:

Since:
Jan 15 2011
Version:
$Id: Database.java 483 2012-01-05 23:43:18Z jhyde $
Author:
Luc Boudreau

Nested Class Summary
static class Database.AuthenticationMode
          Describes the supported authentication modes.
static class Database.ProviderType
          Describes the possible provider types.
 
Method Summary
 List<Database.AuthenticationMode> getAuthenticationModes()
          Returns the authentication modes supported by this server.
 NamedList<Catalog> getCatalogs()
          Returns a list of Catalog objects which belong to this Database.
 String getDataSourceInfo()
          Returns provider-specific information.
 String getDescription()
          Returns a human-readable description of this Database.
 String getName()
          Returns the unique name of this Database.
 OlapConnection getOlapConnection()
          Retrieves the parent OlapConnection of this Database object.
 String getProviderName()
          Returns the name of the underlying OLAP provider.
 List<Database.ProviderType> getProviderTypes()
          Returns the types of data that are supported by this provider.
 String getURL()
          Returns a redirection URL.
 

Method Detail

getOlapConnection

OlapConnection getOlapConnection()
Retrieves the parent OlapConnection of this Database object.

Returns:
The parent conenction object.

getName

String getName()
               throws OlapException
Returns the unique name of this Database.

Returns:
The database name.
Throws:
OlapException - if error occurs.

getDescription

String getDescription()
                      throws OlapException
Returns a human-readable description of this Database.

Returns:
The database description. Can be null.
Throws:
OlapException - if error occurs.

getURL

String getURL()
              throws OlapException
Returns a redirection URL. This value is used only in distributed architectures. An OLAP server can serve as a frontal distribution server and redirect clients to delegate servers.

Implementations are free to implement a distributed system. Most implementations don't make any use of it and will return the same URL which was used to connect in the first place.

Returns:
The database URL. Can be null.
Throws:
OlapException - if error occurs.

getDataSourceInfo

String getDataSourceInfo()
                         throws OlapException
Returns provider-specific information.

Returns:
A string containing provider-specific information.
Throws:
OlapException - if error cccurs

getProviderName

String getProviderName()
                       throws OlapException
Returns the name of the underlying OLAP provider.

This usually is the server vendor name, for example "Mondrian" or "MSOLAP".

Returns:
The provider name.
Throws:
OlapException - if error occurs.

getProviderTypes

List<Database.ProviderType> getProviderTypes()
                                             throws OlapException
Returns the types of data that are supported by this provider.

Returns:
The provider types.
Throws:
OlapException - if error occurs.

getAuthenticationModes

List<Database.AuthenticationMode> getAuthenticationModes()
                                                         throws OlapException
Returns the authentication modes supported by this server.

Returns:
The authentication mode supported.
Throws:
OlapException - if error occurs.

getCatalogs

NamedList<Catalog> getCatalogs()
                               throws OlapException
Returns a list of Catalog objects which belong to this Database.

The caller should assume that the list is immutable; if the caller modifies the list, behavior is undefined.

Returns:
List of Catalog in this Database
Throws:
OlapException - if error occurs
See Also:
OlapConnection.getOlapCatalogs()

SourceForge.net_Logo