org.jboss.byteman.rule.helper

Class InterpretedHelper

java.lang.Object

org.jboss.byteman.rule.helper.Helper

org.jboss.byteman.rule.helper.InterpretedHelper

All Implemented Interfaces:

HelperAdapter

public class InterpretedHelper
extends Helper
implements HelperAdapter

Implementation of RuleHelper which extends the functionality of the standard helper class, Helper, by adding the methods required to implement interface RuleHelper. It provides an implementation which executes rules by interpreting the rule tree. Any rule which employs the standard helper type checks built in method calls against class Helper. However, the interpreter assumes that the helper object implements InterpretedHelper. When a rule is compiled class Helper is extended with a generated class CompiledHelper<NNN> which also implements interface RuleHelper. The implementation of the execute method is generated by translating the parse tree to bytecode. Builtin calls are translated to calls of methods defined by class Helper. A rule can also specify its own helper class in order to provide its own set of builtin operations. The helper class does not implement interface RuleHelper. Instead the compilation process will generate a subclass of the user-defined helper class which provides an appropriate implementation for the RuleHelper methods, including an implementation of the execute method dreived from the rule parse tree. As in the default case, builtin calls are translated to calls of methods defined by the helper class.

Field Summary

Fields

Modifier and Type	Field and Description
protected HashMap<String,Object>	bindingMap

Fields inherited from class org.jboss.byteman.rule.helper.Helper

rule

Constructor Summary

Constructors

Constructor and Description
InterpretedHelper(Rule rule)

Method Summary

Modifier and Type	Method and Description
void	execute(Object recipient, Object[] args) install values into the bindings map and then call the execute0 method to actually execute the rule
protected void	execute0() basic implementation of rule execution
Object	getAccessibleField(Object owner, int fieldIndex)
Object	getBinding(String name)
String	getName()
Object	invokeAccessibleMethod(Object target, Object[] args, int methodIndex)
void	setAccessibleField(Object owner, Object value, int fieldIndex)
void	setBinding(String name, Object value)

Methods inherited from class org.jboss.byteman.rule.helper.Helper

activated, addCountDown, callerCheck, callerEquals, callerEquals, callerEquals, callerEquals, callerEquals, callerEquals, callerEquals, callerEquals, callerEquals, callerMatches, callerMatches, callerMatches, callerMatches, callerMatches, callerMatches, callerMatches, callerMatches, callerMatches, clear, closeTrace, countDown, createCountDown, createCounter, createCounter, createJoin, createLinkMap, createRendezvous, createRendezvous, createTimer, deactivated, debug, decrementCounter, delay, deleteCounter, deleteLinkMap, deleteRendezvous, deleteTimer, err, errTraceException, flag, flagged, formatAllStacks, formatAllStacks, formatAllStacks, formatAllStacks, formatStack, formatStack, formatStack, formatStack, formatStackBetween, formatStackBetween, formatStackBetween, formatStackBetween, formatStackBetween, formatStackBetween, formatStackBetweenMatches, formatStackBetweenMatches, formatStackBetweenMatches, formatStackBetweenMatches, formatStackBetweenMatches, formatStackBetweenMatches, formatStackMatching, formatStackMatching, formatStackMatching, formatStackMatching, formatStackMatching, formatStackMatching, formatStackRange, formatThreadStack, formatThreadStack, formatThreadStack, formatThreadStack, getCountDown, getElapsedTimeFromTimer, getObjectSize, getRendezvous, getStack, incrementCounter, incrementCounter, installed, isCountDown, isJoin, isRendezvous, joinEnlist, joinWait, joinWait, killJVM, killJVM, killThread, link, link, linked, linked, matchIndex, noisy, noisyTraceException, openTrace, openTrace, out, outTraceException, printFrame, printlnFrame, readCounter, readCounter, rendezvous, rendezvous, resetTimer, setTriggering, signalKill, signalKill, signalThrow, signalThrow, signalWake, signalWake, toString, trace, trace, traceAllStacks, traceAllStacks, traceAllStacks, traceAllStacks, traceAllStacks, traceAllStacks, traceClose, traceln, traceln, traceOpen, traceOpen, traceStack, traceStack, traceStack, traceStack, traceStack, traceStack, traceStackBetween, traceStackBetween, traceStackBetween, traceStackBetween, traceStackBetween, traceStackBetween, traceStackBetween, traceStackBetween, traceStackBetween, traceStackBetweenMatches, traceStackBetweenMatches, traceStackBetweenMatches, traceStackBetweenMatches, traceStackBetweenMatches, traceStackBetweenMatches, traceStackBetweenMatches, traceStackBetweenMatches, traceStackBetweenMatches, traceStackMatching, traceStackMatching, traceStackMatching, traceStackMatching, traceStackMatching, traceStackMatching, traceStackMatching, traceStackMatching, traceStackMatching, traceStackRange, traceThreadStack, traceThreadStack, traceThreadStack, traceThreadStack, traceThreadStack, traceThreadStack, triggerIndex, uninstalled, unlink, unlink, verbose, verboseTraceException, waitFor, waitFor, waiting

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

bindingMap

protected HashMap<String,Object> bindingMap

Constructor Detail

InterpretedHelper

public InterpretedHelper(Rule rule)

Method Detail

execute

public void execute(Object recipient,
                    Object[] args)
             throws ExecuteException

install values into the bindings map and then call the execute0 method to actually execute the rule

Specified by:

execute in interface HelperAdapter

Parameters:

recipient - target of trigger method or null if it is static

args - array to pass current values and return new values for data local to the trigger method

Throws:

ExecuteException

execute0

protected void execute0()
                 throws ExecuteException

basic implementation of rule execution

Throws:

ExecuteException - if an exception occurs during execution of the rule

setBinding

public void setBinding(String name,
                       Object value)

Specified by:

setBinding in interface HelperAdapter

getBinding

public Object getBinding(String name)

Specified by:

getBinding in interface HelperAdapter

getName

public String getName()

Specified by:

getName in interface HelperAdapter

getAccessibleField

public Object getAccessibleField(Object owner,
                                 int fieldIndex)

Specified by:

getAccessibleField in interface HelperAdapter

setAccessibleField

public void setAccessibleField(Object owner,
                               Object value,
                               int fieldIndex)

Specified by:

setAccessibleField in interface HelperAdapter

invokeAccessibleMethod

public Object invokeAccessibleMethod(Object target,
                                     Object[] args,
                                     int methodIndex)

Specified by:

invokeAccessibleMethod in interface HelperAdapter