Package net.bytebuddy.asm

Class MemberSubstitution.Replacement.ForElementMatchers.Factory

java.lang.Object

net.bytebuddy.asm.MemberSubstitution.Replacement.ForElementMatchers.Factory

All Implemented Interfaces:

MemberSubstitution.Replacement.Factory

Enclosing class:

MemberSubstitution.Replacement.ForElementMatchers

@Enhance
protected static class MemberSubstitution.Replacement.ForElementMatchers.Factory
extends java.lang.Object
implements MemberSubstitution.Replacement.Factory

A factory for creating a replacement that chooses members based on a row of element matchers.

Nested Class Summary

Nested classes/interfaces inherited from interface net.bytebuddy.asm.MemberSubstitution.Replacement.Factory

MemberSubstitution.Replacement.Factory.Compound

Field Summary

Fields

Modifier and Type	Field	Description
private ElementMatcher<? super FieldDescription>	fieldMatcher	The field matcher to consider when discovering fields.
private boolean	includeSuperCalls	true if super method calls should be matched.
private boolean	includeVirtualCalls	true if virtual method calls should be matched.
private boolean	matchFieldRead	true if field reading access should be matched.
private boolean	matchFieldWrite	true if field writing access should be matched.
private ElementMatcher<? super MethodDescription>	methodMatcher	The method matcher to consider when discovering methods.
private MemberSubstitution.Substitution.Factory<? super MemberSubstitution.Target.ForMember>	substitutionFactory	The substitution factory to create a substitution from.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	Factory(ElementMatcher<? super FieldDescription> fieldMatcher, ElementMatcher<? super MethodDescription> methodMatcher, boolean matchFieldRead, boolean matchFieldWrite, boolean includeVirtualCalls, boolean includeSuperCalls, MemberSubstitution.Substitution.Factory<? super MemberSubstitution.Target.ForMember> substitutionFactory)	Creates a new replacement that triggers a substitution based on a row of matchers.

Method Summary

Modifier and Type	Method	Description
MemberSubstitution.Replacement	make(TypeDescription instrumentedType, MethodDescription instrumentedMethod, TypePool typePool)	Creates a replacement for an instrumented method.
protected static MemberSubstitution.Replacement.Factory	of(ElementMatcher<? super ByteCodeElement.Member> matcher, MemberSubstitution.Substitution.Factory<? super MemberSubstitution.Target.ForMember> factory)	Creates a factory for applying a substitution on all matched byte code elements for all access types.
protected static MemberSubstitution.Replacement.Factory	ofField(ElementMatcher<? super FieldDescription> matcher, boolean matchFieldRead, boolean matchFieldWrite, MemberSubstitution.Substitution.Factory<? super MemberSubstitution.Target.ForMember> factory)	Creates a factory that only matches field access for given access types.
protected static MemberSubstitution.Replacement.Factory	ofMethod(ElementMatcher<? super MethodDescription> matcher, boolean includeVirtualCalls, boolean includeSuperCalls, MemberSubstitution.Substitution.Factory<? super MemberSubstitution.Target.ForMember> factory)	Creates a factory that only matches method and constructor invocations for given invocation types.

Methods inherited from class java.lang.Object

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

Field Detail

fieldMatcher

private final ElementMatcher<? super FieldDescription> fieldMatcher

The field matcher to consider when discovering fields.

methodMatcher

private final ElementMatcher<? super MethodDescription> methodMatcher

The method matcher to consider when discovering methods.

matchFieldRead

private final boolean matchFieldRead

true if field reading access should be matched.

matchFieldWrite

private final boolean matchFieldWrite

true if field writing access should be matched.

includeVirtualCalls

private final boolean includeVirtualCalls

true if virtual method calls should be matched.

includeSuperCalls

private final boolean includeSuperCalls

true if super method calls should be matched.

substitutionFactory

private final MemberSubstitution.Substitution.Factory<? super MemberSubstitution.Target.ForMember> substitutionFactory

The substitution factory to create a substitution from.

Constructor Detail

Factory

protected Factory(ElementMatcher<? super FieldDescription> fieldMatcher,
                  ElementMatcher<? super MethodDescription> methodMatcher,
                  boolean matchFieldRead,
                  boolean matchFieldWrite,
                  boolean includeVirtualCalls,
                  boolean includeSuperCalls,
                  MemberSubstitution.Substitution.Factory<? super MemberSubstitution.Target.ForMember> substitutionFactory)

Creates a new replacement that triggers a substitution based on a row of matchers.

Parameters:

fieldMatcher - The field matcher to consider when discovering fields.

methodMatcher - The method matcher to consider when discovering methods.

matchFieldRead - true if field reading access should be matched.

matchFieldWrite - true if field writing access should be matched.

includeVirtualCalls - true if virtual method calls should be matched.

includeSuperCalls - true if super method calls should be matched.

substitutionFactory - The substitution factory to create a substitution from.

Method Detail

of

protected static MemberSubstitution.Replacement.Factory of(ElementMatcher<? super ByteCodeElement.Member> matcher,
                                                           MemberSubstitution.Substitution.Factory<? super MemberSubstitution.Target.ForMember> factory)

Creates a factory for applying a substitution on all matched byte code elements for all access types.

Parameters:

matcher - The matcher to apply.

factory - The substitution factory to create a substitution from.

Returns:

An appropriate replacement factory for the supplied matcher and substitution factory.

ofField

protected static MemberSubstitution.Replacement.Factory ofField(ElementMatcher<? super FieldDescription> matcher,
                                                                boolean matchFieldRead,
                                                                boolean matchFieldWrite,
                                                                MemberSubstitution.Substitution.Factory<? super MemberSubstitution.Target.ForMember> factory)

Creates a factory that only matches field access for given access types.

Parameters:

matcher - The matcher to identify fields for substitution.

matchFieldRead - true if field read access should be matched.

matchFieldWrite - true if field write access should be matched.

factory - The substitution factory to apply for fields that match the specified criteria.

Returns:

An appropriate replacement factory.

ofMethod

protected static MemberSubstitution.Replacement.Factory ofMethod(ElementMatcher<? super MethodDescription> matcher,
                                                                 boolean includeVirtualCalls,
                                                                 boolean includeSuperCalls,
                                                                 MemberSubstitution.Substitution.Factory<? super MemberSubstitution.Target.ForMember> factory)

Creates a factory that only matches method and constructor invocations for given invocation types.

Parameters:

matcher - The matcher to identify methods and constructors for substitution.

includeVirtualCalls - true if virtual method calls should be matched.

includeSuperCalls - true if super method calls should be matched.

factory - The substitution factory to apply for methods and constructors that match the specified criteria.

Returns:

An appropriate replacement factory.

make

public MemberSubstitution.Replacement make(TypeDescription instrumentedType,
                                           MethodDescription instrumentedMethod,
                                           TypePool typePool)

Creates a replacement for an instrumented method.

Specified by:

make in interface MemberSubstitution.Replacement.Factory

Parameters:

instrumentedType - The instrumented type.

instrumentedMethod - The instrumented method.

typePool - The type pool being used within the member substitution being applied.

Returns:

A replacement to use within the supplied instrumented method.