Module java.base

Package java.lang.classfile^PREVIEW

Interface FieldTransform

All Superinterfaces:

ClassFileTransformPREVIEW<FieldTransformPREVIEW,FieldElementPREVIEW,FieldBuilderPREVIEW>

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 FieldTransform
extends ClassFileTransformPREVIEW<FieldTransformPREVIEW,FieldElementPREVIEW,FieldBuilderPREVIEW>

FieldTransform is a preview API of the Java platform.

Programs can only use FieldTransform 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 FieldElement^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 FieldTransformPREVIEW	ACCEPT_ALL	A field transform that sends all elements to the builder.

Method Summary

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

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

accept, atEnd, atStart

Field Details

ACCEPT_ALL

static final FieldTransformPREVIEW ACCEPT_ALL

A field transform that sends all elements to the builder.

Method Details

ofStateful

static FieldTransformPREVIEW ofStateful(Supplier<FieldTransformPREVIEW> supplier)

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

endHandler

static FieldTransformPREVIEW endHandler(Consumer<FieldBuilderPREVIEW> finisher)

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

dropping

static FieldTransformPREVIEW dropping(Predicate<FieldElementPREVIEW> filter)

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

andThen

default FieldTransformPREVIEW andThen(FieldTransformPREVIEW 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<FieldTransformPREVIEW,FieldElementPREVIEW,FieldBuilderPREVIEW>

Implementation Requirements:

The default implementation returns this field transform chained with another field 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

resolve

default ClassFileTransform.ResolvedTransformPREVIEW<FieldElementPREVIEW> resolve(FieldBuilderPREVIEW 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<FieldTransformPREVIEW,FieldElementPREVIEW,FieldBuilderPREVIEW>

Implementation Requirements:

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

Parameters:

builder - the builder to bind to

Returns:

the bound result