package java.sql; /** Patch version */ public class DriverManager { /** * The SQLPermission constant that allows the * setting of the logging stream. * @since 1.3 */ static final SQLPermission SET_LOG_PERMISSION = new SQLPermission("setLog"); //--------------------------JDBC 2.0----------------------------- /** * Retrieves the log writer. * * The getLogWriter and setLogWriter * methods should be used instead * of the get/setlogStream methods, which are deprecated. * @return a java.io.PrintWriter object * @see #setLogWriter * @since 1.2 */ public static java.io.PrintWriter getLogWriter() { synchronized (logSync) { return logWriter; } } /** * Sets the logging/tracing PrintWriter object * that is used by the DriverManager and all drivers. *

* There is a minor versioning problem created by the introduction * of the method setLogWriter. The * method setLogWriter cannot create a PrintStream object * that will be returned by getLogStream---the Java platform does * not provide a backward conversion. As a result, a new application * that uses setLogWriter and also uses a JDBC 1.0 driver that uses * getLogStream will likely not see debugging information written * by that driver. *

* In the Java 2 SDK, Standard Edition, version 1.3 release, this method checks * to see that there is an SQLPermission object before setting * the logging stream. If a SecurityManager exists and its * checkPermission method denies setting the log writer, this * method throws a java.lang.SecurityException. * * @param out the new logging/tracing PrintStream object; * null to disable logging and tracing * @throws SecurityException * if a security manager exists and its * checkPermission method denies * setting the log writer * * @see SecurityManager#checkPermission * @see #getLogWriter * @since 1.2 */ public static void setLogWriter(java.io.PrintWriter out) { SecurityManager sec = System.getSecurityManager(); if (sec != null) { sec.checkPermission(SET_LOG_PERMISSION); } synchronized (logSync) { logStream = null; logWriter = out; } } //--------------------------------------------------------------- /** * Attempts to establish a connection to the given database URL. * The DriverManager attempts to select an appropriate driver from * the set of registered JDBC drivers. * * @param url a database url of the form * jdbc:subprotocol:subname * @param info a list of arbitrary string tag/value pairs as * connection arguments; normally at least a "user" and * "password" property should be included * @return a Connection to the URL * @exception SQLException if a database access error occurs */ public static synchronized Connection getConnection(String url, java.util.Properties info) throws SQLException { // Gets the classloader of the code that called this method, may // be null. ClassLoader callerCL = DriverManager.getCallerClassLoader(); return (getConnection(url, info, callerCL)); } /* *******************************PATCH************************************ */ /** * Attempts to establish a connection to the given database URL. * The DriverManager attempts to select an appropriate driver from * the set of registered JDBC drivers. * * @param url a database url of the form * jdbc:subprotocol:subname * @param user the database user on whose behalf the connection is being * made * @param password the user's password * @return a connection to the URL * @exception SQLException if a database access error occurs */ public static Connection getConnection(String url, String user, String password) throws SQLException { java.util.Properties info = new java.util.Properties(); // Gets the classloader of the code that called this method, may // be null. ClassLoader callerCL = DriverManager.getCallerClassLoader(); if (user != null) { info.put("user", user); } if (password != null) { info.put("password", password); } return (getConnection(url, info, callerCL)); } /** * Attempts to establish a connection to the given database URL. * The DriverManager attempts to select an appropriate driver from * the set of registered JDBC drivers. * * @param url a database url of the form * jdbc:subprotocol:subname * @return a connection to the URL * @exception SQLException if a database access error occurs */ public static synchronized Connection getConnection(String url) throws SQLException { java.util.Properties info = new java.util.Properties(); // Gets the classloader of the code that called this method, may // be null. ClassLoader callerCL = DriverManager.getCallerClassLoader(); return (getConnection(url, info, callerCL)); } /** * Attempts to locate a driver that understands the given URL. * The DriverManager attempts to select an appropriate driver from * the set of registered JDBC drivers. * * @param url a database URL of the form * jdbc:subprotocol:subname * @return a Driver object representing a driver * that can connect to the given URL * @exception SQLException if a database access error occurs */ public static synchronized Driver getDriver(String url) throws SQLException { println("DriverManager.getDriver(\"" + url + "\")"); if (!initialized) { initialize(); } // Gets the classloader of the code that called this method, may // be null. ClassLoader callerCL = DriverManager.getCallerClassLoader(); // Walk through the loaded drivers attempting to locate someone // who understands the given URL. for (int i = 0; i < drivers.size(); i++) { DriverInfo di = (DriverInfo)drivers.elementAt(i); // If the caller does not have permission to load the driver then // skip it. if (getCallerClass(callerCL, di.driverClassName) != di.driverClass) { println(" skipping: " + di); continue; } try { println(" trying " + di); if (di.driver.acceptsURL(url)) { // Success! println("getDriver returning " + di); return (di.driver); } } catch (SQLException ex) { // Drop through and try the next driver. } } println("getDriver: no suitable driver"); throw new SQLException("No suitable driver", "08001"); } /** * Registers the given driver with the DriverManager. * A newly-loaded driver class should call * the method registerDriver to make itself * known to the DriverManager. * * @param driver the new JDBC Driver that is to be registered with the * DriverManager * @exception SQLException if a database access error occurs */ public static synchronized void registerDriver(java.sql.Driver driver) throws SQLException { if (!initialized) { initialize(); } DriverInfo di = new DriverInfo(); di.driver = driver; di.driverClass = driver.getClass(); di.driverClassName = di.driverClass.getName(); drivers.addElement(di); println("registerDriver: " + di); } /** * Drops a driver from the DriverManager's list. Applets can only * deregister drivers from their own classloaders. * * @param driver the JDBC Driver to drop * @exception SQLException if a database access error occurs */ public static synchronized void deregisterDriver(Driver driver) throws SQLException { // Gets the classloader of the code that called this method, may // be null. ClassLoader callerCL = DriverManager.getCallerClassLoader(); println("DriverManager.deregisterDriver: " + driver); // Walk through the loaded drivers. int i; DriverInfo di = null; for (i = 0; i < drivers.size(); i++) { di = (DriverInfo)drivers.elementAt(i); if (di.driver == driver) { break; } } // If we can't find the driver just return. if (i >= drivers.size()) { println(" couldn't find driver to unload"); return; } // If the caller does not have permission to load the driver then // throw a security exception. if (getCallerClass(callerCL, di.driverClassName) != di.driverClass) { throw new SecurityException(); } // Remove the driver. Other entries in drivers get shuffled down. drivers.removeElementAt(i); } /** * Retrieves an Enumeration with all of the currently loaded JDBC drivers * to which the current caller has access. * *

Note: The classname of a driver can be found using * d.getClass().getName() * * @return the list of JDBC Drivers loaded by the caller's class loader */ public static synchronized java.util.Enumeration getDrivers() { java.util.Vector result = new java.util.Vector(); if (!initialized) { initialize(); } // Gets the classloader of the code that called this method, may // be null. ClassLoader callerCL = DriverManager.getCallerClassLoader(); // Walk through the loaded drivers. for (int i = 0; i < drivers.size(); i++) { DriverInfo di = (DriverInfo)drivers.elementAt(i); // If the caller does not have permission to load the driver then // skip it. if (getCallerClass(callerCL, di.driverClassName) != di.driverClass) { println(" skipping: " + di); continue; } result.addElement(di.driver); } return (result.elements()); } /** * Sets the maximum time in seconds that a driver will wait * while attempting to connect to a database. * * @param seconds the login time limit in seconds * @see #getLoginTimeout */ public static void setLoginTimeout(int seconds) { loginTimeout = seconds; } /** * Gets the maximum time in seconds that a driver can wait * when attempting to log in to a database. * * @return the driver login time limit in seconds * @see #setLoginTimeout */ public static int getLoginTimeout() { return (loginTimeout); } /** * Sets the logging/tracing PrintStream that is used * by the DriverManager * and all drivers. *

* In the Java 2 SDK, Standard Edition, version 1.3 release, this method checks * to see that there is an SQLPermission object before setting * the logging stream. If a SecurityManager exists and its * checkPermission method denies setting the log writer, this * method throws a java.lang.SecurityException. * * @param out the new logging/tracing PrintStream; to disable, set to null * @deprecated * @throws SecurityException if a security manager exists and its * checkPermission method denies setting the log stream * * @see SecurityManager#checkPermission * @see #getLogStream */ @Deprecated public static synchronized void setLogStream(java.io.PrintStream out) { SecurityManager sec = System.getSecurityManager(); if (sec != null) { sec.checkPermission(SET_LOG_PERMISSION); } logStream = out; if (out != null) logWriter = new java.io.PrintWriter(out); else logWriter = null; } /** * Retrieves the logging/tracing PrintStream that is used by the DriverManager * and all drivers. * * @return the logging/tracing PrintStream; if disabled, is null * @deprecated * @see #setLogStream */ @Deprecated public static java.io.PrintStream getLogStream() { return logStream; } /** * Prints a message to the current JDBC log stream. * * @param message a log or tracing message */ public static void println(String message) { synchronized (logSync) { if (logWriter != null) { logWriter.println(message); // automatic flushing is never enabled, so we must do it ourselves logWriter.flush(); } } } //------------------------------------------------------------------------ // Returns the class object that would be created if the code calling the // driver manager had loaded the driver class, or null if the class // is inaccessible. private static Class getCallerClass(ClassLoader callerClassLoader, String driverClassName) { Class callerC = null; try { callerC = Class.forName(driverClassName, true, callerClassLoader); } catch (Exception ex) { callerC = null; // being very careful } return callerC; } private static void loadInitialDrivers() { String drivers; try { drivers = (String)java.security.AccessController.doPrivileged(new sun.security.action.GetPropertyAction("jdbc.drivers")); } catch (Exception ex) { drivers = null; } println("DriverManager.initialize: jdbc.drivers = " + drivers); if (drivers == null) { return; } while (drivers.length() != 0) { int x = drivers.indexOf(':'); String driver; if (x < 0) { driver = drivers; drivers = ""; } else { driver = drivers.substring(0, x); drivers = drivers.substring(x + 1); } if (driver.length() == 0) { continue; } try { println("DriverManager.Initialize: loading " + driver); Class.forName(driver, true, ClassLoader.getSystemClassLoader()); } catch (Exception ex) { println("DriverManager.Initialize: load failed: " + ex); } } } // Worker method called by the public getConnection() methods. /* *******************************PATCH*************************************/ private static Connection getConnection(String url, java.util.Properties info, ClassLoader callerCL) throws SQLException { /* * When callerCl is null, we should check the application's * (which is invoking this class indirectly) * classloader, so that the JDBC driver class outside rt.jar * can be loaded from here. */ if (callerCL == null) { callerCL = Thread.currentThread().getContextClassLoader(); } if (url == null) { throw new SQLException("The url cannot be null", "08001"); } println("DriverManager.getConnection(\"" + url + "\")"); if (!initialized) { synchronized (DriverManager.class) { if (!initialized) initialize(); } } // Current DirverInfo in iteration. DriverInfo di = null; // Synchronize this so adding or removing drivers wont screw us up. synchronized (DriverManager.class) { // Walk through the loaded drivers attempting to make a connection. for (int i = 0; i < drivers.size(); i++) { di = (DriverInfo)drivers.elementAt(i); println(" trying " + di); // See if the Driver accepts this URL if (di.driver.acceptsURL(url)) { // bust out of this loop with the right url break; } else { // reset the DriverInfo. di = null; } } } // If the DriverInfo was null, there was no suitable Driver if (di == null) { println("getConnection: no suitable driver"); throw new SQLException("No suitable driver", "08001"); } // Attempt to gain a connection. println(" trying " + di); Connection result = di.driver.connect(url, info); if (result != null) { // Success! println("getConnection returning " + di); return (result); } else { println("getConnection: driver returned null Connection"); throw new SQLException("null connection", "08001"); } } // Class initialization. static void initialize() { if (initialized) { return; } initialized = true; loadInitialDrivers(); println("JDBC DriverManager initialized"); } // Prevent the DriverManager class from being instantiated. private DriverManager() { } private static java.util.Vector drivers = new java.util.Vector(); private static int loginTimeout = 0; private static java.io.PrintWriter logWriter = null; private static java.io.PrintStream logStream = null; private static boolean initialized = false; private static Object logSync = new Object(); // Returns the caller's class loader, or null if none private static native ClassLoader getCallerClassLoader(); } // DriverInfo is a package-private support class. class DriverInfo { Driver driver; Class driverClass; String driverClassName; public String toString() { return ("driver[className=" + driverClassName + "," + driver + "]"); } }