Package net.bytebuddy.agent.builder

Class AgentBuilder.RawMatcher.ForElementMatchers

java.lang.Object

net.bytebuddy.agent.builder.AgentBuilder.RawMatcher.ForElementMatchers

All Implemented Interfaces:

AgentBuilder.RawMatcher

Enclosing interface:

AgentBuilder.RawMatcher

@Enhance
public static class AgentBuilder.RawMatcher.ForElementMatchers
extends Object
implements AgentBuilder.RawMatcher

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.

Nested Class Summary

Nested classes/interfaces inherited from interface net.bytebuddy.agent.builder.AgentBuilder.RawMatcher

AgentBuilder.RawMatcher.Conjunction, AgentBuilder.RawMatcher.Disjunction, AgentBuilder.RawMatcher.ForElementMatchers, AgentBuilder.RawMatcher.ForLoadState, AgentBuilder.RawMatcher.ForResolvableTypes, AgentBuilder.RawMatcher.Inversion, AgentBuilder.RawMatcher.Trivial

Field Summary

Fields

Modifier and Type	Field	Description
private final ElementMatcher<? super ClassLoader>	classLoaderMatcher	The class loader matcher to apply to a ClassLoader.
private final ElementMatcher<? super JavaModule>	moduleMatcher	A module matcher to apply to a java.lang.Module.
private final ElementMatcher<? super TypeDescription>	typeMatcher	The type matcher to apply to a TypeDescription.

Constructor Summary

Constructors

Constructor	Description
ForElementMatchers(ElementMatcher<? super TypeDescription> typeMatcher)	Creates a new AgentBuilder.RawMatcher that only matches the supplied TypeDescription against a supplied matcher.
ForElementMatchers(ElementMatcher<? super TypeDescription> typeMatcher, ElementMatcher<? super ClassLoader> classLoaderMatcher)	Creates a new AgentBuilder.RawMatcher that only matches the supplied TypeDescription and its ClassLoader against two matcher in order to decided if an instrumentation should be conducted.
ForElementMatchers(ElementMatcher<? super TypeDescription> typeMatcher, ElementMatcher<? super ClassLoader> classLoaderMatcher, ElementMatcher<? super JavaModule> moduleMatcher)	Creates a new AgentBuilder.RawMatcher that only matches the supplied TypeDescription, its ClassLoader and module against element suitable matchers.

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.

Methods inherited from class java.lang.Object

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

Field Details

typeMatcher

private final ElementMatcher<? super TypeDescription> typeMatcher

The type matcher to apply to a TypeDescription.

classLoaderMatcher

private final ElementMatcher<? super ClassLoader> classLoaderMatcher

The class loader matcher to apply to a ClassLoader.

moduleMatcher

private final ElementMatcher<? super JavaModule> moduleMatcher

A module matcher to apply to a java.lang.Module.

Constructor Details

ForElementMatchers

public ForElementMatchers(ElementMatcher<? super TypeDescription> typeMatcher)

Creates a new AgentBuilder.RawMatcher that only matches the supplied TypeDescription against a supplied matcher.

Parameters:

typeMatcher - The type matcher to apply to a TypeDescription.

ForElementMatchers

public ForElementMatchers(ElementMatcher<? super TypeDescription> typeMatcher,
 ElementMatcher<? super ClassLoader> classLoaderMatcher)

Creates a new AgentBuilder.RawMatcher that only matches the supplied TypeDescription and its ClassLoader against two matcher in order to decided if an instrumentation should be conducted.

Parameters:

typeMatcher - The type matcher to apply to a TypeDescription.

classLoaderMatcher - The class loader matcher to apply to a ClassLoader.

ForElementMatchers

public ForElementMatchers(ElementMatcher<? super TypeDescription> typeMatcher,
 ElementMatcher<? super ClassLoader> classLoaderMatcher,
 ElementMatcher<? super JavaModule> moduleMatcher)

Creates a new AgentBuilder.RawMatcher that only matches the supplied TypeDescription, its ClassLoader and module against element suitable matchers.

Parameters:

typeMatcher - The type matcher to apply to a TypeDescription.

classLoaderMatcher - The class loader matcher to apply to a ClassLoader.

moduleMatcher - A module matcher to apply to a java.lang.Module.

Method Details

matches

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

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

Specified by:

matches in interface AgentBuilder.RawMatcher

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.

Returns:

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