Package manifold.preprocessor.definitions

Class Definitions

java.lang.Object

manifold.preprocessor.definitions.Definitions

Direct Known Subclasses:

ServiceDefinitions

public class Definitions
extends Object

Models definitions as a hierarchy of maps. Searches for a definition in leaf-first order where the leaf definitions are controlled by the #define and #undef directives in the compiling source file. Parent definitions correspond with the following:

• build.properties files in the source file's directory ancestry
• Custom compiler arguments provided by the -Akey[=value] javac command line option
• Compiler and JVM environment settings such as Java source version, JPMS mode, operating system, etc.
• Custom service provider implementations of SymbolProvider. See BuildVariantSymbols.

Note the effects of #define and #undef are limited to the file scope. This means #define definitions are not available to other files. Similarly, parent definitions masked with #undef are not affected in other files.

Field Summary

Fields

Modifier and Type	Field	Description
static String	BUILD_PROPERTIES

Constructor Summary

Constructors

Modifier	Constructor	Description
	Definitions(manifold.api.fs.IFile definitionsSource)
protected	Definitions(Definitions root, manifold.api.fs.IFile definitionsSource, Map<String,String> definitions)

Method Summary

Modifier and Type	Method	Description
void	clear()
String	define(String def)	Define def in the source file's local definition space.
String	define(String def, String value)	Define def in the source file's local definition space with value.
boolean	equals(Object o)
protected Definitions	getParent()
protected Definitions	getRoot()
protected manifold.api.fs.IFile	getSourceFile()
String	getValue(String def)
int	hashCode()
boolean	isDefined(String def)
protected Map<String,String>	loadEnvironmentDefinitions()
protected Map<String,String>	loadJavacDefinitions()
protected Definitions	loadParentDefinitions()
protected Definitions	makeBuildPropertiesDefinitions()
String	undef(String def)	Remove def from the File's local definition space.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Field Detail

BUILD_PROPERTIES

public static final String BUILD_PROPERTIES

See Also:

Constant Field Values

Constructor Detail

Definitions

public Definitions(manifold.api.fs.IFile definitionsSource)

Definitions

protected Definitions(Definitions root,
                      manifold.api.fs.IFile definitionsSource,
                      Map<String,String> definitions)

Method Detail

getRoot

protected Definitions getRoot()

getSourceFile

protected manifold.api.fs.IFile getSourceFile()

getParent

protected Definitions getParent()

loadParentDefinitions

protected Definitions loadParentDefinitions()

makeBuildPropertiesDefinitions

protected Definitions makeBuildPropertiesDefinitions()

loadJavacDefinitions

protected Map<String,String> loadJavacDefinitions()

loadEnvironmentDefinitions

protected Map<String,String> loadEnvironmentDefinitions()

clear

public void clear()

isDefined

public boolean isDefined(String def)

Returns:

True if there is a definition having name def, regardless of its value.

getValue

public String getValue(String def)

define

public String define(String def)

Define def in the source file's local definition space.

define

public String define(String def,
                     String value)

Define def in the source file's local definition space with value.

undef

public String undef(String def)

Remove def from the File's local definition space. Note if def is defined in a parent scope e.g., a properties file, it remains defined. In other words #undef applies exclusively to the source file scope.

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object