org.objectweb.cjdbc.controller.connection.DriverManager Class Reference

List of all members.

Static Public Member Functions
Connection	getConnection (String url, String user, String password, String driverPathName, String driverClassName) throws SQLException
void	loadDriverClass (String driverClassName) throws ClassNotFoundException
File	convertToAbsolutePath (String pathName) throws IOException
Static Package Attributes
Trace	logger

---

Detailed Description

This class defines a DriverManager. In contrast to java.sql.DriverManager this class allows to use Drivers with the same name but with different versions, if no drivername is used it is a wrapper around java.sql.DriverManager.

Author:

Emmanuel Cecchet

Version:

1.0

Definition at line 52 of file DriverManager.java.

---

Member Function Documentation

File org.objectweb.cjdbc.controller.connection.DriverManager.convertToAbsolutePath (  String  pathName  )  throws IOException [static]

convert a path into an absolute path if the path is already an absolute path, it is just returned otherwise a relative path is considered to be relative to the drivers directory Parameters: pathName  the relativ or absolute path Returns: the converted path Exceptions: IOException  if the converted path does not exist Definition at line 208 of file DriverManager.java. { File dir = null; if (pathName != null) { File path = new File(pathName); if (path.canRead()) return path; else throw new IOException("Invalid path name " + pathName); } else { dir = getDriversDir(); } if (!dir.canRead()) { String msg = Translate.get("controller.driver.dir.not.found"); logger.error(msg); throw new IOException(msg); } return dir; }

Connection org.objectweb.cjdbc.controller.connection.DriverManager.getConnection (  String  url, String  user, String  password, String  driverPathName, String  driverClassName )  throws SQLException [static]

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. Parameters: url  a database url of the form jdbc:subprotocol:subname user  the database user on whose behalf the connection is being made password  the user's password driverPathName  the path where the driver classes are located, null if default directory driverClassName  the class name of the driver Returns: a connection to the URL Exceptions: SQLException  if a database access error occurs Definition at line 85 of file DriverManager.java. { Driver driver = null; boolean isDefaultPath = false; if (driverPathName == null) { // no path specified // have we already loaded this driver driver = (Driver) namedDrivers.get(driverClassName); if (driver == null) { // the driver has not yet been loaded // first we try to load class from classpath try { if (driverClassName != null) { loadDriverClass(driverClassName); } return java.sql.DriverManager.getConnection(url, user, password); } catch (ClassNotFoundException e) { if (driverClassName == null) { throw new SQLException( "could not load driver as no class name is specified "); } try { driverPathName = getDriversDir().getAbsolutePath(); isDefaultPath = true; } catch (IOException ioExc) { throw new SQLException("could not find default drivers directory"); } } } } if (driver == null) { // have we already loaded this named driver ? driver = (Driver) namedDrivers.get(driverPathName); } if (driver == null) { // no driver with this name has been loaded so far try { File path = convertToAbsolutePath(driverPathName); // we load the driver now if (logger.isDebugEnabled()) { logger.debug("loading driver with name " + driverPathName + " for class " + driverClassName); } driver = loadDriver(path, driverClassName); } catch (Exception e) { if (logger.isDebugEnabled()) { logger.debug("could not load driver for class " + driverClassName, e); } throw new SQLException("could not load driver for class name " + driverClassName + " and driverPath " + driverPathName); } // driver has been loaded successfully, we cache it for // further use if (isDefaultPath) {// we cache it with the class name namedDrivers.put(driverClassName, driver); } else { // we cache it with the pathName namedDrivers.put(driverPathName, driver); } } return getConnectionForDriver(url, user, password, driver); }

void org.objectweb.cjdbc.controller.connection.DriverManager.loadDriverClass (  String  driverClassName  )  throws ClassNotFoundException [static]

Load the driver class Parameters: driverClassName  the class name of the driver Exceptions: ClassNotFoundException  if the class could not be found Definition at line 181 of file DriverManager.java. { if (!defaultDrivers.contains(driverClassName)) { if (logger.isDebugEnabled()) { logger.debug("we are using default classloader and driverClassName =" + driverClassName); } Class.forName(driverClassName); if (logger.isDebugEnabled()) logger.debug(Translate.get("backend.driver.loaded", driverClassName)); // the driver was successfully loaded defaultDrivers.add(driverClassName); } }

---

Member Data Documentation

Trace org.objectweb.cjdbc.controller.connection.DriverManager.logger [static, package]

Initial value: Trace .getLogger("org.objectweb.cjdbc.controller.connection.DriverManager") Logger instance. Definition at line 56 of file DriverManager.java.

---

The documentation for this class was generated from the following file:

• DriverManager.java

---