org.jboss.byteman.agent

Class TransformContext

java.lang.Object

org.jboss.byteman.agent.TransformContext

public class TransformContext
extends Object

Class used to localise the context information employed when creating a rule from a rule script and using it to transform a method

Field Summary

Fields

Modifier and Type	Field and Description
static String	TOFU

Constructor Summary

Constructors

Constructor and Description
TransformContext(Transformer transformer, RuleScript ruleScript, String triggerClassName, ClassLoader loader, HelperManager helperManager)

Method Summary

Methods

Modifier and Type	Method and Description
Rule	createRule(String triggerMethodName, String triggerMethodDescriptor) called by a check adapter to create a rule specific to a given trigger method.
void	fail(String failMessage, String triggerMethodName, String triggerMethodDescriptor) called by a check or trigger adapter to fail a transform because of a type issue.
String	findLeastCommonSuper(String t1, String t2)
String	getTriggerClassName()
boolean	injectIntoMethod(String name, String desc)
Rule	lookupRule(String triggerMethodName, String triggerMethodDescriptor) called by a trigger adapter to find a rule specific to a given trigger method, expects to find a rule created by the corresponding check adapter.
boolean	matchTargetMethod(int access, String name, String desc)
void	parseRule()
void	recordFailedTransform(Throwable th)
byte[]	transform(byte[] targetClassBytes)
void	warn(String triggerMethodName, String triggerMethodDescriptor, String warningMessage) called by a check adapter to warn that a transform was not possible for a potential match target.

Methods inherited from class java.lang.Object

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

Field Detail

TOFU

public static final String TOFU

See Also:

Constant Field Values

Constructor Detail

TransformContext

public TransformContext(Transformer transformer,
                RuleScript ruleScript,
                String triggerClassName,
                ClassLoader loader,
                HelperManager helperManager)

Method Detail

transform

public byte[] transform(byte[] targetClassBytes)

parseRule

public void parseRule()
               throws Exception

Throws:

Exception

lookupRule

public Rule lookupRule(String triggerMethodName,
              String triggerMethodDescriptor)

called by a trigger adapter to find a rule specific to a given trigger method, expects to find a rule created by the corresponding check adapter. if no rule is found then injection must be bypassed for this method

Parameters:

triggerMethodName -

triggerMethodDescriptor -

Returns:

createRule

public Rule createRule(String triggerMethodName,
              String triggerMethodDescriptor)

called by a check adapter to create a rule specific to a given trigger method. the first such call reuses the rule created by the intiial parse. subsequent calls create a new rule.

Parameters:

triggerMethodName -

triggerMethodDescriptor -

Returns:

warn

public void warn(String triggerMethodName,
        String triggerMethodDescriptor,
        String warningMessage)

called by a check adapter to warn that a transform was not possible for a potential match target. this inhibits injection into the method being warned about allowing other injection operations to continue.

Parameters:

warningMessage -

fail

public void fail(String failMessage,
        String triggerMethodName,
        String triggerMethodDescriptor)

called by a check or trigger adapter to fail a transform because of a type issue. this aborts all injection into the current class not just injection into the current method.

Parameters:

failMessage -

triggerMethodName -

triggerMethodDescriptor -

recordFailedTransform

public void recordFailedTransform(Throwable th)

matchTargetMethod

public boolean matchTargetMethod(int access,
                        String name,
                        String desc)

injectIntoMethod

public boolean injectIntoMethod(String name,
                       String desc)

getTriggerClassName

public String getTriggerClassName()

findLeastCommonSuper

public String findLeastCommonSuper(String t1,
                          String t2)