Class MemberSubstitution.WithoutSpecification.ForMatchedField

java.lang.Object

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

net.bytebuddy.asm.MemberSubstitution.WithoutSpecification.ForMatchedField

Enclosing class:

MemberSubstitution.WithoutSpecification<T extends MemberSubstitution.Target>

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

Describes a member substitution that requires a specification for how to replace a field.

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 ElementMatcher<? super FieldDescription>	matcher	A matcher for any field that should be substituted.
private final boolean	matchRead	true if read access to a field should be substituted.
private final boolean	matchWrite	true if write access to a field should be substituted.

Fields inherited from class MemberSubstitution.WithoutSpecification

failIfNoMatch, methodGraphCompiler, replacementFactory, strict, typePoolResolver

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	ForMatchedField(MethodGraph.Compiler methodGraphCompiler, MemberSubstitution.TypePoolResolver typePoolResolver, boolean strict, boolean failIfNoMatch, MemberSubstitution.Replacement.Factory replacementFactory, ElementMatcher<? super FieldDescription> matcher)	Creates a new member substitution for a matched field that requires a specification for how to perform a substitution.
protected	ForMatchedField(MethodGraph.Compiler methodGraphCompiler, MemberSubstitution.TypePoolResolver typePoolResolver, boolean strict, boolean failIfNoMatch, MemberSubstitution.Replacement.Factory replacementFactory, ElementMatcher<? super FieldDescription> matcher, boolean matchRead, boolean matchWrite)	Creates a new member substitution for a matched field that requires a specification for how to perform a substitution.

Method Summary

Modifier and Type	Method	Description
MemberSubstitution.WithoutSpecification<MemberSubstitution.Target.ForMember>	onRead()	When invoked, only read access of the previously matched field is substituted.
MemberSubstitution.WithoutSpecification<MemberSubstitution.Target.ForMember>	onWrite()	When invoked, only write access of the previously matched field is substituted.
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 FieldDescription> matcher

A matcher for any field that should be substituted.

matchRead

private final boolean matchRead

true if read access to a field should be substituted.

matchWrite

private final boolean matchWrite

true if write access to a field should be substituted.

Constructor Details

ForMatchedField

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

Creates a new member substitution for a matched field 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 field that should be substituted.

ForMatchedField

protected ForMatchedField(MethodGraph.Compiler methodGraphCompiler,
 MemberSubstitution.TypePoolResolver typePoolResolver,
 boolean strict,
 boolean failIfNoMatch,
 MemberSubstitution.Replacement.Factory replacementFactory,
 ElementMatcher<? super FieldDescription> matcher,
 boolean matchRead,
 boolean matchWrite)

Creates a new member substitution for a matched field 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 field that should be substituted.

matchRead - true if read access to a field should be substituted.

matchWrite - true if write access to a field should be substituted.

Method Details

onRead

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

When invoked, only read access of the previously matched field is substituted.

Returns:

This instance with the limitation that only read access to the matched field is substituted.

onWrite

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

When invoked, only write access of the previously matched field is substituted.

Returns:

This instance with the limitation that only write access to the matched field is substituted.

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.