Package org.eclipse.persistence.sessions
Class DefaultConnector
- java.lang.Object
-
- 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
Constructors Constructor Description 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
All Methods Instance Methods Concrete Methods Modifier and Type Method Description 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.
-
-
-
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.
-
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 interfaceConnector
- 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 interfaceConnector
- 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 classjava.lang.Object
-
toString
public void toString(java.io.PrintWriter writer)
INTERNAL: Print something useful on the log.
-
clearDriverClassAndDriver
public void clearDriverClassAndDriver()
INTERNAL: Discard the cached driver class and driver.
-
-