001/**
002 *
003 * Copyright (c) 2014, the Railo Company Ltd. All rights reserved.
004 *
005 * This library is free software; you can redistribute it and/or
006 * modify it under the terms of the GNU Lesser General Public
007 * License as published by the Free Software Foundation; either 
008 * version 2.1 of the License, or (at your option) any later version.
009 * 
010 * This library is distributed in the hope that it will be useful,
011 * but WITHOUT ANY WARRANTY; without even the implied warranty of
012 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
013 * Lesser General Public License for more details.
014 * 
015 * You should have received a copy of the GNU Lesser General Public 
016 * License along with this library.  If not, see <http://www.gnu.org/licenses/>.
017 * 
018 **/
019package lucee.runtime.db;
020
021import java.sql.Connection;
022import java.sql.PreparedStatement;
023import java.sql.SQLException;
024
025/**
026 * a datasource and connection pair
027 */
028public interface DatasourceConnection {
029
030    /**
031     * @return Returns the connection.
032     */
033    public abstract Connection getConnection();
034
035    /**
036     * @return Returns the datasource.
037     */
038    public abstract DataSource getDatasource();
039
040    /**
041     * @return is timeout or not
042     */
043    public abstract boolean isTimeout();
044    
045
046
047        /**
048         * @return the password
049         */
050        public String getPassword();
051
052        /**
053         * @return the username
054         */
055        public String getUsername() ;
056
057        public boolean supportsGetGeneratedKeys();
058        
059        public PreparedStatement getPreparedStatement(SQL sql, boolean createGeneratedKeys, boolean allowCaching) throws SQLException;
060        public PreparedStatement getPreparedStatement(SQL sql, int resultSetType,int resultSetConcurrency) throws SQLException;
061        
062        public void close() throws SQLException;
063        
064        
065
066        
067}