net.bytebuddy.asm

Class MemberSubstitution.WithoutSpecification.ForMatchedField

java.lang.Object

net.bytebuddy.asm.MemberSubstitution.WithoutSpecification

net.bytebuddy.asm.MemberSubstitution.WithoutSpecification.ForMatchedField

Enclosing class:

MemberSubstitution.WithoutSpecification

@HashCodeAndEqualsPlugin.Enhance
public static class MemberSubstitution.WithoutSpecification.ForMatchedField
extends MemberSubstitution.WithoutSpecification

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

Nested Class Summary

Nested classes/interfaces inherited from class net.bytebuddy.asm.MemberSubstitution.WithoutSpecification

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

Field Summary

Fields inherited from class net.bytebuddy.asm.MemberSubstitution.WithoutSpecification

failIfNoMatch, methodGraphCompiler, replacementFactory, strict, typePoolResolver

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ForMatchedField(MethodGraph.Compiler methodGraphCompiler, MemberSubstitution.TypePoolResolver typePoolResolver, boolean strict, boolean failIfNoMatch, MemberSubstitution.Replacement.Factory replacementFactory, ElementMatcher<? super FieldDescription.InDefinedShape> 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.InDefinedShape> 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 and Description
MemberSubstitution.WithoutSpecification	onRead() When invoked, only read access of the previously matched field is substituted.
MemberSubstitution.WithoutSpecification	onWrite() When invoked, only write access of the previously matched field is substituted.
MemberSubstitution	replaceWith(MemberSubstitution.Substitution.Factory substitutionFactory) Replaces any interaction with the supplied substitution.

Methods inherited from class net.bytebuddy.asm.MemberSubstitution.WithoutSpecification

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

Methods inherited from class java.lang.Object

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

Constructor Detail

ForMatchedField

protected ForMatchedField(MethodGraph.Compiler methodGraphCompiler,
                          MemberSubstitution.TypePoolResolver typePoolResolver,
                          boolean strict,
                          boolean failIfNoMatch,
                          MemberSubstitution.Replacement.Factory replacementFactory,
                          ElementMatcher<? super FieldDescription.InDefinedShape> 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.InDefinedShape> 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 Detail

onRead

public MemberSubstitution.WithoutSpecification 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 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 substitutionFactory)

Replaces any interaction with the supplied substitution.

Specified by:

replaceWith in class MemberSubstitution.WithoutSpecification

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.