org.eclipse.persistence.sessions
Class DefaultConnector

java.lang.Object
  extended by org.eclipse.persistence.sessions.DefaultConnector
All Implemented Interfaces:
java.io.Serializable, java.lang.Cloneable, Connector
Direct Known Subclasses:
DirectConnector

public class DefaultConnector
extends java.lang.Object
implements Connector

Purpose:Use this Connector to build a java.sql.Connection in the "standard" fashion, via the DriverManager.

Since:
TOPLink/Java 2.1
Author:
Big Country
See Also:
Serialized Form

Constructor Summary
DefaultConnector()
          PUBLIC: Construct a Connector with default settings The database URL will still need to be set.
DefaultConnector(java.lang.String driverClassName, java.lang.String driverURLHeader, java.lang.String databaseURL)
          PUBLIC: Construct a Connector with the specified settings.
 
Method Summary
 void clearDriverClassAndDriver()
          INTERNAL: Discard the cached driver class and driver.
 java.lang.Object clone()
          INTERNAL: Clone the connector.
 java.sql.Connection connect(java.util.Properties properties, Session session)
          INTERNAL: Connect with the specified properties and session.
 java.lang.String getConnectionDetails()
          PUBLIC: Provide the details of my connection information.
 java.lang.String getConnectionString()
          PUBLIC: Return the JDBC connection string.
 java.lang.String getDatabaseURL()
          PUBLIC: The database URL is the JDBC URL for the database server.
 java.lang.String getDriverClassName()
          PUBLIC: The driver class is the name of the Java class for the JDBC driver being used (e.g.
 java.lang.String getDriverURLHeader()
          PUBLIC: The driver URL header is the string predetermined by the JDBC driver to be part of the URL connection string, (e.g.
 void setDatabaseURL(java.lang.String databaseURL)
          PUBLIC: The database URL is the JDBC URL for the database server.
 void setDriverClassName(java.lang.String driverClassName)
          PUBLIC: The driver class is the name of the Java class for the JDBC driver being used (e.g.
 void setDriverURLHeader(java.lang.String driverURLHeader)
          PUBLIC: The driver URL header is the string predetermined by the JDBC driver to be part of the URL connection string, (e.g.
 boolean shouldUseDriverManager(java.util.Properties properties, Session session)
          INTERNAL: Indicates whether DriverManager should be used.
 java.lang.String toString()
          PUBLIC: Print connection string.
 void toString(java.io.PrintWriter writer)
          INTERNAL: Print something useful on the log.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

DefaultConnector

public DefaultConnector()
PUBLIC: Construct a Connector with default settings The database URL will still need to be set.


DefaultConnector

public DefaultConnector(java.lang.String driverClassName,
                        java.lang.String driverURLHeader,
                        java.lang.String databaseURL)
PUBLIC: Construct a Connector with the specified settings.

Method Detail

clone

public java.lang.Object clone()
INTERNAL: Clone the connector.

Specified by:
clone in interface Connector
Overrides:
clone in class java.lang.Object

connect

public java.sql.Connection connect(java.util.Properties properties,
                                   Session session)
                            throws DatabaseException
INTERNAL: Connect with the specified properties and session. Return the Connection.

Specified by:
connect in interface Connector
Returns:
java.sql.Connection
Throws:
DatabaseException

shouldUseDriverManager

public boolean shouldUseDriverManager(java.util.Properties properties,
                                      Session session)
INTERNAL: Indicates whether DriverManager should be used.

Returns:
boolean

getConnectionString

public java.lang.String getConnectionString()
PUBLIC: Return the JDBC connection string. This is a combination of the driver-specific URL header and the database URL.


getConnectionDetails

public java.lang.String getConnectionDetails()
PUBLIC: Provide the details of my connection information. This is primarily for JMX runtime services.

Specified by:
getConnectionDetails in interface Connector
Returns:
java.lang.String

getDatabaseURL

public java.lang.String getDatabaseURL()
PUBLIC: The database URL is the JDBC URL for the database server. The driver header is not be included in this URL (e.g. "dbase files"; not "jdbc:odbc:dbase files").


getDriverClassName

public java.lang.String getDriverClassName()
PUBLIC: The driver class is the name of the Java class for the JDBC driver being used (e.g. "sun.jdbc.odbc.JdbcOdbcDriver").


getDriverURLHeader

public java.lang.String getDriverURLHeader()
PUBLIC: The driver URL header is the string predetermined by the JDBC driver to be part of the URL connection string, (e.g. "jdbc:odbc:"). This is required to connect to the database.


setDatabaseURL

public void setDatabaseURL(java.lang.String databaseURL)
PUBLIC: The database URL is the JDBC URL for the database server. The driver header is not be included in this URL (e.g. "dbase files"; not "jdbc:odbc:dbase files").


setDriverClassName

public void setDriverClassName(java.lang.String driverClassName)
PUBLIC: The driver class is the name of the Java class for the JDBC driver being used (e.g. "sun.jdbc.odbc.JdbcOdbcDriver").


setDriverURLHeader

public void setDriverURLHeader(java.lang.String driverURLHeader)
PUBLIC: The driver URL header is the string predetermined by the JDBC driver to be part of the URL connection string, (e.g. "jdbc:odbc:"). This is required to connect to the database.


toString

public java.lang.String toString()
PUBLIC: Print connection string.

Overrides:
toString in class java.lang.Object

toString

public void toString(java.io.PrintWriter writer)
INTERNAL: Print something useful on the log.

Specified by:
toString in interface Connector

clearDriverClassAndDriver

public void clearDriverClassAndDriver()
INTERNAL: Discard the cached driver class and driver.