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    */
020    package org.olap4j;
021    
022    import java.sql.SQLException;
023    import 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     */
038    public 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