Interface JctCompilation

public interface JctCompilation
The result of a compilation.

This provides access to a number of useful pieces of information including the file manager used for the compilation, compiler logs, and diagnostics.

Since:
0.0.1
Author:
Ashley Scopes

  • Method Details

    • getArguments

      List<String> getArguments()
      Get the command line arguments that were passed to the compiler.
      Returns:
      the command line arguments.
      Since:
      0.5.0

    • isFailOnWarnings

      boolean isFailOnWarnings()
      Determine if warnings were treated as errors.
      Returns:
      true if warnings were treated as errors, or false otherwise.

    • isSuccessful

      boolean isSuccessful()
      Determine if the compilation was successful or not.
      Returns:
      true if successful, or false if not successful.

    • isFailure

      default boolean isFailure()
      Determine if the compilation was a failure or not.
      Returns:
      true if not successful, or false if successful.

    • getOutputLines

      List<String> getOutputLines()
      Get the lines of output produced by the compiler, if any were captured.

      This is separate to diagnostics.

      Returns:
      the lines of output.

    • getCompilationUnits

      Set<JavaFileObject> getCompilationUnits()
      Get the compilation units used in the compilation.
      Returns:
      the compilation units.

    • getDiagnostics

      List<TraceDiagnostic<JavaFileObject>> getDiagnostics()
      Get the diagnostics that were reported by the compilation, in the order that they were reported.
      Returns:
      the diagnostics

    • getFileManager

      JctFileManager getFileManager()
      Get the file manager that was used to store and manage files.

      This can be used to obtain a classloader for any compiled sources, which can then be used to reflectively test what the compiler produced.

      Returns:
      the file manager.

    • getClassOutputs

      default @Nullable OutputContainerGroup getClassOutputs()
      Get the output container group for class outputs.

      This usually consists of any *.class files produced by the compiler, and is equivalent to target/classes in a Maven project.

      Returns:
      the output container group, or null if it does not exist.

    • getSourceOutputs

      default @Nullable OutputContainerGroup getSourceOutputs()
      Get the output container group for source outputs.

      This consists of any generated source code created by annotation processors, and is equivalent to target/generated-sources in a Maven project.

      Returns:
      the output container group, or null if it does not exist.

    • getClassPath

      default @Nullable PackageContainerGroup getClassPath()
      Get the package container group for the class path.

      This represents the class path used for compilation.

      Returns:
      the package container group, or null if it does not exist.

    • getSourcePath

      default @Nullable PackageContainerGroup getSourcePath()
      Get the package container group for the source path.

      This is equivalent to src/main/java and src/main/resources in a Maven project.

      Returns:
      the package container group, or null if it does not exist.

    • getAnnotationProcessorPath

      default @Nullable PackageContainerGroup getAnnotationProcessorPath()
      Get the package container group for the annotation processor path.
      Returns:
      the package container group, or null if it does not exist.

    • getAnnotationProcessorModulePath

      default @Nullable ModuleContainerGroup getAnnotationProcessorModulePath()
      Get the module container group for the annotation processor module path.
      Returns:
      the module container group, or null if it does not exist.

    • getPlatformClassPath

      default @Nullable PackageContainerGroup getPlatformClassPath()
      Get the package container group for the platform class path (a.k.a. the bootstrap class path).

      You generally do not need to use this. The platform class path mechanism has been mostly replaced by the use of the system modules path as of Java 11. It is simply provided for backwards compatibility.

      Returns:
      the package container group, or null if it does not exist.

    • getNativeHeaderOutputs

      default @Nullable OutputContainerGroup getNativeHeaderOutputs()
      Get the output container group for the native header file outputs.

      If you invoke javac with the -H flag, then this represents the directory that C/C++ header file stubs for JNI are written to.

      Returns:
      the output container group, or null if it does not exist.

    • getModuleSourcePath

      default @Nullable ModuleContainerGroup getModuleSourcePath()
      Get the module container group for the module source path.

      Many build tools do not provide a direct equivalent of this mechanism as of now, but this is a source path introduced in Java 9 that allows specifying multiple named JPMS modules to compile under a single compilation invocation.

      For example, you may use this in a project to compile an API module, a default implementation module, and a module containing unit tests all together.

      Returns:
      the module container group, or null if it does not exist.

    • getUpgradeModulePath

      default @Nullable ModuleContainerGroup getUpgradeModulePath()
      Get the module container group for the upgrade module path.

      You generally will not need to use this, as this is a mechanism used to upgrade modules in-place incrementally with fixes without redistributing the entire application.

      Returns:
      the module container group, or null if it does not exist.

    • getSystemModules

      default @Nullable ModuleContainerGroup getSystemModules()
      Get the module container group for all system modules that are part of the JDK distribution.

      This will usually just point to the Java standard library.

      Returns:
      the module container group, or null if it does not exist.

    • getModulePath

      default @Nullable ModuleContainerGroup getModulePath()
      Get the module container group for the module path.

      This is equivalent to the class path, but holds any JPMS modules.

      Returns:
      the module container group, or null if it does not exist.

    • getPatchModulePath

      default @Nullable ModuleContainerGroup getPatchModulePath()
      Get the module container group for the patch module path.

      You generally will not need to use this. It consists of patchable module sources that can be used to inject additional classes into a module. This can be used for cases like unit tests where you wish to embed the unit test classes into the existing application module to exploit features such as package private access.

      Returns:
      the module container group, or null if it does not exist.