com.tc.object.logging
Interface InstrumentationLogger

All Known Implementing Classes:
NullInstrumentationLogger

public interface InstrumentationLogger

Logging interface for the DSO class loading/adaption system


Method Summary
 void autolockInserted(java.lang.String className, java.lang.String methodName, java.lang.String methodDesc, LockDefinition lockDef)
          Log that auto lock was inserted
 void classIncluded(java.lang.String className)
          Log class that is being instrumented
 void distMethodCallInserted(java.lang.String className, java.lang.String methodName, java.lang.String desc)
          Log that a DMI call was inserted.
 boolean getClassInclusion()
          Determine whether to log when a class is included for instrumentation (checked before calls to classIncluded(String)).
 boolean getDistMethodCallInsertion()
          Determine whether to log when a DMI call is inserted (checked before calls to distMethodCallInserted(String, String, String)).
 boolean getLockInsertion()
          Determine whether to log when a lock is inserted (checked before calls to autolockInserted(String, String, String, LockDefinition) or lockInserted(String, String, String, LockDefinition[])).
 boolean getRootInsertion()
          Determine whether to log when a root is inserted (checked before calls to rootInserted(String, String, String, boolean)).
 boolean getTransientRootWarning()
          Determine whether to log transient root warnings (checked before calls to {@link #transientRootWarning(String, String)).
 void lockInserted(java.lang.String className, java.lang.String methodName, java.lang.String methodDesc, LockDefinition[] locks)
          Log that lock was inserted
 void rootInserted(java.lang.String className, java.lang.String fieldName, java.lang.String desc, boolean isStatic)
          Log that a root was inserted
 void setClassInclusion(boolean classInclusion)
           
 void setDistMethodCallInsertion(boolean distMethodClassInsertion)
           
 void setLockInsertion(boolean lockInsertion)
           
 void setRootInsertion(boolean rootInsertion)
           
 void setTransientRootWarning(boolean transientRootWarning)
           
 void subclassOfLogicallyManagedClasses(java.lang.String className, java.util.Collection logicalSuperClasses)
          Log that a subclass of a logically managed class cannot be instrumented
 void transientRootWarning(java.lang.String className, java.lang.String fieldName)
          Log that the transient property is being ignored for a root
 

Method Detail

getClassInclusion

boolean getClassInclusion()
Determine whether to log when a class is included for instrumentation (checked before calls to classIncluded(String)).

Returns:
True if should log

setClassInclusion

void setClassInclusion(boolean classInclusion)

getLockInsertion

boolean getLockInsertion()
Determine whether to log when a lock is inserted (checked before calls to autolockInserted(String, String, String, LockDefinition) or lockInserted(String, String, String, LockDefinition[])).

Returns:
True if should log

setLockInsertion

void setLockInsertion(boolean lockInsertion)

getRootInsertion

boolean getRootInsertion()
Determine whether to log when a root is inserted (checked before calls to rootInserted(String, String, String, boolean)).

Returns:
True if should log

setRootInsertion

void setRootInsertion(boolean rootInsertion)

getDistMethodCallInsertion

boolean getDistMethodCallInsertion()
Determine whether to log when a DMI call is inserted (checked before calls to distMethodCallInserted(String, String, String)).

Returns:
True if should log

setDistMethodCallInsertion

void setDistMethodCallInsertion(boolean distMethodClassInsertion)

getTransientRootWarning

boolean getTransientRootWarning()
Determine whether to log transient root warnings (checked before calls to {@link #transientRootWarning(String, String)).

Returns:
True if should log

setTransientRootWarning

void setTransientRootWarning(boolean transientRootWarning)

classIncluded

void classIncluded(java.lang.String className)
Log class that is being instrumented

Parameters:
className - Class name

autolockInserted

void autolockInserted(java.lang.String className,
                      java.lang.String methodName,
                      java.lang.String methodDesc,
                      LockDefinition lockDef)
Log that auto lock was inserted

Parameters:
className - The class name
methodName - The method name
methodDesc - Method descriptor
lockDef - The lock definition

lockInserted

void lockInserted(java.lang.String className,
                  java.lang.String methodName,
                  java.lang.String methodDesc,
                  LockDefinition[] locks)
Log that lock was inserted

Parameters:
className - The class name
methodName - The method name
methodDesc - Method descriptor
locks - The lock definitions

subclassOfLogicallyManagedClasses

void subclassOfLogicallyManagedClasses(java.lang.String className,
                                       java.util.Collection logicalSuperClasses)
Log that a subclass of a logically managed class cannot be instrumented

Parameters:
className - The class
logicalSuperClasses - All logical super classes that prevent className from being instrumented

transientRootWarning

void transientRootWarning(java.lang.String className,
                          java.lang.String fieldName)
Log that the transient property is being ignored for a root

Parameters:
className - Class name
fieldName - Transient field name

rootInserted

void rootInserted(java.lang.String className,
                  java.lang.String fieldName,
                  java.lang.String desc,
                  boolean isStatic)
Log that a root was inserted

Parameters:
className - The class name
fieldName - The root field
desc - Method descriptor
isStatic - True if static root

distMethodCallInserted

void distMethodCallInserted(java.lang.String className,
                            java.lang.String methodName,
                            java.lang.String desc)
Log that a DMI call was inserted.

Parameters:
className - The class name
methodName - The method name
desc - The method descriptor


Copyright © 2010 Terracotta, Inc.. All Rights Reserved.