001    /*
002     * Licensed to the Apache Software Foundation (ASF) under one or more
003     * contributor license agreements.  See the NOTICE file distributed with
004     * this work for additional information regarding copyright ownership.
005     * The ASF licenses this file to You under the Apache License, Version 2.0
006     * (the "License"); you may not use this file except in compliance with
007     * the License.  You may obtain a copy of the License at
008     * 
009     *      http://www.apache.org/licenses/LICENSE-2.0
010     * 
011     * Unless required by applicable law or agreed to in writing, software
012     * distributed under the License is distributed on an "AS IS" BASIS,
013     * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
014     * See the License for the specific language governing permissions and
015     * limitations under the License.
016     */
017    
018    package org.apache.commons.dbcp;
019    import java.sql.Connection;
020    import java.sql.SQLException;
021    
022    /**
023     * Abstract factory interface for creating {@link java.sql.Connection}s.
024     *
025     * @author Rodney Waldhoff
026     * @version $Revision: 892307 $ $Date: 2013-12-31 23:27:28 +0000 (Tue, 31 Dec 2013) $
027     */
028    public interface ConnectionFactory {
029        /**
030         * Create a new {@link java.sql.Connection} in an
031         * implementation specific fashion.
032         *
033         * @return a new {@link java.sql.Connection}
034         * @throws SQLException if a database error occurs creating the connection
035         */
036        public abstract Connection createConnection() throws SQLException;
037    }