Module org.glavo.classfile

Package org.glavo.classfile

Interface CodeTransform

All Superinterfaces:

ClassfileTransform<CodeTransform,CodeElement,CodeBuilder>

All Known Subinterfaces:

CodeLocalsShifter, CodeRelabeler, CodeStackTracker

All Known Implementing Classes:

CodeLocalsShifter.CodeLocalsShifterImpl, CodeRelabeler.CodeRelabelerImpl, CodeStackTracker.CodeStackTrackerImpl, TransformImpl.ChainedCodeTransform, TransformImpl.SupplierCodeTransform

Functional Interface:

This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.

@FunctionalInterface
public non-sealed interface CodeTransform
extends ClassfileTransform<CodeTransform,CodeElement,CodeBuilder>

A transformation on streams of CodeElement.

See Also:

• ClassfileTransform

Nested Class Summary

Nested classes/interfaces inherited from interface org.glavo.classfile.ClassfileTransform

ClassfileTransform.ResolvedTransform<E extends ClassfileElement>

Field Summary

Fields

Modifier and Type	Field	Description
static final CodeTransform	ACCEPT_ALL	A code transform that sends all elements to the builder.

Method Summary

Modifier and Type	Method	Description
default CodeTransform	andThen(CodeTransform t)	Chain this transform with another; elements presented to the builder of this transform will become the input to the next transform.
static CodeTransform	endHandler(Consumer<CodeBuilder> finisher)	Create a code transform that passes each element through to the builder, and calls the specified function when transformation is complete.
static CodeTransform	ofStateful(Supplier<CodeTransform> supplier)	Create a stateful code transform from a Supplier.
default ClassfileTransform.ResolvedTransform<CodeElement>	resolve(CodeBuilder builder)	Bind a transform to a builder.

Methods inherited from interface org.glavo.classfile.ClassfileTransform

accept, atEnd, atStart

Field Details

ACCEPT_ALL

static final CodeTransform ACCEPT_ALL

A code transform that sends all elements to the builder.

Method Details

ofStateful

static CodeTransform ofStateful(Supplier<CodeTransform> supplier)

Create a stateful code transform from a Supplier. The supplier will be invoked for each transformation.

Parameters:

supplier - a Supplier that produces a fresh transform object for each traversal

Returns:

the stateful code transform

endHandler

static CodeTransform endHandler(Consumer<CodeBuilder> finisher)

Create a code transform that passes each element through to the builder, and calls the specified function when transformation is complete.

Parameters:

finisher - the function to call when transformation is complete

Returns:

the code transform

andThen

default CodeTransform andThen(CodeTransform t)

Description copied from interface: ClassfileTransform

Chain this transform with another; elements presented to the builder of this transform will become the input to the next transform.

Specified by:

andThen in interface ClassfileTransform<CodeTransform,CodeElement,CodeBuilder>

Parameters:

t - the downstream transform

Returns:

the chained transform

resolve

default ClassfileTransform.ResolvedTransform<CodeElement> resolve(CodeBuilder builder)

Description copied from interface: ClassfileTransform

Bind a transform to a builder. If the transform is chained, intermediate builders are created for each chain link. If the transform is stateful (see, e.g., ClassTransform.ofStateful(Supplier)), the supplier is invoked to get a fresh transform object.

This method is a low-level method that should rarely be used by user code; most of the time, user code should prefer ClassfileBuilder.transform(CompoundElement, ClassfileTransform), which resolves the transform and executes it on the current builder.

Specified by:

resolve in interface ClassfileTransform<CodeTransform,CodeElement,CodeBuilder>

Parameters:

builder - the builder to bind to

Returns:

the bound result