/*
* @(#)Compiler.java 1.20 04/05/05
*
* Copyright 2004 Sun Microsystems, Inc. All rights reserved.
* SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
*/
package java.lang;
/**
* The Compiler
class is provided to support
* Java-to-native-code compilers and related services. By design, the
* Compiler
class does nothing; it serves as a
* placeholder for a JIT compiler implementation.
*
* When the Java Virtual Machine first starts, it determines if the
* system property java.compiler
exists. (System
* properties are accessible through getProperty
and ,
* a method defined by the System
class.) If so, it is
* assumed to be the name of a library (with a platform-dependent
* exact location and type); the loadLibrary
method in
* class System
is called to load that library. If this
* loading succeeds, the function named
* java_lang_Compiler_start()
in that library is called.
*
* If no compiler is available, these methods do nothing.
*
* @author Frank Yellin
* @version 1.20, 05/05/04
* @see java.lang.System#getProperty(java.lang.String)
* @see java.lang.System#getProperty(java.lang.String, java.lang.String)
* @see java.lang.System#loadLibrary(java.lang.String)
* @since JDK1.0
*/
public final class Compiler {
private Compiler() {} // don't make instances
private static native void initialize();
private static native void registerNatives();
static {
registerNatives();
java.security.AccessController.doPrivileged
(new java.security.PrivilegedAction() {
public Object run() {
boolean loaded = false;
String jit = System.getProperty("java.compiler");
if ((jit != null) && (!jit.equals("NONE")) &&
(!jit.equals("")))
{
try {
System.loadLibrary(jit);
initialize();
loaded = true;
} catch (UnsatisfiedLinkError e) {
System.err.println("Warning: JIT compiler \"" +
jit + "\" not found. Will use interpreter.");
}
}
String info = System.getProperty("java.vm.info");
if (loaded) {
System.setProperty("java.vm.info", info + ", " + jit);
} else {
System.setProperty("java.vm.info", info + ", nojit");
}
return null;
}
});
}
/**
* Compiles the specified class.
*
* @param clazz a class.
* @return true
if the compilation succeeded;
* false
if the compilation failed or no compiler
* is available.
* @exception NullPointerException if clazz
is
* null
.
*/
public static native boolean compileClass(Class> clazz);
/**
* Compiles all classes whose name matches the specified string.
*
* @param string the name of the classes to compile.
* @return true
if the compilation succeeded;
* false
if the compilation failed or no compiler
* is available.
* @exception NullPointerException if string
is
* null
.
*/
public static native boolean compileClasses(String string);
/**
* 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 null
if no compiler
* is available.
* @exception NullPointerException if any
is
* null
.
*/
public static native Object command(Object any);
/**
* Cause the Compiler to resume operation.
*/
public static native void enable();
/**
* Cause the Compiler to cease operation.
*/
public static native void disable();
}