/*
 * Copyright (c) 2016, 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 jdk.vm.ci.hotspot;

import jdk.vm.ci.runtime.JVMCICompilerFactory;

HotSpot extensions to JVMCICompilerFactory. /**
 * HotSpot extensions to {@link JVMCICompilerFactory}.
 */
public abstract class HotSpotJVMCICompilerFactory implements JVMCICompilerFactory {

    
Gets 0 or more prefixes identifying classes that should by compiled by C1 in simple mode (i.e., CompLevel_simple) when HotSpot is running with tiered compilation. The prefixes should be class or package names using "/" as the separator, e.g. "jdk/vm/ci". 
Returns:
0 or more Strings identifying packages that should by compiled by the first tier only
        or null if no redirection to C1 should be performed./**
     * Gets 0 or more prefixes identifying classes that should by compiled by C1 in simple mode
     * (i.e., {@code CompLevel_simple}) when HotSpot is running with tiered compilation. The
     * prefixes should be class or package names using "/" as the separator, e.g. "jdk/vm/ci".
     *
     * @return 0 or more Strings identifying packages that should by compiled by the first tier only
     *         or null if no redirection to C1 should be performed.
     */
    public String[] getTrivialPrefixes() {
        return null;
    }

    public enum CompilationLevelAdjustment {
        
No adjustment.
/**
         * No adjustment.
         */
        None,

        
Adjust based on declaring class of method.
/**
         * Adjust based on declaring class of method.
         */
        ByHolder,

        
Adjust based on declaring class, name and signature of method.
/**
         * Adjust based on declaring class, name and signature of method.
         */
        ByFullSignature
    }

    
Determines if this object may want to adjust the compilation level for a method that is being
scheduled by the VM for compilation.
/**
     * Determines if this object may want to adjust the compilation level for a method that is being
     * scheduled by the VM for compilation.
     */
    public CompilationLevelAdjustment getCompilationLevelAdjustment() {
        return CompilationLevelAdjustment.None;
    }

    public enum CompilationLevel {
        None,
        Simple,
        LimitedProfile,
        FullProfile,
        FullOptimization
    }

    
Potentially modifies the compilation level currently selected by the VM compilation policy
for a method.
Params:
declaringClass – the class in which the method is declared
name – the name of the method or null depending on the value that was returned by getCompilationLevelAdjustment()
signature – the signature of the method or null depending on the value that was returned by getCompilationLevelAdjustment()
isOsr – specifies if the compilation being scheduled in an OSR compilation
level – the compilation level currently selected by the VM compilation policy
Returns:
the compilation level to use for the compilation being scheduled (must be a valid CompLevel enum value)/**
     * Potentially modifies the compilation level currently selected by the VM compilation policy
     * for a method.
     *
     * @param declaringClass the class in which the method is declared
     * @param name the name of the method or {@code null} depending on the value that was returned
     *            by {@link #getCompilationLevelAdjustment()}
     * @param signature the signature of the method or {@code null} depending on the value that was
     *            returned by {@link #getCompilationLevelAdjustment()}
     * @param isOsr specifies if the compilation being scheduled in an OSR compilation
     * @param level the compilation level currently selected by the VM compilation policy
     * @return the compilation level to use for the compilation being scheduled (must be a valid
     *         {@code CompLevel} enum value)
     */
    public CompilationLevel adjustCompilationLevel(Class<?> declaringClass, String name, String signature, boolean isOsr, CompilationLevel level) {
        throw new InternalError("Should not reach here");
    }
}