Mercurial > hg > truffle
view graal/com.oracle.graal.graphbuilderconf/src/com/oracle/graal/graphbuilderconf/InlineInvokePlugin.java @ 21608:4a8d4ee0fdd6
Allow multiple ParameterPlugin and InlineInvokePlugin in graph builder plugins; cleanup InlineInvokePlugin and implementations, including in Truffle
author | Christian Wimmer <christian.wimmer@oracle.com> |
---|---|
date | Fri, 29 May 2015 17:01:31 -0700 |
parents | 48c1ebd24120 |
children |
line wrap: on
line source
/* * Copyright (c) 2015, 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 com.oracle.graal.graphbuilderconf; import com.oracle.jvmci.meta.ResolvedJavaMethod; import com.oracle.jvmci.meta.JavaType; import com.oracle.graal.nodes.*; /** * Plugin for specifying what is inlined during graph parsing. This plugin is also notified * {@link #notifyBeforeInline before} and {@link #notifyAfterInline} the inlining, as well as of * {@link #notifyNotInlined non-inlined} invocations (i.e., those for which an {@link Invoke} node * is created). */ public interface InlineInvokePlugin extends GraphBuilderPlugin { /** * Result of a {@link #shouldInlineInvoke inlining decision}. */ public static class InlineInfo { /** Marker return value to use when the call site must not be inlined. */ public static final InlineInfo DO_NOT_INLINE = new InlineInfo(null, false); private final ResolvedJavaMethod methodToInline; private final boolean isIntrinsic; public InlineInfo(ResolvedJavaMethod methodToInline, boolean isIntrinsic) { this.methodToInline = methodToInline; this.isIntrinsic = isIntrinsic; } /** * Returns the method to be inlined, or {@code null} if the call site must not be inlined. */ public ResolvedJavaMethod getMethodToInline() { return methodToInline; } /** * Specifies if {@link #methodToInline} is an intrinsic for the original method (i.e., the * {@code method} passed to {@link InlineInvokePlugin#shouldInlineInvoke}). */ public boolean isIntrinsic() { return isIntrinsic; } } /** * Determines whether a call to a given method is to be inlined. The return value is a * tri-state: * <p> * Non-null return value with a non-null {@link InlineInfo#getMethodToInline method}: That * {@link InlineInfo#getMethodToInline method} is inlined. Note that it can be a different * method than the one specified here as the parameter, which allows method substitutions. * <p> * Non-null return value with a null {@link InlineInfo#getMethodToInline method}, e.g., * {@link InlineInfo#DO_NOT_INLINE}: The method is not inlined, and other plugins with a lower * priority cannot overwrite this decision. * <p> * Null return value: This plugin made no decision, other plugins with a lower priority are * asked. * * @param b the context * @param method the target method of an invoke * @param args the arguments to the invoke * @param returnType the return type derived from {@code method}'s signature */ default InlineInfo shouldInlineInvoke(GraphBuilderContext b, ResolvedJavaMethod method, ValueNode[] args, JavaType returnType) { return null; } /** * Notification that a method is about to be inlined. * * @param methodToInline the inlined method */ default void notifyBeforeInline(ResolvedJavaMethod methodToInline) { } /** * Notification that a method was inlined. * * @param methodToInline the inlined method */ default void notifyAfterInline(ResolvedJavaMethod methodToInline) { } /** * Notifies this plugin of the {@link Invoke} node created for a method that was not inlined per * {@link #shouldInlineInvoke}. * * @param b the context * @param method the method that was not inlined * @param invoke the invoke node created for the call to {@code method} */ default void notifyNotInlined(GraphBuilderContext b, ResolvedJavaMethod method, Invoke invoke) { } }