JavaCompiler : Java Glossary

JavaCompiler

javax.tools.JavaCompiler is a Java version 1.6 or later interface that lets your program fire up the Java compiler, (usually javac.exe) and compile Java source, all under your program’s control, in a platform-independent way.

You don’t use exec or sun.tools.javac. Main any more.

Benefits	Learning More
Sample Code	Links
sun.tools.javac.Main

Benefits

The advantages of the JavaCompiler approach are:

The compiler runs in the same JVM (Java Virtual Machine) as your program. You don’t have the startup overhead of a second JVM.
The complier stays resident. So when you compile more source files, you don’t have to fire it up from scratch again, the way you do with the command line or exec.
You can use it to compile code that exists only in RAM (Random Access Memory). You can generate it on the fly, compile it, and execute it. This opens up all kinds of new ways of writing code. For example, imagine a spread sheet program that generated a Java program to compute the cells, the compiled it and ran it. It would run just as fast as a hand-written custom program to do those calculations. You can compile Java source that comes to you over a socket.
JavaCompiler will work with any platform, with any Java compiler. exec hooks have to be tuned to the platform.
ANT, JSP (Java Server Pages), Hibernate etc. will use this hook. They all need to invoke the compiler repeatedly and efficiently. JSP generates Java source from the mixed HTML-Java source it uses. These tools will no longer have to use illegitimate com.sun.javac. Main back door they are forced to use now.

Sample Code

JavaCompiler’s extreme generality and total lack of documentation makes it unusually inscrutable. The following example generates a Java source program on the fly in RAM, (It does not write it to disk.) and uses the default JavaFileManager to generate the class file in the CWD (Current Working Directory)

Note: the Hypotenuse.class file, that is dynamically generated by TestJavaCompiler in the CWD, must be accessible via the classpath to be able to load. For example, if the CWD is E:\myprojects\com\mindprod\example, then E:\myprojects must be on the classpath.

Here is what the dynamically generated Hypotenuse.java file looks like:

sun.tools.javac.Main

In Java version 1.5- you have the deprecated, undocumented sun.tools.javac.Main to fire up the Javac.exe compiler to run in the same JVM and compile under your control.

Learning More

Oracle’s Javadoc on JavaCompiler class : available:

on the web at Oracle.com
in the current JDK 1.7.0_04 or in the old JDK 1.6.0_32 on your local Windows J: drive.

Oracle’s Javadoc on JavaFileObject class : available:

on the web at Oracle.com
in the current JDK 1.7.0_04 or in the old JDK 1.6.0_32 on your local Windows J: drive.

Oracle’s Javadoc on ForwardingJavaFileObject class : available:

on the web at Oracle.com
in the current JDK 1.7.0_04 or in the old JDK 1.6.0_32 on your local Windows J: drive.

Oracle’s Javadoc on SimpleJavaFileObject class : available:

on the web at Oracle.com
in the current JDK 1.7.0_04 or in the old JDK 1.6.0_32 on your local Windows J: drive.

Oracle’s Javadoc on JavaFileManager class : available:

on the web at Oracle.com
in the current JDK 1.7.0_04 or in the old JDK 1.6.0_32 on your local Windows J: drive.

Oracle’s Javadoc on ToolProvider class : available:

on the web at Oracle.com
in the current JDK 1.7.0_04 or in the old JDK 1.6.0_32 on your local Windows J: drive.

Class.forName
IBM’s hints on using JavaCompiler
Javac.exe
JavaLobby sample code
on the fly compose, compile and run
sun.tools.javac.Main

	You can get the freshest copy of this page from:	or possibly from your local J: drive (Java virtual drive/mindprod.com website mirror)
	http://mindprod.com/jgloss/javacompiler.html	J:\mindprod\jgloss\javacompiler.html
	Please email your feedback for publication, letters to the editor, errors, omissions, typos, formatting errors, ambiguities, unclear wording, broken/redirected link reports, suggestions to improve this page or comments to Roedy Green : . If you want your message, your name or email kept confidential, not considered for public posting, please explicitly specify that. Unless you state otherwise, I will treat your message as a letter to the editor that I may or may not publish in the feedback section. After that, it will be too late to retract it. If you disagree with something I said, please quote it and cite the web page where you found it, tell me why you think it is wrong, and, if possible, provide some supporting evidence. Threatening to kill me or spouting obscenities has yet to persuade me to change my mind.
	Canadian Mind Products
	mindprod.com IP:[65.110.21.43]
view Blog	Your face IP:[38.107.179.210]
Feedback	You are visitor number 13,375.