/*
 * Copyright (c) 1995, 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. 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;

/**
 * The {@code Compiler} class is provided to support Java-to-native-code
 * compilers and related services. By design, the {@code Compiler} class does
 * nothing; it serves as a placeholder for a JIT compiler implementation.
 * If no compiler is available, these methods do nothing.
 *
 * @deprecated JIT compilers and their technologies vary too widely to
 * be controlled effectively by a standardized interface. As such, many
 * JIT compiler implementations ignore this interface, and are instead
 * controllable by implementation-specific mechanisms such as command-line
 * options. This class is subject to removal in a future version of Java SE.
 *
 * @author Frank Yellin
 * @since 1.0
 */
@Deprecated(since="9", forRemoval=true)
public final class Compiler {
 private Compiler() {} // don't make instances

 /**
 * Compiles the specified class.
 *
 * @param clazz
 * A class
 *
 * @return {@code true} if the compilation succeeded; {@code false} if the
 * compilation failed or no compiler is available
 *
 * @throws NullPointerException
 * If {@code clazz} is {@code null}
 */
 public static boolean compileClass(Class<?> clazz) {
 return false;
 }

 /**
 * Compiles all classes whose name matches the specified string.
 *
 * @param string
 * The name of the classes to compile
 *
 * @return {@code true} if the compilation succeeded; {@code false} if the
 * compilation failed or no compiler is available
 *
 * @throws NullPointerException
 * If {@code string} is {@code null}
 */
 public static boolean compileClasses(String string) {
 return false;
 }

 /**
 * Examines the argument type and its fields and perform some documented
 * operation. No specific operations are required.
 *
 * @param any
 * An argument
 *
 * @return A compiler-specific value, or {@code null} if no compiler is
 * available
 *
 * @throws NullPointerException
 * If {@code any} is {@code null}
 */
 public static Object command(Object any) {
 return null;
 }

 /**
 * Cause the Compiler to resume operation.
 */
 public static void enable() { }

 /**
 * Cause the Compiler to cease operation.
 */
 public static void disable() { }
}