All Packages This Package Previous Next
Interface sqlj.runtime.profile.Customization
- public 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