Package net.bytebuddy.implementation

Class Implementation.Context.Default

    • Field Detail

      • ACCESSOR_METHOD_SUFFIX

        public static final java.lang.String ACCESSOR_METHOD_SUFFIX
        The name suffix to be appended to an accessor method.
        See Also:
        Constant Field Values

      • FIELD_CACHE_PREFIX

        public static final java.lang.String FIELD_CACHE_PREFIX
        The name prefix to be prepended to a field storing a cached value.
        See Also:
        Constant Field Values

    • Constructor Detail

      • Default

        protected Default​(TypeDescription instrumentedType,
                  ClassFileVersion classFileVersion,
                  AuxiliaryType.NamingStrategy auxiliaryTypeNamingStrategy,
                  TypeInitializer typeInitializer,
                  ClassFileVersion auxiliaryClassFileVersion)
        Creates a new default implementation context.
        Parameters:
        instrumentedType - The description of the type that is currently subject of creation.
        classFileVersion - The class file version of the created class.
        auxiliaryTypeNamingStrategy - The naming strategy for naming an auxiliary type.
        typeInitializer - The type initializer of the created instrumented type.
        auxiliaryClassFileVersion - The class file version to use for auxiliary classes.

    • Method Detail

      • isEnabled

        public boolean isEnabled()
        Description copied from interface: Implementation.Context.ExtractableView
        Returns true if this implementation context permits the registration of any implicit type initializers.
        Returns:
        true if this implementation context permits the registration of any implicit type initializers.

      • registerGetterFor

        public MethodDescription.InDefinedShape registerGetterFor​(FieldDescription fieldDescription,
                                                          MethodAccessorFactory.AccessType accessType)
        Description copied from interface: MethodAccessorFactory
        Registers a getter for the given FieldDescription which might itself not be accessible from outside the class. The returned getter method defines the field type as its return type, does not take any arguments and is of package-private visibility, similarly to the Java compiler's accessor methods. If the field is static, this accessor method is also static.
        Parameters:
        fieldDescription - The field which is to be accessed.
        accessType - The required access type.
        Returns:
        A getter method for the given field.

      • registerSetterFor

        public MethodDescription.InDefinedShape registerSetterFor​(FieldDescription fieldDescription,
                                                          MethodAccessorFactory.AccessType accessType)
        Description copied from interface: MethodAccessorFactory
        Registers a setter for the given FieldDescription which might itself not be accessible from outside the class. The returned setter method defines the field type as its only argument type, returns void and is of package-private visibility, similarly to the Java compiler's accessor methods. If the field is static, this accessor method is also static.
        Parameters:
        fieldDescription - The field which is to be accessed.
        accessType - The required access type.
        Returns:
        A setter method for the given field.

      • register

        public TypeDescription register​(AuxiliaryType auxiliaryType)
        Description copied from interface: Implementation.Context
        Registers an auxiliary type as required for the current implementation. Registering a type will cause the creation of this type even if this type is not effectively used for the current implementation.
        Parameters:
        auxiliaryType - The auxiliary type that is required for the current implementation.
        Returns:
        A description of the registered auxiliary type.

      • cache

        public FieldDescription.InDefinedShape cache​(StackManipulation fieldValue,
                                             TypeDescription fieldType)
        Description copied from interface: Implementation.Context
        Caches a single value by storing it in form of a private, final and static field. By caching values, expensive instance creations can be avoided and object identity can be preserved. The field is initiated in a generated class's static initializer.
        Parameters:
        fieldValue - A stack manipulation for creating the value that is to be cached in a static field. After executing the stack manipulation, exactly one value must be put onto the operand stack which is assignable to the given fieldType.
        fieldType - The type of the field for storing the cached value. This field's type determines the value that is put onto the operand stack by this method's returned stack manipulation.
        Returns:
        A description of a field that was defined on the instrumented type which contains the given value.

      • drain

        public void drain​(TypeInitializer.Drain drain,
                  org.objectweb.asm.ClassVisitor classVisitor,
                  AnnotationValueFilter.Factory annotationValueFilterFactory)
        Description copied from interface: Implementation.Context.ExtractableView
        Writes any information that was registered with an Implementation.Context to the provided class visitor. This contains any fields for value caching, any accessor method and it writes the type initializer. The type initializer must therefore never be written manually.
        Parameters:
        drain - The drain to write the type initializer to.
        classVisitor - The class visitor to which the extractable view is to be written.
        annotationValueFilterFactory - The annotation value filter factory to apply when writing annotation.