001/*
002// $Id: OlapDataSource.java 482 2012-01-05 23:27:27Z jhyde $
003//
004// Licensed to Julian Hyde under one or more contributor license
005// agreements. See the NOTICE file distributed with this work for
006// additional information regarding copyright ownership.
007//
008// Julian Hyde licenses this file to you under the Apache License,
009// Version 2.0 (the "License"); you may not use this file except in
010// compliance with the License. You may obtain a copy of the License at:
011//
012// http://www.apache.org/licenses/LICENSE-2.0
013//
014// Unless required by applicable law or agreed to in writing, software
015// distributed under the License is distributed on an "AS IS" BASIS,
016// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
017// See the License for the specific language governing permissions and
018// limitations under the License.
019*/
020package org.olap4j;
021
022import java.sql.SQLException;
023import javax.sql.DataSource;
024
025/**
026 * <p>A factory for connections to the physical OLAP data source that this
027 * <code>OlapDataSource</code> object represents.
028 *
029 * <p><code>OlapDataSource</code> is a refinement of
030 * {@link javax.sql.DataSource} whose <code>getConnection</code> methods
031 * return {@link org.olap4j.OlapConnection} objects rather than mere
032 * {@link java.sql.Connection}s.
033 *
034 * @author jhyde
035 * @version $Id: OlapDataSource.java 482 2012-01-05 23:27:27Z jhyde $
036 * @since Mar 25, 2008
037 */
038public interface OlapDataSource extends DataSource {
039
040    // override with more specific return type
041    OlapConnection getConnection() throws SQLException;
042
043    // override with more specific return type
044    OlapConnection getConnection(
045        String username,
046        String password)
047        throws SQLException;
048}
049
050// End OlapDataSource.java