Module java.base

Package java.lang.classfile^PREVIEW

Interface MethodTransform

All Superinterfaces:

ClassFileTransformPREVIEW<MethodTransformPREVIEW,MethodElementPREVIEW,MethodBuilderPREVIEW>

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 MethodTransform
extends ClassFileTransformPREVIEW<MethodTransformPREVIEW,MethodElementPREVIEW,MethodBuilderPREVIEW>

MethodTransform is a preview API of the Java platform.

Programs can only use MethodTransform when preview features are enabled.

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

A transformation on streams of MethodElement^PREVIEW.

Since:

22

See Also:

• ClassFileTransform^PREVIEW

Nested Class Summary

Nested classes/interfaces declared in interface java.lang.classfile.ClassFileTransform^PREVIEW

ClassFileTransform.ResolvedTransformPREVIEW<E extends ClassFileElementPREVIEW>

Field Summary

Fields

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

Method Summary

Modifier and Type	Method	Description
default MethodTransformPREVIEW	andThen(MethodTransformPREVIEW t)	Chain this transform with another; elements presented to the builder of this transform will become the input to the next transform.
static MethodTransformPREVIEW	dropping(Predicate<MethodElementPREVIEW> filter)	Create a method transform that passes each element through to the builder, except for those that the supplied Predicate is true for.
static MethodTransformPREVIEW	endHandler(Consumer<MethodBuilderPREVIEW> finisher)	Create a method transform that passes each element through to the builder, and calls the specified function when transformation is complete.
static MethodTransformPREVIEW	ofStateful(Supplier<MethodTransformPREVIEW> supplier)	Create a stateful method transform from a Supplier.
default ClassFileTransform.ResolvedTransformPREVIEW<MethodElementPREVIEW>	resolve(MethodBuilderPREVIEW builder)	Bind a transform to a builder.
static MethodTransformPREVIEW	transformingCode(CodeTransformPREVIEW xform)	Create a method transform that transforms CodeModelPREVIEW elements with the supplied code transform.

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

accept, atEnd, atStart

Field Details

ACCEPT_ALL

static final MethodTransformPREVIEW ACCEPT_ALL

A method transform that sends all elements to the builder.

Method Details

ofStateful

static MethodTransformPREVIEW ofStateful(Supplier<MethodTransformPREVIEW> supplier)

Create a stateful method 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 method transform

endHandler

static MethodTransformPREVIEW endHandler(Consumer<MethodBuilderPREVIEW> finisher)

Create a method 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 method transform

dropping

static MethodTransformPREVIEW dropping(Predicate<MethodElementPREVIEW> filter)

Create a method transform that passes each element through to the builder, except for those that the supplied Predicate is true for.

Parameters:

filter - the predicate that determines which elements to drop

Returns:

the method transform

transformingCode

static MethodTransformPREVIEW transformingCode(CodeTransformPREVIEW xform)

Create a method transform that transforms CodeModel^PREVIEW elements with the supplied code transform.

Parameters:

xform - the method transform

Returns:

the class transform

resolve

default ClassFileTransform.ResolvedTransformPREVIEW<MethodElementPREVIEW> resolve(MethodBuilderPREVIEW 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)^PREVIEW), 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)^PREVIEW, which resolves the transform and executes it on the current builder.

Specified by:

resolve in interface ClassFileTransformPREVIEW<MethodTransformPREVIEW,MethodElementPREVIEW,MethodBuilderPREVIEW>

Implementation Requirements:

The default implementation returns a resolved transform bound to the given method builder.

Parameters:

builder - the builder to bind to

Returns:

the bound result

andThen

default MethodTransformPREVIEW andThen(MethodTransformPREVIEW 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 ClassFileTransformPREVIEW<MethodTransformPREVIEW,MethodElementPREVIEW,MethodBuilderPREVIEW>

Implementation Requirements:

The default implementation returns this method transform chained with another method transform from the argument. Chaining of two transforms requires to involve a chained builder serving as a target builder for this transform and also as a source of elements for the downstream transform.

Parameters:

t - the downstream transform

Returns:

the chained transform