Class FieldAccessor.ForImplicitProperty

    • Constructor Detail

      • ForImplicitProperty

        protected ForImplicitProperty​(FieldAccessor.FieldLocation fieldLocation)
        Creates a field accessor for an implicit property.
        Parameters:
        fieldLocation - The field's location.
      • ForImplicitProperty

        private ForImplicitProperty​(FieldAccessor.FieldLocation fieldLocation,
                                    Assigner assigner,
                                    Assigner.Typing typing)
        Creates a field accessor for an implicit property.
        Parameters:
        fieldLocation - The field's location.
        assigner - The assigner to use.
        typing - The typing to use.
    • Method Detail

      • appender

        public ByteCodeAppender appender​(Implementation.Target implementationTarget)
        Creates a byte code appender that determines the implementation of the instrumented type's methods.
        Specified by:
        appender in interface Implementation
        Parameters:
        implementationTarget - The target of the current implementation.
        Returns:
        A byte code appender for implementing methods delegated to this implementation. This byte code appender is also responsible for handling methods that were added by this implementation on the call to InstrumentedType.Prepareable.prepare(InstrumentedType).
      • setsArgumentAt

        public Implementation.Composable setsArgumentAt​(int index)

        Defines a setter of the specified parameter for the field being described.

        Note: If the instrumented method does not return void, a chained instrumentation must be supplied.

        Specified by:
        setsArgumentAt in interface FieldAccessor.PropertyConfigurable
        Parameters:
        index - The index of the parameter for which to set the field's value.
        Returns:
        An instrumentation that sets the parameter's value to the described field.
      • setsDefaultValue

        public Implementation.Composable setsDefaultValue()

        Defines a setter of the described field's default value, i.e. null or a primitive type's representation of 0.

        Note: If the instrumented method does not return void, a chained instrumentation must be supplied.

        Specified by:
        setsDefaultValue in interface FieldAccessor.PropertyConfigurable
        Returns:
        An instrumentation that sets the field's default value.
      • setsValue

        public Implementation.Composable setsValue​(java.lang.Object value)

        Defines a setter of a given value for the described field. If the value is a constant value, it will be defined as a constant assignment, otherwise it is defined as a reference value that is stored in a static field of the instrumented type.

        Note: If the instrumented method does not return void, a chained instrumentation must be supplied.

        Specified by:
        setsValue in interface FieldAccessor.PropertyConfigurable
        Parameters:
        value - The value to set.
        Returns:
        An instrumentation that sets the field's value as specified.
      • setsValue

        public Implementation.Composable setsValue​(TypeDescription typeDescription)

        Defines a setter of a given class constant value for the described field.

        Note: If the instrumented method does not return void, a chained instrumentation must be supplied.

        Specified by:
        setsValue in interface FieldAccessor.PropertyConfigurable
        Parameters:
        typeDescription - The type to set to the described field.
        Returns:
        An instrumentation that sets the field's value to the given class constant.
      • setsValue

        public Implementation.Composable setsValue​(JavaConstant constant)

        Defines a setter of a given constant value for the described field.

        Note: If the instrumented method does not return void, a chained instrumentation must be supplied.

        Specified by:
        setsValue in interface FieldAccessor.PropertyConfigurable
        Parameters:
        constant - The constant to set as a value.
        Returns:
        An instrumentation that sets the field's value to the given constant.
      • setsValue

        public Implementation.Composable setsValue​(StackManipulation stackManipulation,
                                                   java.lang.reflect.Type type)

        Defines a setter of a value that is represented by a stack manipulation.

        Note: If the instrumented method does not return void, a chained instrumentation must be supplied.

        Specified by:
        setsValue in interface FieldAccessor.PropertyConfigurable
        Parameters:
        stackManipulation - A stack manipulation to load the field's value.
        type - The field value's type.
        Returns:
        An instrumentation that sets the field's value to the given value.
      • setsValue

        public Implementation.Composable setsValue​(StackManipulation stackManipulation,
                                                   TypeDescription.Generic typeDescription)

        Defines a setter of a value that is represented by a stack manipulation.

        Note: If the instrumented method does not return void, a chained instrumentation must be supplied.

        Specified by:
        setsValue in interface FieldAccessor.PropertyConfigurable
        Parameters:
        stackManipulation - A stack manipulation to load the field's value.
        typeDescription - The field value's type.
        Returns:
        An instrumentation that sets the field's value to the given value.
      • setsReference

        public Implementation.Composable setsReference​(java.lang.Object value)

        Defines a setter of a given value for the described field. The value is kept as a referenced that is stored in a static field of the instrumented type. The field name is chosen based on the value's hash code.

        Note: If the instrumented method does not return void, a chained instrumentation must be supplied.

        Specified by:
        setsReference in interface FieldAccessor.PropertyConfigurable
        Parameters:
        value - The value to set.
        Returns:
        An instrumentation that sets the field's value as specified.
      • setsReference

        public Implementation.Composable setsReference​(java.lang.Object value,
                                                       java.lang.String name)

        Defines a setter of a given value for the described field. The value is kept as a referenced that is stored in a static field of the instrumented type.

        Note: If the instrumented method does not return void, a chained instrumentation must be supplied.

        Specified by:
        setsReference in interface FieldAccessor.PropertyConfigurable
        Parameters:
        value - The value to set.
        name - The name of the field.
        Returns:
        An instrumentation that sets the field's value as specified.
      • setsFieldValueOf

        public Implementation.Composable setsFieldValueOf​(java.lang.reflect.Field field)

        Defines a setter of a value that sets another field's value.

        Note: If the instrumented method does not return void, a chained instrumentation must be supplied.

        Specified by:
        setsFieldValueOf in interface FieldAccessor.PropertyConfigurable
        Parameters:
        field - The field that holds the value to be set.
        Returns:
        An instrumentation that sets the field's value to the specified field's value.
      • setsFieldValueOf

        public Implementation.Composable setsFieldValueOf​(FieldDescription fieldDescription)

        Defines a setter of a value that sets another field's value.

        Note: If the instrumented method does not return void, a chained instrumentation must be supplied.

        Specified by:
        setsFieldValueOf in interface FieldAccessor.PropertyConfigurable
        Parameters:
        fieldDescription - The field that holds the value to be set.
        Returns:
        An instrumentation that sets the field's value to the specified field's value.
      • setsFieldValueOf

        public Implementation.Composable setsFieldValueOf​(java.lang.String fieldName)

        Defines a setter of a value that sets another field's value.

        Note: If the instrumented method does not return void, a chained instrumentation must be supplied.

        Specified by:
        setsFieldValueOf in interface FieldAccessor.PropertyConfigurable
        Parameters:
        fieldName - The name of the field that is specified by the instrumented type.
        Returns:
        An instrumentation that sets the field's value to the specified field's value.
      • setsFieldValueOf

        public Implementation.Composable setsFieldValueOf​(FieldAccessor.FieldNameExtractor fieldNameExtractor)

        Defines a setter of a value that sets another field's value.

        Note: If the instrumented method does not return void, a chained instrumentation must be supplied.

        Specified by:
        setsFieldValueOf in interface FieldAccessor.PropertyConfigurable
        Parameters:
        fieldNameExtractor - A field name extractor for the field that is specified by the instrumented type.
        Returns:
        An instrumentation that sets the field's value to the specified field's value.
      • withAssigner

        public FieldAccessor.PropertyConfigurable withAssigner​(Assigner assigner,
                                                               Assigner.Typing typing)
        Returns a field accessor that is identical to this field accessor but uses the given assigner and runtime type use configuration.
        Specified by:
        withAssigner in interface FieldAccessor.AssignerConfigurable
        Parameters:
        assigner - The assigner to use.
        typing - Indicates if dynamic type castings should be attempted for incompatible assignments.
        Returns:
        This field accessor with the given assigner and runtime type use configuration.
      • in

        public FieldAccessor.AssignerConfigurable in​(java.lang.Class<?> type)
        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​(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.
        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.