java/jdbc-loopback-driver/src/info/globalcode/jdbc/loopback/Driver.java
author František Kučera <franta-hg@frantovo.cz>
Tue, 26 Feb 2019 17:31:41 +0100
branchv_0
changeset 235 8ce612cca4d8
parent 177 5cc7fdad1452
permissions -rw-r--r--
JDBC drivers: fix 'Unsupported URL' – drivers might be called witrh wrong URLs and then they should (according to the JavaDoc) return null instead of throwing an exception. This problem occurred when --test-connection was testing multiple connections in parallel.
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
171
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
     1
/**
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
     2
 * SQL-DK
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
     3
 * Copyright © 2014 František Kučera (frantovo.cz)
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
     4
 *
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
     5
 * This program is free software: you can redistribute it and/or modify
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
     6
 * it under the terms of the GNU General Public License as published by
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
     7
 * the Free Software Foundation, either version 3 of the License, or
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
     8
 * (at your option) any later version.
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
     9
 *
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    10
 * This program is distributed in the hope that it will be useful,
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    11
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    12
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    13
 * GNU General Public License for more details.
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    14
 *
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    15
 * You should have received a copy of the GNU General Public License
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    16
 * along with this program. If not, see <http://www.gnu.org/licenses/>.
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    17
 */
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    18
package info.globalcode.jdbc.loopback;
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    19
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    20
import java.sql.DriverManager;
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    21
import java.sql.DriverPropertyInfo;
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    22
import java.sql.SQLException;
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    23
import java.sql.SQLFeatureNotSupportedException;
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    24
import java.util.Properties;
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    25
import java.util.logging.Level;
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    26
import java.util.logging.Logger;
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    27
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    28
/**
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    29
 *
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    30
 * @author Ing. František Kučera (frantovo.cz)
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    31
 */
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    32
public class Driver implements java.sql.Driver {
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    33
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    34
	private static final Logger log = Logger.getLogger(Driver.class.getName());
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    35
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    36
	static {
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    37
		try {
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    38
			DriverManager.registerDriver(new Driver());
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    39
		} catch (SQLException e) {
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    40
			log.log(Level.SEVERE, "Unable to register JDBC driver", e);
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    41
		}
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    42
	}
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    43
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    44
	@Override
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    45
	public Connection connect(String url, Properties info) throws SQLException {
177
5cc7fdad1452 jdbc-loopback: refuse connection if URL is unsupported
František Kučera <franta-hg@frantovo.cz>
parents: 171
diff changeset
    46
		if (acceptsURL(url)) {
5cc7fdad1452 jdbc-loopback: refuse connection if URL is unsupported
František Kučera <franta-hg@frantovo.cz>
parents: 171
diff changeset
    47
			return new Connection(url, info);
5cc7fdad1452 jdbc-loopback: refuse connection if URL is unsupported
František Kučera <franta-hg@frantovo.cz>
parents: 171
diff changeset
    48
		} else {
235
8ce612cca4d8 JDBC drivers: fix 'Unsupported URL' – drivers might be called witrh wrong URLs and then they should (according to the JavaDoc) return null instead of throwing an exception.
František Kučera <franta-hg@frantovo.cz>
parents: 177
diff changeset
    49
			// The driver should return "null" if it realizes it is the wrong kind of driver to connect to the given URL.
8ce612cca4d8 JDBC drivers: fix 'Unsupported URL' – drivers might be called witrh wrong URLs and then they should (according to the JavaDoc) return null instead of throwing an exception.
František Kučera <franta-hg@frantovo.cz>
parents: 177
diff changeset
    50
			return null;
177
5cc7fdad1452 jdbc-loopback: refuse connection if URL is unsupported
František Kučera <franta-hg@frantovo.cz>
parents: 171
diff changeset
    51
		}
171
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    52
	}
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    53
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    54
	@Override
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    55
	public boolean acceptsURL(String url) throws SQLException {
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    56
		return url != null && url.startsWith("jdbc:loopback://");
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    57
	}
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    58
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    59
	@Override
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    60
	public DriverPropertyInfo[] getPropertyInfo(String url, Properties info) throws SQLException {
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    61
		return new DriverPropertyInfo[0];
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    62
	}
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    63
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    64
	@Override
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    65
	public int getMajorVersion() {
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    66
		return 0;
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    67
	}
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    68
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    69
	@Override
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    70
	public int getMinorVersion() {
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    71
		return 1;
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    72
	}
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    73
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    74
	@Override
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    75
	public boolean jdbcCompliant() {
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    76
		return false;
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    77
	}
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    78
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    79
	@Override
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    80
	public Logger getParentLogger() throws SQLFeatureNotSupportedException {
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    81
		throw new SQLFeatureNotSupportedException("Not supported yet.");
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    82
	}
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    83
701ec4db43fb JDBC loopback driver: first version
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    84
}