org.tromer.jie.opportunity
Class Opportunity

java.lang.Object
  |
  +--org.tromer.jie.visitor.NullObjectVisitor
        |
        +--org.tromer.jie.opportunity.Opportunity
Direct Known Subclasses:
Opportunity.EntryExitOpp, Opportunity.SingleActionOpp

public abstract class Opportunity
extends NullObjectVisitor

Base class for all instrumentation opportunity classes. This is a NullObjectVisitor with a bit of added functionality shared by all opportunity classes.


Inner Class Summary
static class Opportunity.EntryExitOpp
          Base class for all opportunities that have two configurable aspects: entry action template and exit action template.
static class Opportunity.SingleActionOpp
          Base class for all opportunities that have one configurable aspect: action template.
 
Constructor Summary
Opportunity()
           
 
Method Summary
protected  void initOpp(java.lang.Object[] actionData)
          Initializes generic aspects of the opportunity.
protected  InstrumTransform newTransform(Node n, java.lang.Object argu)
          Creates a new instance of InstrumTransform, representing an instrumentation transformation carried out by this opportunity.
 
Methods inherited from class org.tromer.jie.visitor.NullObjectVisitor
visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit
 
Methods inherited from class java.lang.Object
, clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

Opportunity

public Opportunity()
Method Detail

initOpp

protected void initOpp(java.lang.Object[] actionData)
Initializes generic aspects of the opportunity. This method must be before any other Opportunity method.

Accepts an array of objects that completely define the action carried out by the instance of the instrumentation opportunity. These objects must implement the getHash() method as outlined in the Java Language Definition. The getHash() results of all the objects are hashed together to produce the first field of the JIID.


newTransform

protected InstrumTransform newTransform(Node n,
                                        java.lang.Object argu)
Creates a new instance of InstrumTransform, representing an instrumentation transformation carried out by this opportunity. Normally this will be followed by zero or more calls to InstrumTransform.newCode() of the result, and finally a mandatory call to InstrumTransform.doneCoding().