Module java.base
Package java.lang.classfile

# Class CustomAttribute

≠
public abstract class CustomAttribute<T>
extends java.lang.Object
implements java.lang.classfile.Attribute<T>, java.lang.classfile.ClassElement, java.lang.classfile.CodeElement, java.lang.classfile.FieldElement, java.lang.classfile.MethodElement
Comparing jdk-master and valhalla-csr-open

Type Parameters:
  `T` - the custom attribute type

All Implemented Interfaces:
  `AttributePREVIEW <T>, ClassElementPREVIEW , ClassFileElement, CodeElement, FieldElement, MethodElement`

public abstract non-sealed class CustomAttribute<T extends CustomAttribute<T>> extends Object implements AttributePREVIEW <T>, CodeElement, ClassElementPREVIEW , MethodElement, FieldElement
Models a user-defined attribute in a `class` file. API models for user-defined attributes should extend this class. A user-defined attribute should also have an `AttributeMapper` defined, which will be returned by `attributeMapper()` , and registered to the `ClassFile.AttributeMapperOption` so the user-defined attributes can be read.

Accessor methods on user-defined attributes read from `class` files may throw `IllegalArgumentException` if the attribute model is lazily evaluated, and the evaluation encounters malformed `class` file format for the attribute.

Since:
  24
See Also:
  - `java.lang.classfile.attribute`

## Constructors

- =
  protected CustomAttribute(java.lang.classfile.AttributeMapper<T> arg0)

## Methods

- ≠
  public final java.lang.classfile.AttributeMapper<T> attributeMapper()
  Comparing jdk-master and valhalla-csr-open

  ### attributeMapper

  public final AttributeMapper<T> attributeMapper()
  Description copied from interface: `Attribute`
  Returns the `AttributeMapper` associated with this attribute.
  Specified by:
    `attributeMapper` in interface `AttributePREVIEW <T extends CustomAttribute<T>>`
  Returns:
    the `AttributeMapper` associated with this attribute
- ≠
  public java.lang.classfile.constantpool.Utf8Entry attributeName()
  Comparing jdk-master and valhalla-csr-open

  ### attributeName

  public Utf8Entry attributeName()
  Returns the name of the attribute. The string value of the name is equivalent to the value of `attributeMapper().name()` .

  If this attribute is read from a `class` file, this method returns the `Utf8Entry` indicating the attribute name in the `class` file.

  Specified by:
    `attributeName` in interface `AttributePREVIEW <T extends CustomAttribute<T>>`
  Implementation Requirements:
    The default implementation returns a `Utf8Entry` suitable for writing only, which may be unbound. Subclasses representing attributes read from `class` files must override this method.
  Returns:
    the name of the attribute
  See Also:
    - `AttributeMapper.readAttribute(AttributedElement, ClassReader, int)`
- =
  public java.lang.String toString()

## Summary

Differences
| Elements | Comments | Descriptions | Total
Added | Changed | Removed | Added | Changed | Removed | Added | Changed | Removed
--- | --- | --- | --- | --- | --- | --- | --- | ---
CustomAttribute |  |  |  |  |  |  | 4 |  |  | 4
attributeMapper() |  |  |  |  |  |  | 1 |  |  | 1
attributeName() |  |  |  |  |  |  | 1 |  |  | 1
Total |  |  |  |  |  |  | 6 |  |  | 6