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:
CodeLocalsShifterImpl, CodeRelabelerImpl, 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.
Since:
22
See Also:

  • 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
      ImplSpec:
      The default implementation returns this code transform chained with another code 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.

    • 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
      ImplSpec:
      The default implementation returns a resolved transform bound to the given code builder.