java.lang

Class Compiler

public final class Compiler extends Object

The Compiler class is a placeholder for a JIT compiler implementation, and does nothing unless there is such a compiler.

The system property java.compiler may contain the name of a library to load with System.loadLibrary when the virtual machine first starts. If so, and loading the library succeeds, then a function by the name of java_lang_Compiler_start() in that library is called.

Note that a VM might not have implemented any of this.

Since: JDK 1.0

See Also: getProperty System loadLibrary

UNKNOWN: updated to 1.4

Method Summary
static Objectcommand(Object arg)
This method examines the argument and performs an operation according to the compilers documentation.
static booleancompileClass(Class<?> oneClass)
Compile the class named by oneClass.
static booleancompileClasses(String classNames)
Compile the classes whose name matches classNames.
static voiddisable()
Calling Compiler.disable() will cause the compiler to be suspended; provided that a compiler even exists.
static voidenable()
Calling Compiler.enable() will cause the compiler to resume operation if it was previously disabled; provided that a compiler even exists.

Method Detail

command

public static Object command(Object arg)
This method examines the argument and performs an operation according to the compilers documentation. No specific operation is required.

Parameters: arg a compiler-specific argument

Returns: a compiler-specific value, including null

Throws: NullPointerException if the compiler doesn't like a null arg

compileClass

public static boolean compileClass(Class<?> oneClass)
Compile the class named by oneClass.

Parameters: oneClass the class to compile

Returns: false if no compiler is available or compilation failed, true if compilation succeeded

Throws: NullPointerException if oneClass is null

compileClasses

public static boolean compileClasses(String classNames)
Compile the classes whose name matches classNames.

Parameters: classNames the name of classes to compile

Returns: false if no compiler is available or compilation failed, true if compilation succeeded

Throws: NullPointerException if classNames is null

disable

public static void disable()
Calling Compiler.disable() will cause the compiler to be suspended; provided that a compiler even exists.

enable

public static void enable()
Calling Compiler.enable() will cause the compiler to resume operation if it was previously disabled; provided that a compiler even exists.