Module io.github.ascopes.jct

Package io.github.ascopes.jct.filemanagers

Interface JctFileManager

All Superinterfaces:

AutoCloseable, Closeable, Flushable, JavaFileManager, OptionChecker

@API(since="0.0.1",
     status=STABLE)
public interface JctFileManager
extends JavaFileManager

Extension around a JavaFileManager that allows adding of PathRoot objects to the manager.

Since:

0.0.1

Author:

Ashley Scopes

Nested Class Summary

Nested classes/interfaces inherited from interface javax.tools.JavaFileManager

JavaFileManager.Location

Method Summary

Modifier and Type	Method	Description
void	addPath(JavaFileManager.Location location, PathRoot path)	Add a package-oriented path to a given location.
void	addPaths(JavaFileManager.Location location, Collection<? extends PathRoot> paths)	Add a collection of package-oriented paths to a given location.
void	copyContainers(JavaFileManager.Location from, JavaFileManager.Location to)	Copy all containers from the first location to the second location.
void	createEmptyLocation(JavaFileManager.Location location)	Register an empty container for the given location to indicate to the compiler that the feature exists, but has no configured paths.
String	getEffectiveRelease()	Get the associated effective release.
ModuleContainerGroup	getModuleContainerGroup(JavaFileManager.Location location)	Get the container group for the given module-oriented location.
Collection<ModuleContainerGroup>	getModuleContainerGroups()	Get a collection of all module container impl in this file manager.
OutputContainerGroup	getOutputContainerGroup(JavaFileManager.Location location)	Get the container group for the given output-oriented location.
Collection<OutputContainerGroup>	getOutputContainerGroups()	Get a collection of all output container impl in this file manager.
PackageContainerGroup	getPackageContainerGroup(JavaFileManager.Location location)	Get the container group for the given package-oriented location.
Collection<PackageContainerGroup>	getPackageContainerGroups()	Get a collection of all package container impl in this file manager.
Set<JavaFileObject>	list(JavaFileManager.Location location, String packageName, Set<JavaFileObject.Kind> kinds, boolean recurse)	List all file objects in the given location matching the given criteria.

Methods inherited from interface javax.tools.JavaFileManager

close, contains, flush, getClassLoader, getFileForInput, getFileForOutput, getJavaFileForInput, getJavaFileForOutput, getLocationForModule, getLocationForModule, getServiceLoader, handleOption, hasLocation, inferBinaryName, inferModuleName, isSameFile, listLocationsForModules

Methods inherited from interface javax.tools.OptionChecker

isSupportedOption

Method Details

addPath

void addPath(JavaFileManager.Location location,
 PathRoot path)

Add a package-oriented path to a given location.

To add a module, first obtain the module location using JavaFileManager.getLocationForModule(Location, String), and pass that result to this call.

Parameters:

location - the location to use.

path - the path to add.

See Also:

• JavaFileManager.getLocationForModule(Location, String)

addPaths

void addPaths(JavaFileManager.Location location,
 Collection<? extends PathRoot> paths)

Add a collection of package-oriented paths to a given location.

To add a module, first obtain the module location using JavaFileManager.getLocationForModule(Location, String), and pass that result to this call.

Parameters:

location - the location to use.

paths - the paths to add.

See Also:

• JavaFileManager.getLocationForModule(Location, String)

copyContainers

void copyContainers(JavaFileManager.Location from,
 JavaFileManager.Location to)

Copy all containers from the first location to the second location.

Parameters:

from - the first location.

to - the second location.

createEmptyLocation

void createEmptyLocation(JavaFileManager.Location location)

Register an empty container for the given location to indicate to the compiler that the feature exists, but has no configured paths.

This is needed to coerce the behaviour for annotation processing in some cases.

If the location already exists, then do not do anything.

If the location is an output location, then this operation does not make any sense, since an empty location cannot have files output to it. In this case, you will likely get an exception.

Likewise, this operation does not make sense for module locations within a module-oriented location group, so this operation will fail with an error for those inputs as well.

Parameters:

location - the location to apply an empty container for.

Throws:

IllegalArgumentException - if the location is an output location or a module location.

getEffectiveRelease

String getEffectiveRelease()

Get the associated effective release.

Returns:

the effective release.

Since:

0.0.1 (0.0.1-M8)

getPackageContainerGroup

PackageContainerGroup getPackageContainerGroup(JavaFileManager.Location location)

Get the container group for the given package-oriented location.

Parameters:

location - the package oriented location.

Returns:

the container group, or null if one does not exist.

getPackageContainerGroups

Collection<PackageContainerGroup> getPackageContainerGroups()

Get a collection of all package container impl in this file manager.

Returns:

the package container impl.

getModuleContainerGroup

ModuleContainerGroup getModuleContainerGroup(JavaFileManager.Location location)

Get the container group for the given module-oriented location.

Parameters:

location - the module oriented location.

Returns:

the container group, or null if one does not exist.

getModuleContainerGroups

Collection<ModuleContainerGroup> getModuleContainerGroups()

Get a collection of all module container impl in this file manager.

Returns:

the module container impl.

getOutputContainerGroup

OutputContainerGroup getOutputContainerGroup(JavaFileManager.Location location)

Get the container group for the given output-oriented location.

Parameters:

location - the output oriented location.

Returns:

the container group, or null if one does not exist.

getOutputContainerGroups

Collection<OutputContainerGroup> getOutputContainerGroups()

Get a collection of all output container impl in this file manager.

Returns:

the output container impl.

list

Set<JavaFileObject> list(JavaFileManager.Location location,
 String packageName,
 Set<JavaFileObject.Kind> kinds,
 boolean recurse)
                  throws IOException

List all file objects in the given location matching the given criteria.

Specified by:

list in interface JavaFileManager

Parameters:

location - the location to search in.

packageName - the package name to search in, or "" to search in the root location.

kinds - the kinds of file to return, or Set.of() ( JavaFileObject.Kind.OTHER ) to find all files.

recurse - true to recurse into subpackages, false to only check the current package.

Returns:

a collection of unique file objects that were found.

Throws:

IOException - if an IO error occurs reading the file system.