net.javasauce.compilerserver

Interface Compiler

All Superinterfaces:

java.lang.AutoCloseable

public interface Compiler
extends java.lang.AutoCloseable

An abstract interface over Java's compiler tooling interface.

It supports running a compiler as a remote process, like a server.

Created by covers1624 on 8/29/25.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	Compiler.CompileResult The result of a compile operation.

Method Summary

Modifier and Type	Method and Description
void	close() Release any resources and stop any sub-processes.
Compiler.CompileResult	compile(java.net.URI sourceUri, java.lang.String source, java.util.List<java.lang.String> extraJavacArgs) Request a compilation unit be compiled.
static Compiler	forLocal(java.util.Collection<java.nio.file.Path> compileClasspath) Create a wrapper around the Java compiler on the current jdk.
static Compiler	of(java.nio.file.Path javaExecutable, java.util.Collection<java.nio.file.Path> compileClasspath) Start a remote Java compiler server.

Method Detail

of

static Compiler of(java.nio.file.Path javaExecutable,
                   java.util.Collection<java.nio.file.Path> compileClasspath)
            throws java.io.IOException

Start a remote Java compiler server.

Parameters:

javaExecutable - The Java executable of the jdk to use. Must have a compiler present.

compileClasspath - The compile classpath to use.

Returns:

The Compiler.

Throws:

java.io.IOException

forLocal

static Compiler forLocal(java.util.Collection<java.nio.file.Path> compileClasspath)
                  throws java.io.IOException

Create a wrapper around the Java compiler on the current jdk.

Parameters:

compileClasspath - The compile classpath to use.

Returns:

The Compiler.

Throws:

java.io.IOException

compile

Compiler.CompileResult compile(java.net.URI sourceUri,
                               java.lang.String source,
                               java.util.List<java.lang.String> extraJavacArgs)

Request a compilation unit be compiled.

Parameters:

sourceUri - The URI describing the location of the source file. Javac expects that packages are present in this URI.

source - The source content for the compilation unit being compiled.

extraJavacArgs - Any additional Java arguments to provide.

Returns:

The result.

close

void close()
    throws java.io.IOException

Release any resources and stop any sub-processes.

Specified by:

close in interface java.lang.AutoCloseable

Throws:

java.io.IOException