Class MemberSubstitution.WithoutSpecification.ForMatchedMethod

java.lang.Object

net.bytebuddy.asm.MemberSubstitution.WithoutSpecification<MemberSubstitution.Target.ForMember>

net.bytebuddy.asm.MemberSubstitution.WithoutSpecification.ForMatchedMethod

Enclosing class:

MemberSubstitution.WithoutSpecification<T extends MemberSubstitution.Target>

@Enhance
public static class MemberSubstitution.WithoutSpecification.ForMatchedMethod
extends MemberSubstitution.WithoutSpecification<MemberSubstitution.Target.ForMember>

Describes a member substitution that requires a specification for how to replace a method or constructor.

Nested Class Summary

Nested classes/interfaces inherited from class MemberSubstitution.WithoutSpecification

MemberSubstitution.WithoutSpecification.ForMatchedByteCodeElement, MemberSubstitution.WithoutSpecification.ForMatchedDynamicInvocation, MemberSubstitution.WithoutSpecification.ForMatchedField, MemberSubstitution.WithoutSpecification.ForMatchedMethod

Field Summary

Fields

Modifier and Type	Field	Description
private final boolean	includeSuperCalls	true if this specification includes super invocations.
private final boolean	includeVirtualCalls	true if this specification includes virtual invocations.
private final ElementMatcher<? super MethodDescription>	matcher	A matcher for any method or constructor that should be substituted.

Fields inherited from class MemberSubstitution.WithoutSpecification

failIfNoMatch, methodGraphCompiler, replacementFactory, strict, typePoolResolver

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	ForMatchedMethod(MethodGraph.Compiler methodGraphCompiler, MemberSubstitution.TypePoolResolver typePoolResolver, boolean strict, boolean failIfNoMatch, MemberSubstitution.Replacement.Factory replacementFactory, ElementMatcher<? super MethodDescription> matcher)	Creates a new member substitution for a matched method that requires a specification for how to perform a substitution.
protected	ForMatchedMethod(MethodGraph.Compiler methodGraphCompiler, MemberSubstitution.TypePoolResolver typePoolResolver, boolean strict, boolean failIfNoMatch, MemberSubstitution.Replacement.Factory replacementFactory, ElementMatcher<? super MethodDescription> matcher, boolean includeVirtualCalls, boolean includeSuperCalls)	Creates a new member substitution for a matched method that requires a specification for how to perform a substitution.

Method Summary

Modifier and Type	Method	Description
MemberSubstitution.WithoutSpecification<MemberSubstitution.Target.ForMember>	onSuperCall()	Limits the substituted method calls to method calls that invoke a method as a super call.
MemberSubstitution.WithoutSpecification<MemberSubstitution.Target.ForMember>	onVirtualCall()	Limits the substituted method calls to method calls that invoke a method virtually (as opposed to a super invocation).
MemberSubstitution	replaceWith(MemberSubstitution.Substitution.Factory<? super MemberSubstitution.Target.ForMember> substitutionFactory)	Replaces any interaction with the supplied substitution.

Methods inherited from class MemberSubstitution.WithoutSpecification

replaceWith, replaceWith, replaceWith, replaceWith, replaceWithChain, replaceWithChain, replaceWithConstant, replaceWithField, replaceWithInstrumentedMethod, replaceWithMethod, replaceWithMethod, stub

Methods inherited from class Object

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

Field Details

matcher

private final ElementMatcher<? super MethodDescription> matcher

A matcher for any method or constructor that should be substituted.

includeVirtualCalls

private final boolean includeVirtualCalls

true if this specification includes virtual invocations.

includeSuperCalls

private final boolean includeSuperCalls

true if this specification includes super invocations.

Constructor Details

ForMatchedMethod

protected ForMatchedMethod(MethodGraph.Compiler methodGraphCompiler,
 MemberSubstitution.TypePoolResolver typePoolResolver,
 boolean strict,
 boolean failIfNoMatch,
 MemberSubstitution.Replacement.Factory replacementFactory,
 ElementMatcher<? super MethodDescription> matcher)

Creates a new member substitution for a matched method that requires a specification for how to perform a substitution.

Parameters:

methodGraphCompiler - The method graph compiler to use.

typePoolResolver - The type pool resolver to use.

strict - true if the method processing should be strict where an exception is raised if a member cannot be found.

failIfNoMatch - true if the instrumentation should fail if applied to a method without match.

replacementFactory - The replacement factory to use.

matcher - A matcher for any method or constructor that should be substituted.

ForMatchedMethod

protected ForMatchedMethod(MethodGraph.Compiler methodGraphCompiler,
 MemberSubstitution.TypePoolResolver typePoolResolver,
 boolean strict,
 boolean failIfNoMatch,
 MemberSubstitution.Replacement.Factory replacementFactory,
 ElementMatcher<? super MethodDescription> matcher,
 boolean includeVirtualCalls,
 boolean includeSuperCalls)

Creates a new member substitution for a matched method that requires a specification for how to perform a substitution.

Parameters:

methodGraphCompiler - The method graph compiler to use.

typePoolResolver - The type pool resolver to use.

strict - true if the method processing should be strict where an exception is raised if a member cannot be found.

failIfNoMatch - true if the instrumentation should fail if applied to a method without match.

replacementFactory - The replacement factory to use.

matcher - A matcher for any method or constructor that should be substituted.

includeVirtualCalls - true if this specification includes virtual invocations.

includeSuperCalls - true if this specification includes super invocations.

Method Details

onVirtualCall

public MemberSubstitution.WithoutSpecification<MemberSubstitution.Target.ForMember> onVirtualCall()

Limits the substituted method calls to method calls that invoke a method virtually (as opposed to a super invocation).

Returns:

This specification where only virtual methods are matched if they are not invoked as a virtual call.

onSuperCall

public MemberSubstitution.WithoutSpecification<MemberSubstitution.Target.ForMember> onSuperCall()

Limits the substituted method calls to method calls that invoke a method as a super call.

Returns:

This specification where only virtual methods are matched if they are not invoked as a super call.

replaceWith

public MemberSubstitution replaceWith(MemberSubstitution.Substitution.Factory<? super MemberSubstitution.Target.ForMember> substitutionFactory)

Replaces any interaction with the supplied substitution.

Specified by:

replaceWith in class MemberSubstitution.WithoutSpecification<MemberSubstitution.Target.ForMember>

Parameters:

substitutionFactory - The substitution factory to use for creating the applied substitution.

Returns:

A member substitution that replaces any matched byte code element with the supplied substitution.