    All Packages    This Package  Previous  Next

# Interface sqlj.runtime.profile.Customization

public interface interface Customization
extends Serializable

A profile Customization is a serializable object which maps a particular jdbc connection and basic profile into a customized connected profile. Because both profiles and customizations are serializable, new customizations may be added to profiles as needed anytime after the profile has been created. This will most often happen during an "installation" phase after the application has been translated, but before the application is actually run.

Profiles may be customized in any number of ways. Some typical examples are listed.

- Transformation of sql text into a format which allows more efficient execution on a particular data source. Precompilation and use of stored procedures are examples of this.
- Batch verification and/or preparation of profile entries to avoid mutliple data source round trips.
- Distributed and/or remote loading of custom entries.
- Custom type registration of data source specific entry parameters.
- Behavioral unification of multiple JDBC drivers with which an application is to be deployed.

See Also:
  Profile

##

acceptsConnection(Connection)
  Returns true if this customization can create a connected profile instance for the given jdbc connection, false otherwise.
getProfile(Connection, Profile)
  Returns a connected profile for the baseProfile on the given jdbc connection.

##

acceptsConnection

     public abstract boolean acceptsConnection(Connection conn)

  Returns true if this customization can create a connected profile instance for the given jdbc connection, false otherwise.

getProfile

     public abstract ConnectedProfile getProfile(Connection conn,
                                                 Profile baseProfile) throws SQLException

  Returns a connected profile for the baseProfile on the given jdbc connection. If the profile cannot be connected, an exception is raised. The exception may be the result of the base profile containing entries which cannot be prepared and executed on the particular connection. Depending on the implementation of the customization, verification of profile entries may occur when the profile is connected, or be deferred until an entry is directly accessed by the client.

  Throws: SQLException
    if the profile cannot be connected.

    All Packages    This Package  Previous  Next