Module io.github.ascopes.jct

Package io.github.ascopes.jct.compilers

Class AbstractJctCompiler<A extends AbstractJctCompiler<A>>

java.lang.Object

io.github.ascopes.jct.compilers.AbstractJctCompiler<A>

Type Parameters:

A - the type of the class extending this class.

All Implemented Interfaces:

JctCompiler<A,JctCompilation>

@API(since="0.0.1",
     status=STABLE)
public abstract class AbstractJctCompiler<A extends AbstractJctCompiler<A>>
extends Object
implements JctCompiler<A,JctCompilation>

Common functionality for a compiler that can be overridden and that produces a JctCompilationImpl as the compilation result.

Implementations should extend this class and override anything they require. In most cases, you should not need to override anything other than the constructor.

This class is not thread-safe.

If you wish to create a common set of configuration settings for instances of this class, you should consider writing a custom JctCompilerConfigurer object to apply the desired operations, and then apply it to instances of this class using configure(JctCompilerConfigurer).

Since:

0.0.1

Author:

Ashley Scopes

Field Summary

Fields inherited from interface io.github.ascopes.jct.compilers.JctCompiler

DEFAULT_ANNOTATION_PROCESSOR_DISCOVERY, DEFAULT_COMPILATION_MODE, DEFAULT_DIAGNOSTIC_LOGGING_MODE, DEFAULT_FAIL_ON_WARNINGS, DEFAULT_FILE_MANAGER_LOGGING_MODE, DEFAULT_FIX_JVM_MODULE_PATH_MISMATCH, DEFAULT_INHERIT_CLASS_PATH, DEFAULT_INHERIT_MODULE_PATH, DEFAULT_INHERIT_PLATFORM_CLASS_PATH, DEFAULT_INHERIT_SYSTEM_MODULE_PATH, DEFAULT_LOCALE, DEFAULT_LOG_CHARSET, DEFAULT_PREVIEW_FEATURES, DEFAULT_SHOW_DEPRECATION_WARNINGS, DEFAULT_SHOW_WARNINGS, DEFAULT_VERBOSE

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AbstractJctCompiler(String defaultName)	Initialize this compiler.

Method Summary

Modifier and Type	Method	Description
A	addAnnotationProcessorOptions(Iterable<String> annotationProcessorOptions)	Add options to pass to any annotation processors.
A	addAnnotationProcessors(Iterable<? extends Processor> annotationProcessors)	Add annotation processors to invoke.
A	addCompilerOptions(Iterable<String> compilerOptions)	Add command line options to pass to javac.
A	annotationProcessorDiscovery(AnnotationProcessorDiscovery annotationProcessorDiscovery)	Set how to perform annotation processor discovery.
protected List<String>	buildFlags(JctFlagBuilder flagBuilder)	Build the list of flags from this compiler object using the flag builder.
A	compilationMode(CompilationMode compilationMode)	Set the compilation mode to use for this compiler.
JctCompilation	compile(Workspace workspace)	Invoke the compilation and return the compilation result.
JctCompilation	compile(Workspace workspace, Collection<String> classNames)	Invoke the compilation and return the compilation result.
final <E extends Exception> A	configure(JctCompilerConfigurer<E> configurer)	Apply a given configurer to this compiler that can throw a checked exception.
A	diagnosticLoggingMode(LoggingMode diagnosticLoggingMode)	Set how to handle diagnostic capture.
A	failOnWarnings(boolean enabled)	Set whether to enable treating warnings as errors or not.
A	fileManagerLoggingMode(LoggingMode fileManagerLoggingMode)	Set how to handle logging calls to underlying file managers.
A	fixJvmModulePathMismatch(boolean fixJvmModulePathMismatch)	Get whether we will attempt to fix modules appearing on the classpath, or non-modules appearing on the module path.
AnnotationProcessorDiscovery	getAnnotationProcessorDiscovery()	Get how to perform annotation processor discovery.
List<String>	getAnnotationProcessorOptions()	Get an immutable snapshot view of the current annotation processor options that are set.
List<Processor>	getAnnotationProcessors()	Get an immutable snapshot view of the current annotation processors that are explicitly set to be run, in the order that they were provided to the compiler.
JctCompilationFactory	getCompilationFactory()	Get the compilation factory to use for building a compilation.
CompilationMode	getCompilationMode()	Get the compilation mode that is in use.
abstract Jsr199CompilerFactory	getCompilerFactory()	Get the JSR-199 compiler factory to use for initialising an internal compiler.
List<String>	getCompilerOptions()	Get an immutable snapshot view of the current compiler options that are set.
abstract String	getDefaultRelease()	Get the default release to use if no release or target version is specified.
LoggingMode	getDiagnosticLoggingMode()	Get the current diagnostic logging mode.
String	getEffectiveRelease()	Get the effective release to use for the actual compilation.
abstract JctFileManagerFactory	getFileManagerFactory()	Get the file manager factory to use for building a file manager during compilation.
LoggingMode	getFileManagerLoggingMode()	Get the current file manager logging mode.
abstract JctFlagBuilderFactory	getFlagBuilderFactory()	Get the flag builder factory to use for building flags.
Locale	getLocale()	Get the output locale.
Charset	getLogCharset()	Get the charset being used to write compiler logs with.
String	getName()	Get the friendly printable name of this compiler object.
String	getRelease()	Get the current release version that is set, or null if left to the compiler to decide.
String	getSource()	Get the current source version that is set, or null if left to the compiler to decide.
String	getTarget()	Get the current target version that is set, or null if left to the compiler default.
A	inheritClassPath(boolean inheritClassPath)	Set whether the class path is inherited from the caller JVM or not.
A	inheritModulePath(boolean inheritModulePath)	Set whether the module path is inherited from the caller JVM or not.
A	inheritPlatformClassPath(boolean inheritPlatformClassPath)	Set whether the current platform class path is being inherited from the caller JVM or not.
A	inheritSystemModulePath(boolean inheritSystemModulePath)	Set whether the system module path is inherited from the caller JVM or not.
boolean	isFailOnWarnings()	Determine whether warnings are being treated as errors or not.
boolean	isFixJvmModulePathMismatch()	Get whether we will attempt to fix modules appearing on the classpath, or non-modules appearing on the module path.
boolean	isInheritClassPath()	Get whether the class path is inherited from the caller JVM or not.
boolean	isInheritModulePath()	Get whether the module path is inherited from the caller JVM or not.
boolean	isInheritPlatformClassPath()	Get whether the current platform class path is being inherited from the caller JVM or not.
boolean	isInheritSystemModulePath()	Get whether the system module path is inherited from the caller JVM or not.
boolean	isPreviewFeatures()	Determine whether preview features are enabled or not.
boolean	isShowDeprecationWarnings()	Determine whether deprecation warnings are enabled or not.
boolean	isShowWarnings()	Determine whether warnings are enabled or not.
boolean	isVerbose()	Determine whether verbose logging is enabled or not.
A	locale(Locale locale)	Set the output locale.
A	logCharset(Charset logCharset)	Set the charset being used to write compiler logs with.
protected final A	myself()	Get this implementation of AbstractJctCompiler, cast to the type parameter AbstractJctCompiler.
A	name(String name)	Set the friendly name of this compiler.
A	previewFeatures(boolean enabled)	Set whether to enable preview features or not.
A	release(@Nullable String release)	Set the release version.
A	showDeprecationWarnings(boolean enabled)	Set whether to enable deprecation warnings or not.
A	showWarnings(boolean enabled)	Set whether to enable displaying warnings or not.
A	source(@Nullable String source)	Set the source version.
A	target(@Nullable String target)	Set the target version.
final String	toString()	Deprecated. Use getName() instead.
A	verbose(boolean enabled)	Set whether to use verbose output or not.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface io.github.ascopes.jct.compilers.JctCompiler

addAnnotationProcessorOptions, addAnnotationProcessors, addCompilerOptions, compile, release, release, source, source, target, target

Constructor Details

AbstractJctCompiler

protected AbstractJctCompiler(String defaultName)

Initialize this compiler.

Parameters:

defaultName - the printable default name to use for the compiler.

Method Details

compile

public JctCompilation compile(Workspace workspace)

Description copied from interface: JctCompiler

Invoke the compilation and return the compilation result.

The actual classes to compile will be dynamically discovered. If you wish to specify the specific classes to compile, see JctCompiler.compile(Workspace, String, String...) or JctCompiler.compile(Workspace, Collection).

Specified by:

compile in interface JctCompiler<A extends AbstractJctCompiler<A>,JctCompilation>

Parameters:

workspace - the workspace to compile.

Returns:

the compilation result.

See Also:

• JctCompiler.compile(Workspace, String, String...)
• JctCompiler.compile(Workspace, Collection)

compile

public JctCompilation compile(Workspace workspace,
 Collection<String> classNames)

Description copied from interface: JctCompiler

Invoke the compilation and return the compilation result.

Only classes matching the given class names will be compiled.

If you wish to let JCT determine which classes to compile dynamically, see JctCompiler.compile(Workspace) instead.

Specified by:

compile in interface JctCompiler<A extends AbstractJctCompiler<A>,JctCompilation>

Parameters:

workspace - the workspace to compile.

classNames - the class names to compile.

Returns:

the compilation result.

See Also:

• JctCompiler.compile(Workspace)
• JctCompiler.compile(Workspace, String, String...)

configure

public final <E extends Exception> A configure(JctCompilerConfigurer<E> configurer)
                                        throws E

Description copied from interface: JctCompiler

Apply a given configurer to this compiler that can throw a checked exception.

Specified by:

configure in interface JctCompiler<A extends AbstractJctCompiler<A>,JctCompilation>

Type Parameters:

E - any exception that may be thrown.

Parameters:

configurer - the configurer to invoke.

Returns:

this compiler object for further call chaining.

Throws:

E - any exception that may be thrown by the configurer.

getName

public String getName()

Description copied from interface: JctCompiler

Get the friendly printable name of this compiler object.

Specified by:

getName in interface JctCompiler<A extends AbstractJctCompiler<A>,JctCompilation>

Returns:

the name of the compiler.

name

public A name(String name)

Description copied from interface: JctCompiler

Set the friendly name of this compiler.

Specified by:

name in interface JctCompiler<A extends AbstractJctCompiler<A>,JctCompilation>

Parameters:

name - the name to set.

Returns:

this compiler object for further call chaining.

isVerbose

public boolean isVerbose()

Description copied from interface: JctCompiler

Determine whether verbose logging is enabled or not.

Unless otherwise changed or specified, implementations should default to JctCompiler.DEFAULT_VERBOSE.

Note that enabling this is compiler-specific behaviour. There is no guarantee that the output target or the format or verbosity of output will be consistent between different compiler implementations.

Specified by:

isVerbose in interface JctCompiler<A extends AbstractJctCompiler<A>,JctCompilation>

Returns:

whether verbose logging is enabled or not.

verbose

public A verbose(boolean enabled)

Description copied from interface: JctCompiler

Set whether to use verbose output or not.

Unless otherwise changed or specified, implementations should default to JctCompiler.DEFAULT_VERBOSE.

Note that enabling this is compiler-specific behaviour. There is no guarantee that the output target or the format or verbosity of output will be consistent between different compiler implementations.

Specified by:

verbose in interface JctCompiler<A extends AbstractJctCompiler<A>,JctCompilation>

Parameters:

enabled - true for verbose output, false for normal output.

Returns:

this compiler for further call chaining.

isPreviewFeatures

public boolean isPreviewFeatures()

Description copied from interface: JctCompiler

Determine whether preview features are enabled or not.

Unless otherwise changed or specified, implementations should default to JctCompiler.DEFAULT_PREVIEW_FEATURES.

Specified by:

isPreviewFeatures in interface JctCompiler<A extends AbstractJctCompiler<A>,JctCompilation>

Returns:

whether preview features are enabled or not.

previewFeatures

public A previewFeatures(boolean enabled)

Description copied from interface: JctCompiler

Set whether to enable preview features or not.

Unless otherwise changed or specified, implementations should default to JctCompiler.DEFAULT_PREVIEW_FEATURES.

Specified by:

previewFeatures in interface JctCompiler<A extends AbstractJctCompiler<A>,JctCompilation>

Parameters:

enabled - true to enable preview features, or false to disable them.

Returns:

this compiler object for further call chaining.

isShowWarnings

public boolean isShowWarnings()

Description copied from interface: JctCompiler

Determine whether warnings are enabled or not.

Unless otherwise changed or specified, implementations should default to JctCompiler.DEFAULT_SHOW_WARNINGS.

Specified by:

isShowWarnings in interface JctCompiler<A extends AbstractJctCompiler<A>,JctCompilation>

Returns:

whether warnings are enabled or not.

showWarnings

public A showWarnings(boolean enabled)

Description copied from interface: JctCompiler

Set whether to enable displaying warnings or not.

Unless otherwise changed or specified, implementations should default to JctCompiler.DEFAULT_SHOW_WARNINGS.

Specified by:

showWarnings in interface JctCompiler<A extends AbstractJctCompiler<A>,JctCompilation>

Parameters:

enabled - true to enable warnings. false to disable them.

Returns:

this compiler object for further call chaining.

isShowDeprecationWarnings

public boolean isShowDeprecationWarnings()

Description copied from interface: JctCompiler

Determine whether deprecation warnings are enabled or not.

Unless otherwise changed or specified, implementations should default to JctCompiler.DEFAULT_SHOW_DEPRECATION_WARNINGS.

Specified by:

isShowDeprecationWarnings in interface JctCompiler<A extends AbstractJctCompiler<A>,JctCompilation>

Returns:

whether deprecation warnings are enabled or not.

showDeprecationWarnings

public A showDeprecationWarnings(boolean enabled)

Description copied from interface: JctCompiler

Set whether to enable deprecation warnings or not.

This is ignored if JctCompiler.showWarnings(boolean) is disabled.

Unless otherwise changed or specified, implementations should default to JctCompiler.DEFAULT_SHOW_DEPRECATION_WARNINGS.

Specified by:

showDeprecationWarnings in interface JctCompiler<A extends AbstractJctCompiler<A>,JctCompilation>

Parameters:

enabled - true to enable deprecation warnings. false to disable them.

Returns:

this compiler object for further call chaining.

isFailOnWarnings

public boolean isFailOnWarnings()

Description copied from interface: JctCompiler

Determine whether warnings are being treated as errors or not.

Unless otherwise changed or specified, implementations should default to JctCompiler.DEFAULT_FAIL_ON_WARNINGS.

Specified by:

isFailOnWarnings in interface JctCompiler<A extends AbstractJctCompiler<A>,JctCompilation>

Returns:

whether warnings are being treated as errors or not.

failOnWarnings

public A failOnWarnings(boolean enabled)

Description copied from interface: JctCompiler

Set whether to enable treating warnings as errors or not.

This is ignored if JctCompiler.showWarnings(boolean) is disabled.

Unless otherwise changed or specified, implementations should default to JctCompiler.DEFAULT_FAIL_ON_WARNINGS.

Specified by:

failOnWarnings in interface JctCompiler<A extends AbstractJctCompiler<A>,JctCompilation>

Parameters:

enabled - true to enable treating warnings as errors. false to disable them.

Returns:

this compiler object for further call chaining.

getCompilationMode

public CompilationMode getCompilationMode()

Description copied from interface: JctCompiler

Get the compilation mode that is in use.

Unless otherwise changed or specified, implementations should default to JctCompiler.DEFAULT_COMPILATION_MODE.

Specified by:

getCompilationMode in interface JctCompiler<A extends AbstractJctCompiler<A>,JctCompilation>

Returns:

the compilation mode.

compilationMode

public A compilationMode(CompilationMode compilationMode)

Description copied from interface: JctCompiler

Set the compilation mode to use for this compiler.

Unless otherwise changed or specified, implementations should default to JctCompiler.DEFAULT_COMPILATION_MODE.

Specified by:

compilationMode in interface JctCompiler<A extends AbstractJctCompiler<A>,JctCompilation>

Parameters:

compilationMode - the compilation mode to use.

Returns:

this compiler object for further call chaining.

getAnnotationProcessorOptions

public List<String> getAnnotationProcessorOptions()

Description copied from interface: JctCompiler

Get an immutable snapshot view of the current annotation processor options that are set.

Specified by:

getAnnotationProcessorOptions in interface JctCompiler<A extends AbstractJctCompiler<A>,JctCompilation>

Returns:

the current annotation processor options that are set.

addAnnotationProcessorOptions

public A addAnnotationProcessorOptions(Iterable<String> annotationProcessorOptions)

Description copied from interface: JctCompiler

Add options to pass to any annotation processors.

Specified by:

addAnnotationProcessorOptions in interface JctCompiler<A extends AbstractJctCompiler<A>,JctCompilation>

Parameters:

annotationProcessorOptions - the options to pass.

Returns:

this compiler object for further call chaining.

getAnnotationProcessors

public List<Processor> getAnnotationProcessors()

Description copied from interface: JctCompiler

Get an immutable snapshot view of the current annotation processors that are explicitly set to be run, in the order that they were provided to the compiler.

Specified by:

getAnnotationProcessors in interface JctCompiler<A extends AbstractJctCompiler<A>,JctCompilation>

Returns:

the current annotation processors that are set.

addAnnotationProcessors

public A addAnnotationProcessors(Iterable<? extends Processor> annotationProcessors)

Description copied from interface: JctCompiler

Add annotation processors to invoke.

This bypasses the discovery process of annotation processors provided in the annotation processor path.

Specified by:

addAnnotationProcessors in interface JctCompiler<A extends AbstractJctCompiler<A>,JctCompilation>

Parameters:

annotationProcessors - the processors to invoke.

Returns:

this compiler object for further call chaining.

getCompilerOptions

public List<String> getCompilerOptions()

Description copied from interface: JctCompiler

Get an immutable snapshot view of the current compiler options that are set.

Specified by:

getCompilerOptions in interface JctCompiler<A extends AbstractJctCompiler<A>,JctCompilation>

Returns:

the current compiler options that are set.

addCompilerOptions

public A addCompilerOptions(Iterable<String> compilerOptions)

Description copied from interface: JctCompiler

Add command line options to pass to javac.

Specified by:

addCompilerOptions in interface JctCompiler<A extends AbstractJctCompiler<A>,JctCompilation>

Parameters:

compilerOptions - the options to add.

Returns:

this compiler object for further call chaining.

getEffectiveRelease

public String getEffectiveRelease()

Description copied from interface: JctCompiler

Get the effective release to use for the actual compilation.

This may be determined from the source, target, release, and default release.

Specified by:

getEffectiveRelease in interface JctCompiler<A extends AbstractJctCompiler<A>,JctCompilation>

Returns:

the effective release.

getRelease

public String getRelease()

Description copied from interface: JctCompiler

Get the current release version that is set, or null if left to the compiler to decide. default.

Unless explicitly defined, the default setting is expected to be a sane compiler-specific default.

Specified by:

getRelease in interface JctCompiler<A extends AbstractJctCompiler<A>,JctCompilation>

Returns:

the release version string, if set.

release

public A release(@Nullable String release)

Description copied from interface: JctCompiler

Set the release version.

This will clear any source and target version that is set.

Unless explicitly defined, the default setting is expected to be a sane compiler-specific default.

Specified by:

release in interface JctCompiler<A extends AbstractJctCompiler<A>,JctCompilation>

Parameters:

release - the version to set.

Returns:

this compiler object for further call chaining.

getSource

public String getSource()

Description copied from interface: JctCompiler

Get the current source version that is set, or null if left to the compiler to decide. default.

Unless explicitly defined, the default setting is expected to be a sane compiler-specific default.

Specified by:

getSource in interface JctCompiler<A extends AbstractJctCompiler<A>,JctCompilation>

Returns:

the source version string, if set.

source

public A source(@Nullable String source)

Description copied from interface: JctCompiler

Set the source version.

This will clear any release version that is set.

Unless explicitly defined, the default setting is expected to be a sane compiler-specific default.

Specified by:

source in interface JctCompiler<A extends AbstractJctCompiler<A>,JctCompilation>

Parameters:

source - the version to set.

Returns:

this compiler object for further call chaining.

getTarget

public String getTarget()

Description copied from interface: JctCompiler

Get the current target version that is set, or null if left to the compiler default.

Unless explicitly defined, the default setting is expected to be a sane compiler-specific default.

Specified by:

getTarget in interface JctCompiler<A extends AbstractJctCompiler<A>,JctCompilation>

Returns:

the target version string, if set.

target

public A target(@Nullable String target)

Description copied from interface: JctCompiler

Set the target version.

This will clear any release version that is set.

Unless explicitly defined, the default setting is expected to be a sane compiler-specific default.

Specified by:

target in interface JctCompiler<A extends AbstractJctCompiler<A>,JctCompilation>

Parameters:

target - the version to set.

Returns:

this compiler object for further call chaining.

isFixJvmModulePathMismatch

public boolean isFixJvmModulePathMismatch()

Description copied from interface: JctCompiler

Get whether we will attempt to fix modules appearing on the classpath, or non-modules appearing on the module path.

This enables correct classpath and module path detection when the test pack is a module but the code being compiled in the test is not, and vice versa. We need this because many build systems decide whether to populate the --module-path flat or the --classpath with JPMS-enabled dependencies based on whether the project under compilation is a JPMS module itself.

This only applies if JctCompiler.isInheritModulePath() or JctCompiler.isInheritClassPath() is enabled, and only applies to the current JVM classpath and module path.

Unless otherwise changed or specified, implementations should default to JctCompiler.DEFAULT_FIX_JVM_MODULE_PATH_MISMATCH.

Specified by:

isFixJvmModulePathMismatch in interface JctCompiler<A extends AbstractJctCompiler<A>,JctCompilation>

Returns:

true if enabled, or false if disabled.

fixJvmModulePathMismatch

public A fixJvmModulePathMismatch(boolean fixJvmModulePathMismatch)

Description copied from interface: JctCompiler

Get whether we will attempt to fix modules appearing on the classpath, or non-modules appearing on the module path.

Unless otherwise changed or specified, implementations should default to JctCompiler.DEFAULT_FIX_JVM_MODULE_PATH_MISMATCH.

Specified by:

fixJvmModulePathMismatch in interface JctCompiler<A extends AbstractJctCompiler<A>,JctCompilation>

Parameters:

fixJvmModulePathMismatch - whether to enable the mismatch fixing or not.

Returns:

this compiler object for further call chaining.

isInheritClassPath

public boolean isInheritClassPath()

Description copied from interface: JctCompiler

Get whether the class path is inherited from the caller JVM or not.

Unless otherwise changed or specified, implementations should default to JctCompiler.DEFAULT_INHERIT_CLASS_PATH.

Specified by:

isInheritClassPath in interface JctCompiler<A extends AbstractJctCompiler<A>,JctCompilation>

Returns:

whether the current class path is being inherited or not.

inheritClassPath

public A inheritClassPath(boolean inheritClassPath)

Description copied from interface: JctCompiler

Set whether the class path is inherited from the caller JVM or not.

Unless otherwise changed or specified, implementations should default to JctCompiler.DEFAULT_INHERIT_CLASS_PATH.

Specified by:

inheritClassPath in interface JctCompiler<A extends AbstractJctCompiler<A>,JctCompilation>

Parameters:

inheritClassPath - true to include it, or false to exclude it.

Returns:

this compiler object for further call chaining.

isInheritModulePath

public boolean isInheritModulePath()

Description copied from interface: JctCompiler

Get whether the module path is inherited from the caller JVM or not.

Unless otherwise changed or specified, implementations should default to JctCompiler.DEFAULT_INHERIT_MODULE_PATH.

Specified by:

isInheritModulePath in interface JctCompiler<A extends AbstractJctCompiler<A>,JctCompilation>

Returns:

whether the module path is being inherited or not.

inheritModulePath

public A inheritModulePath(boolean inheritModulePath)

Description copied from interface: JctCompiler

Set whether the module path is inherited from the caller JVM or not.

Unless otherwise changed or specified, implementations should default to JctCompiler.DEFAULT_INHERIT_MODULE_PATH.

Specified by:

inheritModulePath in interface JctCompiler<A extends AbstractJctCompiler<A>,JctCompilation>

Parameters:

inheritModulePath - true to include it, or false to exclude it.

Returns:

this compiler object for further call chaining.

isInheritPlatformClassPath

public boolean isInheritPlatformClassPath()

Description copied from interface: JctCompiler

Get whether the current platform class path is being inherited from the caller JVM or not.

This may also be known as the "bootstrap class path".

Default environments probably will not provide this functionality, in which case it will be ignored.

Unless otherwise changed or specified, implementations should default to JctCompiler.DEFAULT_INHERIT_PLATFORM_CLASS_PATH.

Specified by:

isInheritPlatformClassPath in interface JctCompiler<A extends AbstractJctCompiler<A>,JctCompilation>

Returns:

whether the platform class path is being inherited or not.

inheritPlatformClassPath

public A inheritPlatformClassPath(boolean inheritPlatformClassPath)

Description copied from interface: JctCompiler

Set whether the current platform class path is being inherited from the caller JVM or not.

This may also be known as the "bootstrap class path".

Default environments probably will not provide this functionality, in which case it will be ignored.

Specified by:

inheritPlatformClassPath in interface JctCompiler<A extends AbstractJctCompiler<A>,JctCompilation>

Parameters:

inheritPlatformClassPath - true to include it, or false to exclude it.

Returns:

this compiler object for further call chaining.

isInheritSystemModulePath

public boolean isInheritSystemModulePath()

Description copied from interface: JctCompiler

Get whether the system module path is inherited from the caller JVM or not.

Unless otherwise changed or specified, implementations should default to JctCompiler.DEFAULT_INHERIT_SYSTEM_MODULE_PATH.

Specified by:

isInheritSystemModulePath in interface JctCompiler<A extends AbstractJctCompiler<A>,JctCompilation>

Returns:

whether the system module path is being inherited or not.

inheritSystemModulePath

public A inheritSystemModulePath(boolean inheritSystemModulePath)

Description copied from interface: JctCompiler

Set whether the system module path is inherited from the caller JVM or not.

Unless otherwise changed or specified, implementations should default to JctCompiler.DEFAULT_INHERIT_SYSTEM_MODULE_PATH.

Specified by:

inheritSystemModulePath in interface JctCompiler<A extends AbstractJctCompiler<A>,JctCompilation>

Parameters:

inheritSystemModulePath - true to include it, or false to exclude it.

Returns:

this compiler object for further call chaining.

getLocale

public Locale getLocale()

Description copied from interface: JctCompiler

Get the output locale.

Unless otherwise changed or specified, implementations should default to JctCompiler.DEFAULT_LOCALE.

Specified by:

getLocale in interface JctCompiler<A extends AbstractJctCompiler<A>,JctCompilation>

Returns:

the output locale to use.

locale

public A locale(Locale locale)

Description copied from interface: JctCompiler

Set the output locale.

Unless otherwise changed or specified, implementations should default to JctCompiler.DEFAULT_LOCALE.

Specified by:

locale in interface JctCompiler<A extends AbstractJctCompiler<A>,JctCompilation>

Parameters:

locale - the locale to use.

Returns:

this compiler for further call chaining.

getLogCharset

public Charset getLogCharset()

Description copied from interface: JctCompiler

Get the charset being used to write compiler logs with.

Unless otherwise changed or specified, implementations should default to JctCompiler.DEFAULT_LOG_CHARSET.

Specified by:

getLogCharset in interface JctCompiler<A extends AbstractJctCompiler<A>,JctCompilation>

Returns:

the charset.

logCharset

public A logCharset(Charset logCharset)

Description copied from interface: JctCompiler

Set the charset being used to write compiler logs with.

Unless otherwise changed or specified, implementations should default to JctCompiler.DEFAULT_LOG_CHARSET.

Specified by:

logCharset in interface JctCompiler<A extends AbstractJctCompiler<A>,JctCompilation>

Parameters:

logCharset - the charset to use.

Returns:

this compiler for further call chaining.

getFileManagerLoggingMode

public LoggingMode getFileManagerLoggingMode()

Description copied from interface: JctCompiler

Get the current file manager logging mode.

Unless otherwise changed or specified, implementations should default to JctCompiler.DEFAULT_FILE_MANAGER_LOGGING_MODE.

Specified by:

getFileManagerLoggingMode in interface JctCompiler<A extends AbstractJctCompiler<A>,JctCompilation>

Returns:

the current file manager logging mode.

fileManagerLoggingMode

public A fileManagerLoggingMode(LoggingMode fileManagerLoggingMode)

Description copied from interface: JctCompiler

Set how to handle logging calls to underlying file managers.

Unless otherwise changed or specified, implementations should default to JctCompiler.DEFAULT_FILE_MANAGER_LOGGING_MODE.

Specified by:

fileManagerLoggingMode in interface JctCompiler<A extends AbstractJctCompiler<A>,JctCompilation>

Parameters:

fileManagerLoggingMode - the mode to use for file manager logging.

Returns:

this compiler for further call chaining.

getDiagnosticLoggingMode

public LoggingMode getDiagnosticLoggingMode()

Description copied from interface: JctCompiler

Get the current diagnostic logging mode.

Unless otherwise changed or specified, implementations should default to JctCompiler.DEFAULT_DIAGNOSTIC_LOGGING_MODE.

Specified by:

getDiagnosticLoggingMode in interface JctCompiler<A extends AbstractJctCompiler<A>,JctCompilation>

Returns:

the current diagnostic logging mode.

diagnosticLoggingMode

public A diagnosticLoggingMode(LoggingMode diagnosticLoggingMode)

Description copied from interface: JctCompiler

Set how to handle diagnostic capture.

Unless otherwise changed or specified, implementations should default to JctCompiler.DEFAULT_DIAGNOSTIC_LOGGING_MODE.

Specified by:

diagnosticLoggingMode in interface JctCompiler<A extends AbstractJctCompiler<A>,JctCompilation>

Parameters:

diagnosticLoggingMode - the mode to use for diagnostic capture.

Returns:

this compiler for further call chaining.

getAnnotationProcessorDiscovery

public AnnotationProcessorDiscovery getAnnotationProcessorDiscovery()

Description copied from interface: JctCompiler

Get how to perform annotation processor discovery.

Unless otherwise changed or specified, implementations should default to JctCompiler.DEFAULT_ANNOTATION_PROCESSOR_DISCOVERY.

Specifying any annotation processors explicitly with JctCompiler.addAnnotationProcessors(Iterable) or JctCompiler.addAnnotationProcessors(Processor, Processor...) will bypass this setting, treating it as being disabled.

Specified by:

getAnnotationProcessorDiscovery in interface JctCompiler<A extends AbstractJctCompiler<A>,JctCompilation>

Returns:

the processor discovery mode to use.

annotationProcessorDiscovery

public A annotationProcessorDiscovery(AnnotationProcessorDiscovery annotationProcessorDiscovery)

Description copied from interface: JctCompiler

Set how to perform annotation processor discovery.

Unless otherwise changed or specified, implementations should default to JctCompiler.DEFAULT_ANNOTATION_PROCESSOR_DISCOVERY.

Specifying any annotation processors explicitly with JctCompiler.addAnnotationProcessors(Iterable) or JctCompiler.addAnnotationProcessors(Processor, Processor...) will bypass this setting, treating it as being disabled.

Specified by:

annotationProcessorDiscovery in interface JctCompiler<A extends AbstractJctCompiler<A>,JctCompilation>

Parameters:

annotationProcessorDiscovery - the processor discovery mode to use.

Returns:

this compiler for further call chaining.

toString

@Deprecated
public final String toString()

Deprecated.

Use getName() instead.

Get the compiler name.

Overrides:

toString in class Object

Returns:

the compiler name.

See Also:

• getName()
• name(String)

getFlagBuilderFactory

public abstract JctFlagBuilderFactory getFlagBuilderFactory()

Get the flag builder factory to use for building flags.

Returns:

the factory.

getCompilerFactory

public abstract Jsr199CompilerFactory getCompilerFactory()

Get the JSR-199 compiler factory to use for initialising an internal compiler.

Returns:

the factory.

getFileManagerFactory

public abstract JctFileManagerFactory getFileManagerFactory()

Get the file manager factory to use for building a file manager during compilation.

Returns:

the factory.

getCompilationFactory

public JctCompilationFactory getCompilationFactory()

Get the compilation factory to use for building a compilation.

By default, this uses a common internal implementation that is designed to work with compilers that have interfaces the same as, and behave the same as Javac.

Some obscure compiler implementations with potentially satanic rituals for initialising and configuring components correctly may need to provide a custom implementation here instead. In this case, this method should be overridden.

Returns:

the compilation factory.

getDefaultRelease

public abstract String getDefaultRelease()

Get the default release to use if no release or target version is specified.

This can not be configured.

Specified by:

getDefaultRelease in interface JctCompiler<A extends AbstractJctCompiler<A>,JctCompilation>

Returns:

the default release version to use when no version is specified by the user.

myself

protected final A myself()

Get this implementation of AbstractJctCompiler, cast to the type parameter AbstractJctCompiler.

Returns:

this implementation of AbstractJctCompiler, cast to AbstractJctCompiler.

buildFlags

protected List<String> buildFlags(JctFlagBuilder flagBuilder)

Build the list of flags from this compiler object using the flag builder.

Implementations should not need to override this unless there is a special edge case that needs configuring differently. This is exposed to assist in these kinds of cases.

Parameters:

flagBuilder - the flag builder to apply the flag configuration to.

Returns:

the string flags to use.