Interface CodeRelabeler

All Superinterfaces:

ClassFileTransformPREVIEW<CodeTransformPREVIEW,CodeElementPREVIEW,CodeBuilderPREVIEW>, CodeTransformPREVIEW

public sealed interface CodeRelabeler
extends CodeTransformPREVIEW

CodeRelabeler is a preview API of the Java platform.

Programs can only use CodeRelabeler when preview features are enabled.

Preview features may be removed in a future release, or upgraded to permanent features of the Java platform.

A code relabeler is a CodeTransform^PREVIEW replacing all occurrences of Label^PREVIEW in the transformed code with new instances. All LabelTarget^PREVIEW instructions are adjusted accordingly. Relabeled code graph is identical to the original.

Primary purpose of CodeRelabeler is for repeated injections of the same code blocks. Repeated injection of the same code block must be relabeled, so each instance of Label^PREVIEW is bound in the target bytecode exactly once.

Since:

22

Field Summary

Fields declared in interface java.lang.classfile.CodeTransform^PREVIEW

ACCEPT_ALL

Method Summary

Static Methods

Modifier and Type	Method	Description
static CodeRelabelerPREVIEW	of()	Creates a new instance of CodeRelabeler.
static CodeRelabelerPREVIEW	of(BiFunction<LabelPREVIEW,CodeBuilderPREVIEW,LabelPREVIEW> mapFunction)	Creates a new instance of CodeRelabeler using provided BiFunction to re-label the code.
static CodeRelabelerPREVIEW	of(Map<LabelPREVIEW,LabelPREVIEW> map)	Creates a new instance of CodeRelabeler storing the label mapping into the provided map.

Methods declared in interface java.lang.classfile.ClassFileTransform^PREVIEW

accept, atEnd, atStart

Methods declared in interface java.lang.classfile.CodeTransform^PREVIEW

andThen

Method Details

of

static CodeRelabelerPREVIEW of()

Creates a new instance of CodeRelabeler.

Returns:

a new instance of CodeRelabeler

of

static CodeRelabelerPREVIEW of(Map<LabelPREVIEW,LabelPREVIEW> map)

Creates a new instance of CodeRelabeler storing the label mapping into the provided map.

Parameters:

map - label map actively used for relabeling

Returns:

a new instance of CodeRelabeler

of

static CodeRelabelerPREVIEW of(BiFunction<LabelPREVIEW,CodeBuilderPREVIEW,LabelPREVIEW> mapFunction)

Creates a new instance of CodeRelabeler using provided BiFunction to re-label the code.

Parameters:

mapFunction - function for remapping labels in the source code model

Returns:

a new instance of CodeRelabeler