001    /*
002    // This software is subject to the terms of the Eclipse Public License v1.0
003    // Agreement, available at the following URL:
004    // http://www.eclipse.org/legal/epl-v10.html.
005    // Copyright (C) 2008-2008 Julian Hyde
006    // All Rights Reserved.
007    // You must accept the terms of that agreement to use this software.
008    */
009    package org.olap4j;
010    
011    import javax.sql.DataSource;
012    import java.sql.SQLException;
013    
014    /**
015     * <p>A factory for connections to the physical OLAP data source that this
016     * <code>OlapDataSource</code> object represents.
017     *
018     * <p><code>OlapDataSource</code> is a refinement of
019     * {@link javax.sql.DataSource} whose <code>getConnection</code> methods
020     * return {@link org.olap4j.OlapConnection} objects rather than mere
021     * {@link java.sql.Connection}s.
022     *
023     * @author jhyde
024     * @version $Id: OlapDataSource.java 229 2009-05-08 19:11:29Z jhyde $
025     * @since Mar 25, 2008
026     */
027    public interface OlapDataSource extends DataSource {
028    
029        // override with more specific return type
030        OlapConnection getConnection() throws SQLException;
031    
032        // override with more specific return type
033        OlapConnection getConnection(
034            String username,
035            String password)
036            throws SQLException;
037    }
038    
039    // End OlapDataSource.java