org.objectweb.jac.aspects.tracing
Class DebuggingAC

java.lang.Object
  extended byorg.objectweb.jac.core.AspectComponent
      extended byorg.objectweb.jac.aspects.tracing.DebuggingAC
All Implemented Interfaces:
BaseProgramListener, Serializable

public class DebuggingAC
extends AspectComponent

Implements a simple debugging aspect for JAC applications. The actual functionalities of the debugging are externalized within the Debugger class.

Here is a sample configuration file that steps all the methods that modify the instances of class A and B, excepted the setter for the field called f.

 step ".*" "A || B" "MODIFIERS && !SETTER(f)"
 

See Also:
DebuggingWrapper, Debugger, Serialized Form

Field Summary
 
Fields inherited from class org.objectweb.jac.core.AspectComponent
application, blockKeywords, cr, currentConfigMethod, currentImports, firstCall, NOT_SHARED, SHARED, startWeavingCCount, startWeavingCount, startWeavingMethod, startWeavingType, systemListener, wrappers
 
Fields inherited from interface org.objectweb.jac.core.BaseProgramListener
FOUND_OBJECT
 
Constructor Summary
DebuggingAC()
           
 
Method Summary
 void step(String objects, String classes, String methods)
          This configuration method allows the programmer to define the set of objects, classes, and methods that must be stepped when a method is invoked.
 void stepAll()
          This configuration method must be used if the programmer wants to step ALL the methods of all the applications objects.
 
Methods inherited from class org.objectweb.jac.core.AspectComponent
addWrapper, afterApplicationStarted, afterRunningWrapper, afterWrap, afterWrappeeInit, attr, attrdef, beforeConfiguration, beforeReload, beforeRunningWrapper, beforeWrappeeInit, configure, defines, defineTimer, doRegister, doUnregister, error, getAC, getApplication, getBlockKeywords, getConfigurationMethods, getConfigurationMethodsName, getConfigurationMethodsName, getDefaultConfigs, getName, getNameCounters, getWrappers, init, isConfigurationMethod, isSystemListener, onExit, pointcut, pointcut, pointcut, pointcut, pointcut, pointcut, pointcut, pointcut, setApplication, setAttribute, setAttribute, setAttribute, setSystemListener, simulateUsingNewInstance, unweave, unwrapAll, updateNameCounters, warning, weave, whenClone, whenCloseDisplay, whenConfigured, whenDeleted, whenDeserialized, whenFree, whenGetObjects, whenNameObject, whenObjectMiss, whenReload, whenRemoteInstantiation, whenSerialized, whenTopologyChanged, whenUsingNewClass, whenUsingNewInstance
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

DebuggingAC

public DebuggingAC()
Method Detail

step

public void step(String objects,
                 String classes,
                 String methods)
This configuration method allows the programmer to define the set of objects, classes, and methods that must be stepped when a method is invoked.

Parameters:
objects - a pointcut expression on the name of the debugged objects
classes - a pointcut expression on the name of the debugged classes
methods - a pointcut expression on the name of the debugged methods

stepAll

public void stepAll()
This configuration method must be used if the programmer wants to step ALL the methods of all the applications objects.