    All Packages    This Package  Previous  Next

# Class sqlj.runtime.profile.util.AuditedProfile

    java.lang.Object
       |
       +----sqlj.runtime.profile.ref.ProfileWrapper
               |
               +----sqlj.runtime.profile.util.AuditedProfile

public class AuditedProfile
extends ProfileWrapper

An audited profile is a profile wrapper that wraps all RTStatements and RTResultSets it returns with classes that audit the calls made. This is useful in debugging the calls made to various different levels of profile wraping. Each call made to a method is registered with an auditor, the return result from each call is registered, and an exception thrown, if any is registered. An auditor is an interface that may be implemented to handle the auditing process in any number of different ways. The most common auditors will log all calls to a file or System.out.

RESTRICTIONS: currently does not support auditing of direct JDBC calls, only RT* calls.

##

AuditedProfile(ConnectedProfile, Auditor)
  Creates an audited connected profile wrapper built on top of the specified connected profile.

##

close()
  Makes an audited call to method close
getConnection()
  Makes an audited call to method getConnection
getProfileData()
  Makes an audited call to method getProfileData
getStatement(int)
  Makes an audited call to method getStatement
newProfile(ConnectedProfile, Auditor)
  Creates a new audited connected profile instance which wraps the given connected profile, and registers all calls to the given auditor.
newProfile(DynamicProfile, Auditor)
  Creates a new audited dynamic profile instance which wraps the given dynamic profile, and registers all calls to the given auditor.

##

AuditedProfile

     public AuditedProfile(ConnectedProfile profile,
                           Auditor auditor)

  Creates an audited connected profile wrapper built on top of the specified connected profile.

  Parameters:
    profile - the underlying connected profile.
    auditor - the auditor on which to register calls.

##

newProfile

     public static ConnectedProfile newProfile(ConnectedProfile profile,
                                               Auditor auditor)

  Creates a new audited connected profile instance which wraps the given connected profile, and registers all calls to the given auditor.

  Parameters:
    profile - the connected profile to wrap
    auditor - the auditor on which to register calls

newProfile

     public static DynamicProfile newProfile(DynamicProfile profile,
                                             Auditor auditor)

  Creates a new audited dynamic profile instance which wraps the given dynamic profile, and registers all calls to the given auditor.

  Parameters:
    profile - the dynamic profile to wrap
    auditor - the auditor on which to register calls

getProfileData

     public ProfileData getProfileData()

  Makes an audited call to method getProfileData

  Overrides:
    getProfileData in class ProfileWrapper

getConnection

     public Connection getConnection()

  Makes an audited call to method getConnection

  Overrides:
    getConnection in class ProfileWrapper

getStatement

     public RTStatement getStatement(int p0) throws SQLException

  Makes an audited call to method getStatement

  Throws: SQLException
    if audited method raises this exception
  Overrides:
    getStatement in class ProfileWrapper

close

     public void close() throws SQLException

  Makes an audited call to method close

  Throws: SQLException
    if audited method raises this exception
  Overrides:
    close in class ProfileWrapper

    All Packages    This Package  Previous  Next