Interface Connector

  • All Superinterfaces:
    Cloneable, Serializable
    All Known Implementing Classes:
    DefaultConnector, DirectConnector, EISConnectionSpec, JNDIConnector, OracleOCIProxyConnector

    public interface Connector
    extends Serializable, Cloneable
    Purpose: Define an interface for supplying TopLink with a Connection to a JDBC database.

    Description: This interface defines the methods to be implemented that allow TopLink to acquire a Connection to a JDBC database. There are only 2 methods that need to be implemented:

    java.sql.Connection connect(java.util.Properties properties)
    void toString( writer)
    Once these methods have been implemented, an instance of the new Connector can be passed to a JDBCLogin at startup. For example:
    session.getLogin().setConnector(new FooConnector());
    See Also:
    Big Country
    TOPLink/Java 2.1
    • Method Detail

      • clone

        Object clone()
        INTERNAL: Must be cloneable.
      • connect

        Connection connect​(Properties properties,
                           Session session)
        INTERNAL: Connect with the specified properties and return the Connection. The properties are driver-specific; but usually contain the "user" and "password". Additional properties can be built by using JDBCLogin.setProperty(String propertyName, Object propertyValue).
      • toString

        void toString​(PrintWriter writer)
        INTERNAL: Print something useful on the log. This information will be displayed on the EclipseLink log (by default System.out) at login. See the other implementations of this method for examples.
      • getConnectionDetails

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