Interface AgentBuilder.RawMatcher

All Known Implementing Classes:

AgentBuilder.Default.Transformation.DifferentialMatcher, AgentBuilder.Default.Transformation.SimpleMatcher, AgentBuilder.RawMatcher.Conjunction, AgentBuilder.RawMatcher.Disjunction, AgentBuilder.RawMatcher.ForElementMatchers, AgentBuilder.RawMatcher.ForLoadState, AgentBuilder.RawMatcher.ForResolvableTypes, AgentBuilder.RawMatcher.Inversion, AgentBuilder.RawMatcher.Trivial

Enclosing interface:

AgentBuilder

public static interface AgentBuilder.RawMatcher

A matcher that allows to determine if a AgentBuilder.Transformer should be applied during the execution of a ClassFileTransformer that was generated by an AgentBuilder.

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static class	AgentBuilder.RawMatcher.Conjunction	A conjunction of two raw matchers.
static class	AgentBuilder.RawMatcher.Disjunction	A disjunction of two raw matchers.
static class	AgentBuilder.RawMatcher.ForElementMatchers	A raw matcher implementation that checks a TypeDescription and its ClassLoader against two suitable matchers in order to determine if the matched type should be instrumented.
static enum	AgentBuilder.RawMatcher.ForLoadState	A raw matcher indicating the state of a type's class loading.
static enum	AgentBuilder.RawMatcher.ForResolvableTypes	Only matches loaded types that can be fully resolved.
static class	AgentBuilder.RawMatcher.Inversion	A raw matcher that inverts a raw matcher's result.
static enum	AgentBuilder.RawMatcher.Trivial	A matcher that always or never matches a type.

Method Summary

Modifier and Type	Method	Description
boolean	matches(TypeDescription typeDescription, ClassLoader classLoader, JavaModule module, Class<?> classBeingRedefined, ProtectionDomain protectionDomain)	Decides if the given typeDescription should be instrumented with the entailed AgentBuilder.Transformers.

Method Details

matches

boolean matches(TypeDescription typeDescription,
 @MaybeNull
 ClassLoader classLoader,
 @MaybeNull
 JavaModule module,
 @MaybeNull
 Class<?> classBeingRedefined,
 @MaybeNull
 ProtectionDomain protectionDomain)

Decides if the given typeDescription should be instrumented with the entailed AgentBuilder.Transformers.

Parameters:

typeDescription - A description of the type to be instrumented.

classLoader - The class loader of the instrumented type. Might be null if this class loader represents the bootstrap class loader.

module - The transformed type's module or null if the current VM does not support modules.

classBeingRedefined - The class being redefined which is only not null if a retransformation is applied.

protectionDomain - The protection domain of the type being transformed or null if none is available.

Returns:

true if the entailed AgentBuilder.Transformers should be applied for the given typeDescription.