net.bytebuddy.instrumentation

Class FieldAccessor.ForBeanProperty

java.lang.Object

net.bytebuddy.instrumentation.FieldAccessor

net.bytebuddy.instrumentation.FieldAccessor.ForBeanProperty

All Implemented Interfaces:

FieldAccessor.AssignerConfigurable, FieldAccessor.OwnerTypeLocatable, Instrumentation

Enclosing class:

FieldAccessor

protected static class FieldAccessor.ForBeanProperty
extends FieldAccessor
implements FieldAccessor.OwnerTypeLocatable

Implementation of a field accessor instrumentation where a field is identified by a method's name following the Java specification for bean properties.

Property Summary

Properties inherited from class net.bytebuddy.instrumentation.FieldAccessor

ofBeanProperty

Nested Class Summary

Nested classes/interfaces inherited from class net.bytebuddy.instrumentation.FieldAccessor

FieldAccessor.Appender, FieldAccessor.AssignerConfigurable, FieldAccessor.FieldDefinable, FieldAccessor.FieldLocator, FieldAccessor.ForBeanProperty, FieldAccessor.ForNamedField, FieldAccessor.OwnerTypeLocatable

Nested classes/interfaces inherited from interface net.bytebuddy.instrumentation.Instrumentation

Instrumentation.Compound, Instrumentation.Context, Instrumentation.ForAbstractMethod

Field Summary

Fields inherited from class net.bytebuddy.instrumentation.FieldAccessor

assigner, considerRuntimeType

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ForBeanProperty(Assigner assigner, boolean considerRuntimeType) Creates a new field accessor instrumentation.
protected	ForBeanProperty(Assigner assigner, boolean considerRuntimeType, FieldAccessor.FieldLocator.Factory fieldLocatorFactory) Creates a new field accessor instrumentation.

Method Summary

Modifier and Type	Method and Description
ByteCodeAppender	appender(TypeDescription instrumentedType) Creates a byte code appender that determines the implementation of the instrumented type's methods.
Instrumentation	assigner(Assigner assigner, boolean considerRuntimeType) Returns a field accessor that is identical to this field accessor but uses the given assigner and runtime type use configuration.
boolean	equals(Object other)
protected String	getFieldName(MethodDescription targetMethod) Locates a field's name.
int	hashCode()
FieldAccessor.AssignerConfigurable	in(Class<?> type) Determines that a field should only be considered when it was defined in a given type.
FieldAccessor.AssignerConfigurable	in(FieldAccessor.FieldLocator.Factory fieldLocatorFactory) Determines that a field should only be considered when it was identified by a field locator that is produced by the given factory.
FieldAccessor.AssignerConfigurable	in(TypeDescription typeDescription) Determines that a field should only be considered when it was defined in a given type.
InstrumentedType	prepare(InstrumentedType instrumentedType) During the preparation phase of an instrumentation, implementations are eligible to adding fields or methods to the currently instrumented type.
String	toString()

Methods inherited from class net.bytebuddy.instrumentation.FieldAccessor

applyGetter, applySetter, ofBeanProperty, ofField

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

ForBeanProperty

protected ForBeanProperty(Assigner assigner,
                          boolean considerRuntimeType)

Creates a new field accessor instrumentation.

Parameters:

assigner - The assigner to use.

considerRuntimeType - true if a field value's runtime type should be considered.

ForBeanProperty

protected ForBeanProperty(Assigner assigner,
                          boolean considerRuntimeType,
                          FieldAccessor.FieldLocator.Factory fieldLocatorFactory)

Creates a new field accessor instrumentation.

Parameters:

assigner - The assigner to use.

considerRuntimeType - true if a field value's runtime type should be considered.

fieldLocatorFactory - A factory that will produce a field locator that will be used to find locate a field to be accessed.

Method Detail

in

public FieldAccessor.AssignerConfigurable in(FieldAccessor.FieldLocator.Factory fieldLocatorFactory)

Description copied from interface: FieldAccessor.OwnerTypeLocatable

Determines that a field should only be considered when it was identified by a field locator that is produced by the given factory.

Specified by:

in in interface FieldAccessor.OwnerTypeLocatable

Parameters:

fieldLocatorFactory - A factory that will produce a field locator that will be used to find locate a field to be accessed.

Returns:

This field accessor which will only considered fields that are defined in the given type.

in

public FieldAccessor.AssignerConfigurable in(Class<?> type)

Description copied from interface: FieldAccessor.OwnerTypeLocatable

Determines that a field should only be considered when it was defined in a given type.

Specified by:

in in interface FieldAccessor.OwnerTypeLocatable

Parameters:

type - The type to be considered.

Returns:

This field accessor which will only considered fields that are defined in the given type.

in

public FieldAccessor.AssignerConfigurable in(TypeDescription typeDescription)

Description copied from interface: FieldAccessor.OwnerTypeLocatable

Determines that a field should only be considered when it was defined in a given type.

Specified by:

in in interface FieldAccessor.OwnerTypeLocatable

Parameters:

typeDescription - A description of the type to be considered.

Returns:

This field accessor which will only considered fields that are defined in the given type.

assigner

public Instrumentation assigner(Assigner assigner,
                                boolean considerRuntimeType)

Description copied from interface: FieldAccessor.AssignerConfigurable

Returns a field accessor that is identical to this field accessor but uses the given assigner and runtime type use configuration.

Specified by:

assigner in interface FieldAccessor.AssignerConfigurable

Parameters:

assigner - The assigner to use.

considerRuntimeType - true if a field value's runtime type should be considered.

Returns:

This field accessor with the given assigner and runtime type use configuration.

prepare

public InstrumentedType prepare(InstrumentedType instrumentedType)

Description copied from interface: Instrumentation

During the preparation phase of an instrumentation, implementations are eligible to adding fields or methods to the currently instrumented type. All methods that are added by this instrumentation are required to be implemented by the ByteCodeAppender that is emitted on the call to Instrumentation.appender(net.bytebuddy.instrumentation.type.TypeDescription) call. On this method call, type initializers can also be added to the instrumented type.

Specified by:

prepare in interface Instrumentation

Parameters:

instrumentedType - The instrumented type that is the basis of the ongoing instrumentation.

Returns:

The instrumented type with any applied changes, if any.

appender

public ByteCodeAppender appender(TypeDescription instrumentedType)

Description copied from interface: Instrumentation

Creates a byte code appender that determines the implementation of the instrumented type's methods.

Specified by:

appender in interface Instrumentation

Parameters:

instrumentedType - The instrumented type that is to be created.

Returns:

A byte code appender for implementing methods delegated to this instrumentation. This byte code appender is also responsible for handling methods that were added by this instrumentation on the call to Instrumentation.prepare(net.bytebuddy.instrumentation.type.InstrumentedType).

getFieldName

protected String getFieldName(MethodDescription targetMethod)

Description copied from class: FieldAccessor

Locates a field's name.

Specified by:

getFieldName in class FieldAccessor

Parameters:

targetMethod - The method that is target of the instrumentation.

Returns:

The name of the field to be located for this instrumentation.

equals

public boolean equals(Object other)

Overrides:

equals in class FieldAccessor

hashCode

public int hashCode()

Overrides:

hashCode in class FieldAccessor

toString

public String toString()

Overrides:

toString in class Object