Class 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.
      • 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
      • 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.