JavaTM 2 Platform
Std. Ed. v1.4.0

java.lang
Class Compiler

java.lang.Object
  |
  +--java.lang.Compiler

public final class Compiler
extends Object

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.

Since:
JDK1.0
See Also:
System.getProperty(java.lang.String), System.getProperty(java.lang.String, java.lang.String), System.loadLibrary(java.lang.String)

Method Summary
static Object command(Object any)
          Examines the argument type and its fields and perform some documented operation.
static boolean compileClass(Class clazz)
          Compiles the specified class.
static boolean compileClasses(String string)
          Compiles all classes whose name matches the specified string.
static void disable()
          Cause the Compiler to cease operation.
static void enable()
          Cause the Compiler to resume operation.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

compileClass

public static boolean compileClass(Class clazz)
Compiles the specified class.

Parameters:
clazz - a class.
Returns:
true if the compilation succeeded; false if the compilation failed or no compiler is available.
Throws:
NullPointerException - if clazz is null.

compileClasses

public static boolean compileClasses(String string)
Compiles all classes whose name matches the specified string.

Parameters:
string - the name of the classes to compile.
Returns:
true if the compilation succeeded; false if the compilation failed or no compiler is available.
Throws:
NullPointerException - if string is null.

command

public static Object command(Object any)
Examines the argument type and its fields and perform some documented operation. No specific operations are required.

Parameters:
any - an argument.
Returns:
a compiler-specific value, or null if no compiler is available.
Throws:
NullPointerException - if any is null.

enable

public static void enable()
Cause the Compiler to resume operation.


disable

public static void disable()
Cause the Compiler to cease operation.


JavaTM 2 Platform
Std. Ed. v1.4.0

Submit a bug or feature
For further API reference and developer documentation, see Java 2 SDK SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Java, Java 2D, and JDBC are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries.
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.