What is sjavac, who is it for and how do I use it?

JavaJava 8JavacJava 9

Java Problem Overview


There has been some buzz about a tool called sjavac on the OpenJDK mailing lists. Also, there are two related JEPs: JEP 139: Enhance javac to Improve Build Speed and JEP 199: Smart Java Compilation, Phase Two.

My questions are:

  • What exactly is the sjavac tool?
  • Who is it intended for?
  • How do I use it?

Disclaimer: Self answered question. Just wanted to bring the knowledge of this tool to the StackOverflow community and to create a reference to future sjavac FAQ.

Java Solutions


Solution 1 - Java

> What exactly is the sjavac tool?

The sjavac tool is an (allegedly smart) wrapper around javac, developed at Oracle and intended to provide the following features:

  • incremental compiles - recompile only what's necessary
  • parallel compilation - utilize more than one core during compilation
  • keep compiler in a hot VM - reuse a JIT'ed javac instance for consecutive invocations

When recompiling a set of source files, javac looks at the timestamps of the .java and .class files to determine what to keep and what to recompile. This is incredibly crude and can be devastating for large code bases. In addition to the timestamps sjavac inspects the public API of the dependencies to judge which files need to be recompiled.

Sjavac also attempts to split up the compilation into multiple invocations of javac. In other words, it brings a high level of parallelism to the build process.

Finally, the sjavac tool is split in a client part and a server part which allows you to leave sjavac running in the background, JIT'ed and ready for use in consecutive calls.

> Who is it intended for?

People who are working on large projects and frequently recompiles the code base during development are encouraged to try out sjavac. (Be aware however that the tool is currently under development and there are still open issues.)

> How do I use it?

The tool is not yet shipped with the OpenJDK, so you'll have to get it from the OpenJDK jdk9/dev repository. Also, there is no launcher in place yet, so you invoke it with java com.sun.tools.sjavac.Main.

Attributions

All content for this solution is sourced from the original question on Stackoverflow.

The content on this page is licensed under the Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license.

Content TypeOriginal AuthorOriginal Content on Stackoverflow
QuestionaioobeView Question on Stackoverflow
Solution 1 - JavaaioobeView Answer on Stackoverflow