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 java.lang.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 ElementMatcher<? super java.lang.ClassLoader>	classLoaderMatcher	The class loader matcher to apply to a ClassLoader.
private ElementMatcher<? super JavaModule>	moduleMatcher	A module matcher to apply to a java.lang.Module.
private 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 java.lang.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 java.lang.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, java.lang.ClassLoader classLoader, JavaModule module, java.lang.Class<?> classBeingRedefined, java.security.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 Detail

typeMatcher

private final ElementMatcher<? super TypeDescription> typeMatcher

The type matcher to apply to a TypeDescription.

classLoaderMatcher

private final ElementMatcher<? super java.lang.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 Detail

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 java.lang.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 java.lang.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 Detail

matches

public boolean matches(TypeDescription typeDescription,
                       @MaybeNull
                       java.lang.ClassLoader classLoader,
                       @MaybeNull
                       JavaModule module,
                       @MaybeNull
                       java.lang.Class<?> classBeingRedefined,
                       @MaybeNull
                       java.security.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 or null if none is available.

Returns:

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