Enum Class AttributeMapper.AttributeStability
java.lang.Object
java.lang.Enum<AttributeMapper.AttributeStability>
java.lang.classfile.AttributeMapper.AttributeStability
- All Implemented Interfaces:
Serializable,Comparable<AttributeMapper.AttributeStability>,Constable
- Enclosing interface:
AttributeMapper<A extends Attribute<A>>
public static enum AttributeMapper.AttributeStability
extends Enum<AttributeMapper.AttributeStability>
Indicates the data dependency of the
class file representation
of an attribute. Whether an attribute can be bulk-copied by its binary
representation to a new class file depends on if its data refers
to other parts of its enclosing class file.- API Note:
- This dependency is called "stability" because it indicates the conditions
for a
classfile attribute to be eligible for bulk-copying to anotherclassfile. - Since:
- 24
- See Also:
-
Nested Class Summary
Nested classes/interfaces declared in class java.lang.Enum
Enum.EnumDesc<E extends Enum<E>> -
Enum Constant Summary
Enum ConstantsEnum ConstantDescriptionIn addition to standalone data, the attribute refers to the constant pool, including theBootstrapMethodsattribute, of its enclosingclassfile.In addition to standalone data and references to the constant pool, the attribute refers to positions into thecodearray of aCodeattribute.The attribute contains only standalone data, and has no reference to other parts of its enclosingclassfile, besides the name of the attribute.The attribute is completely unknown.The attribute refers to structures not managed by the library (type variable lists, etc.). -
Method Summary
Modifier and TypeMethodDescriptionReturns the enum constant of this class with the specified name.static AttributeMapper.AttributeStability[]values()Returns an array containing the constants of this enum class, in the order they are declared.
-
Enum Constant Details
-
STATELESS
The attribute contains only standalone data, and has no reference to other parts of its enclosingclassfile, besides the name of the attribute. Thus, its contents can always be bulk-copied to anotherclassfile.For example, a bit mask is standalone data.
-
CP_REFS
In addition to standalone data, the attribute refers to the constant pool, including theBootstrapMethodsattribute, of its enclosingclassfile. Thus, it can be bulk-copied when the destinationclassfile extends its constant pool from that of the originalclass. It must be expanded to translate constant pool references and rewritten when constant pool indices are not compatible.For example, a
Utf8Entryis a reference to the constant pool.- See Also:
-
LABELS
In addition to standalone data and references to the constant pool, the attribute refers to positions into thecodearray of aCodeattribute. Thus, it can be bulked-copied when thecodearray is unchanged, which requires that the destinationclassfile extends its constant pool from that of the originalclass. It must be expanded to translateLabels or constant pool references and rewritten if thecodearray is perturbed, including when constant pool indices are not compatible.For example, a bci value, modeled by a
Label, is a reference to a position in thecodearray. -
UNSTABLE
The attribute refers to structures not managed by the library (type variable lists, etc.). As a result, even when the attribute is expanded, those references may not be correctly translated, and the rewritten results may be incorrect.If the attribute is read from a
classfile,ClassFile.AttributesProcessingOptiondetermines whether to preserve or drop the attribute during transformation.- See Also:
-
UNKNOWN
The attribute is completely unknown. As a result, expanding and rewriting is not possible, and any difference between the destinationclassfile and its enclosingclassfile may make the attribute incorrect.ClassFile.AttributesProcessingOptiondetermines whether to preserve or drop the attribute during transformation.- See Also:
-
-
Method Details
-
values
Returns an array containing the constants of this enum class, in the order they are declared.- Returns:
- an array containing the constants of this enum class, in the order they are declared
-
valueOf
Returns the enum constant of this class with the specified name. The string must match exactly an identifier used to declare an enum constant in this class. (Extraneous whitespace characters are not permitted.)- Parameters:
name- the name of the enum constant to be returned.- Returns:
- the enum constant with the specified name
- Throws:
IllegalArgumentException- if this enum class has no constant with the specified nameNullPointerException- if the argument is null
-