mirror of
https://github.com/openjdk/jdk.git
synced 2025-08-26 22:34:27 +02:00
99 lines
3.6 KiB
Java
99 lines
3.6 KiB
Java
/*
|
|
* Copyright (c) 2022, 2024, Oracle and/or its affiliates. All rights reserved.
|
|
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
|
*
|
|
* This code is free software; you can redistribute it and/or modify it
|
|
* under the terms of the GNU General Public License version 2 only, as
|
|
* published by the Free Software Foundation. Oracle designates this
|
|
* particular file as subject to the "Classpath" exception as provided
|
|
* by Oracle in the LICENSE file that accompanied this code.
|
|
*
|
|
* This code is distributed in the hope that it will be useful, but WITHOUT
|
|
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
|
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
|
* version 2 for more details (a copy is included in the LICENSE file that
|
|
* accompanied this code).
|
|
*
|
|
* You should have received a copy of the GNU General Public License version
|
|
* 2 along with this work; if not, write to the Free Software Foundation,
|
|
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
|
|
*
|
|
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
|
|
* or visit www.oracle.com if you need additional information or have any
|
|
* questions.
|
|
*/
|
|
package java.lang.classfile;
|
|
|
|
import java.util.function.Consumer;
|
|
import java.util.function.Supplier;
|
|
|
|
import jdk.internal.classfile.impl.TransformImpl;
|
|
import jdk.internal.javac.PreviewFeature;
|
|
|
|
/**
|
|
* A transformation on streams of {@link CodeElement}.
|
|
*
|
|
* @see ClassFileTransform
|
|
*
|
|
* @since 22
|
|
*/
|
|
@PreviewFeature(feature = PreviewFeature.Feature.CLASSFILE_API)
|
|
@FunctionalInterface
|
|
public non-sealed interface CodeTransform
|
|
extends ClassFileTransform<CodeTransform, CodeElement, CodeBuilder> {
|
|
|
|
/**
|
|
* A code transform that sends all elements to the builder.
|
|
*/
|
|
CodeTransform ACCEPT_ALL = new CodeTransform() {
|
|
@Override
|
|
public void accept(CodeBuilder builder, CodeElement element) {
|
|
builder.with(element);
|
|
}
|
|
};
|
|
|
|
/**
|
|
* Create a stateful code transform from a {@link Supplier}. The supplier
|
|
* will be invoked for each transformation.
|
|
*
|
|
* @param supplier a {@link Supplier} that produces a fresh transform object
|
|
* for each traversal
|
|
* @return the stateful code transform
|
|
*/
|
|
static CodeTransform ofStateful(Supplier<CodeTransform> supplier) {
|
|
return new TransformImpl.SupplierCodeTransform(supplier);
|
|
}
|
|
|
|
/**
|
|
* Create a code transform that passes each element through to the builder,
|
|
* and calls the specified function when transformation is complete.
|
|
*
|
|
* @param finisher the function to call when transformation is complete
|
|
* @return the code transform
|
|
*/
|
|
static CodeTransform endHandler(Consumer<CodeBuilder> finisher) {
|
|
return new CodeTransform() {
|
|
@Override
|
|
public void accept(CodeBuilder builder, CodeElement element) {
|
|
builder.with(element);
|
|
}
|
|
|
|
@Override
|
|
public void atEnd(CodeBuilder builder) {
|
|
finisher.accept(builder);
|
|
}
|
|
};
|
|
}
|
|
|
|
/**
|
|
* @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.
|
|
*/
|
|
@Override
|
|
default CodeTransform andThen(CodeTransform t) {
|
|
return new TransformImpl.ChainedCodeTransform(this, t);
|
|
}
|
|
}
|