JDK14/Java14源码在线阅读

/*
 * Copyright (c) 2015, 2018, 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.
 *
 * 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 org.graalvm.compiler.nodes.graphbuilderconf;

import java.util.function.Supplier;

import org.graalvm.compiler.nodes.FrameState;
import org.graalvm.compiler.nodes.ValueNode;

import jdk.vm.ci.meta.ConstantPool;
import jdk.vm.ci.meta.ResolvedJavaType;

/**
 * Plugin for emitting a class initialization barrier (i.e., initializes a class if it's not already
 * initialized).
 *
 * This plugin also supports separating class resolution from class initialization with
 * {@link #supportsLazyInitialization(ConstantPool)} and
 * {@link #loadReferencedType(GraphBuilderContext, ConstantPool, int, int)}.
 *
 * @see "https://bugs.openjdk.java.net/browse/JDK-8146201"
 */
public interface ClassInitializationPlugin extends GraphBuilderPlugin {

    /**
     * Emits a class initialization barrier for {@code type}.
     *
     * @param frameState supplier to create a frame state representing the state just prior to
     *            execution of the class initialization barrier
     * @param classInit if non-null, the node representing the class initialization barrier should
     *            be returned in element 0 of this array
     * @return {@code true} if this method emitted a barrier,{@code false} if not
     */
    boolean apply(GraphBuilderContext builder, ResolvedJavaType type, Supplier<FrameState> frameState, ValueNode[] classInit);

    /**
     * Emits a class initialization barrier for {@code type}.
     *
     * @param frameState supplier to create a frame state representing the state just prior to
     *            execution of the class initialization barrier
     * @return {@code true} if this method emitted a barrier,{@code false} if not
     */
    default boolean apply(GraphBuilderContext builder, ResolvedJavaType type, Supplier<FrameState> frameState) {
        return apply(builder, type, frameState, null);
    }

    /**
     * Determines if {@code cp} has a variation of {@link ConstantPool#loadReferencedType} that can
     * resolved a type without initializing it.
     */
    boolean supportsLazyInitialization(ConstantPool cp);

    /**
     * Ensures that the type referenced by the constant pool entry specified by {@code cp} and
     * {@code cpi} is loaded. If {@code cp} does not support

/**代码未完, 请加载全部代码(NowJava.com).**/