JavaCompiler : Java Glossary

2006-02-18 by Roedy Green ©1996-2008 Canadian Mind Products
Go to : punctuation 0-9 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z (all)

JavaCompiler

javax.tools.JavaCompiler is a JDK 1.6+ 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 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. 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, 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

I still have not figured out how JavaCompiler works. Its extreme generality and total lack of documenation makes it unusually inscrutable. Here is how far I have got. I still can’t figure out how to control where the compiler puts the *.class files.

sun.tools.javac.Main

In JDK 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

Sun’s Javadoc on the JavaCompiler class : available:

on the web at java.Sun.com
in the JDK 1.6.0_06 or in the older JDK 1.5.0_15 or the even older JDK 1.4.2_17 on your local J: drive.

Sun’s Javadoc on the JavaFileObject class : available:

on the web at java.Sun.com
in the JDK 1.6.0_06 or in the older JDK 1.5.0_15 or the even older JDK 1.4.2_17 on your local J: drive.

Sun’s Javadoc on the ForwardingJavaFileObject class : available:

on the web at java.Sun.com
in the JDK 1.6.0_06 or in the older JDK 1.5.0_15 or the even older JDK 1.4.2_17 on your local J: drive.

Sun’s Javadoc on the SimpleJavaFileObject class : available:

on the web at java.Sun.com
in the JDK 1.6.0_06 or in the older JDK 1.5.0_15 or the even older JDK 1.4.2_17 on your local J: drive.

Sun’s Javadoc on the JavaFileManager class : available:

on the web at java.Sun.com
in the JDK 1.6.0_06 or in the older JDK 1.5.0_15 or the even older JDK 1.4.2_17 on your local J: drive.

Sun’s Javadoc on the ToolProvider class : available:

on the web at java.Sun.com
in the JDK 1.6.0_06 or in the older JDK 1.5.0_15 or the even older JDK 1.4.2_17 on your local J: drive.

Class.forName
Javac.exe
JavaLobby sample code
on the fly compose, compile and run
sun.tools.javac.Main

	Please email your feedback for publication, errors, omissions, broken/redirected link reports and suggestions to improve this page to Roedy Green :
	Canadian Mind Products
	mindprod.com IP:[65.110.21.43]
	Your face IP:[38.103.63.18]
	You are visitor number 1,069.
	You can get a fresh copy of this page from:	or possibly from your local J: drive (Java virtual drive/Mindprod website mirror)
	http://mindprod.com/jgloss/javacompiler.html	J:\mindprod\jgloss\javacompiler.html