java.lang.classfile.attribute

public sealed Interface StackMapTableAttribute

Known Direct Implementers: jdk.internal.classfile.impl.BoundAttribute.BoundStackMapTableAttribute, jdk.internal.classfile.impl.UnboundAttribute.UnboundStackMapTableAttribute
Imports: java.lang.classfile.Attribute, .AttributeMapper, .AttributeMapper.AttributeStability, .Attributes, .ClassFile, .CodeElement, java.lang.classfile.instruction.DiscontinuedInstruction, java.util.List, jdk.internal.classfile.impl.BoundAttribute, .UnboundAttribute

Models the StackMapTable attribute (JVMS 4.7.4), which is used for verification by type checking (4.10.1).

This attribute is not delivered in the traversal of a CodeAttribute, but instead automatically generated upon class file writing. Advanced users can supply their own stack maps according to the ClassFile.StackMapsOption.

This attribute only appears on Code attributes, and does not permit multiple instances in a Code attribute. It has a data dependency on labels in the code array.

This attribute was introduced in the Java SE Platform version 6, major version 50.

Since: 24
Java Virtual Machine Specification: 4.7.4 The StackMapTable Attribute, 4.10.1 Verification by Type Checking
See Also: Attributes#stackMapTable(), DiscontinuedInstruction.JsrInstruction, DiscontinuedInstruction.RetInstruction

Method Summary

Modifier and Type	Method and Description
public List<StackMapFrameInfo>	Returns: the stack map frames entries() Returns the stack map frames.
public static StackMapTableAttribute	Returns: a stack map table attribute of(List<StackMapFrameInfo> the stack map frames entries) Returns a stack map table attribute.

Inherited from java.lang.classfile.Attribute:: attributeMapper attributeName

Method Detail

entries	back to summary
public List<StackMapFrameInfo> entries() Returns the stack map frames. Returns:List<StackMapFrameInfo> the stack map frames

entries

back to summary

public List<StackMapFrameInfo> entries()

Returns the stack map frames.

Returns:List<StackMapFrameInfo>: the stack map frames

of back to summary

of	back to summary
public static StackMapTableAttribute of(List<StackMapFrameInfo> entries) Returns a stack map table attribute. Parameters entries:List<StackMapFrameInfo> the stack map frames Returns:StackMapTableAttribute a stack map table attribute Exceptions IllegalArgumentException: if the number of frames exceeds the limit of `u2`

public static StackMapTableAttribute of(List<StackMapFrameInfo> entries)

Returns a stack map table attribute.

Parameters

entries:List<StackMapFrameInfo>: the stack map frames

Returns:StackMapTableAttribute

a stack map table attribute

Exceptions

IllegalArgumentException:: if the number of frames exceeds the limit of u2