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.

See Also:
Profile

Method Index

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

Methods

 o 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.

 o 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