Package org.aspectj.ajde.core

Interface ICompilerConfiguration

All Superinterfaces:

CompilerConfigurationChangeFlags

public interface ICompilerConfiguration
extends CompilerConfigurationChangeFlags

Interface that contains all the configuration required for the compiler to be able to perform a build

Field Summary

Fields inherited from interface org.aspectj.ajdt.internal.core.builder.CompilerConfigurationChangeFlags

ASPECTPATH_CHANGED, CLASSPATH_CHANGED, EVERYTHING, INJARS_CHANGED, INPATH_CHANGED, JAVAOPTIONS_CHANGED, NO_CHANGES, NONSTANDARDOPTIONS_CHANGED, OUTJAR_CHANGED, OUTPUTDESTINATIONS_CHANGED, PROCESSOR_CHANGED, PROJECTSOURCEFILES_CHANGED, PROJECTSOURCERESOURCES_CHANGED, XMLCONFIG_CHANGED

Method Summary

Modifier and Type	Method	Description
void	configurationRead()	Called by AspectJ once it has processed the configuration object and is ready to do a build.
Set<File>	getAspectPath()
String	getClasspath()
List<String>	getClasspathElementsWithModifiedContents()	Return a List (Strings) of the directory elements on the classpath that are likely to contain modified .class files since the previous build and must be checked.
int	getConfigurationChanges()	Returns a set of bit flags indicating what has changed in the configuration since it was previously read.
Set<File>	getInpath()
Map<String,String>	getJavaOptionsMap()	Returns the table of the current custom java options.
String	getModulepath()
String	getModuleSourcepath()
String	getNonStandardOptions()	The non-standard options, typically prefaced with -X when used with a command line compiler.
String	getOutJar()
IOutputLocationManager	getOutputLocationManager()
String	getProcessor()
String	getProcessorPath()
String	getProjectEncoding()	Return the encoding to use for this project.
List<String>	getProjectSourceFiles()
List<File>	getProjectSourceFilesChanged()	Return a subset of those files we'd get on getProjectSourceFiles() - the subset that have changed since the last build.
List<String>	getProjectXmlConfigFiles()
Map<String,File>	getSourcePathResources()	Get the set of non-Java resources for this compilation.

Method Details

getJavaOptionsMap

Map<String,String> getJavaOptionsMap()

Returns the table of the current custom java options.

For a complete description of the configurable options, see JavaOptions.getDefaultJavaOptions() or IJavaProject.getOptions(boolean)

Returns:

table of current settings of all options (key type: String; value type: String)

See Also:

• or org.aspectj.org.eclipse.jdt.core.IJavaProject#getOptions(boolean)

getNonStandardOptions

String getNonStandardOptions()

The non-standard options, typically prefaced with -X when used with a command line compiler. The default is no non-standard options. Options should be separated by a space, for example "-showWeaveInfo -XnoInline"

getProjectSourceFiles

List<String> getProjectSourceFiles()

Returns:

a list of those files to include in the build

getProjectXmlConfigFiles

List<String> getProjectXmlConfigFiles()

Returns:

a list of those files that should be used to configure a build

getProjectSourceFilesChanged

List<File> getProjectSourceFilesChanged()

Return a subset of those files we'd get on getProjectSourceFiles() - the subset that have changed since the last build. If someone else has already worked out what needs rebuilding, we don't need to do it again by checking all of the projectSourceFiles(). Returning an empty list means nothing has changed, returning null means you have no idea what changed and the compiler should work it out.

Returns:

a subset of those files that would be returned on getProjectSourceFiles() that have actually *changed*

getClasspath

String getClasspath()

getModulepath

String getModulepath()

getModuleSourcepath

String getModuleSourcepath()

getOutputLocationManager

IOutputLocationManager getOutputLocationManager()

Returns:

the IOutputLocationManager associated with this compiler configuration

getInpath

Set<File> getInpath()

Returns:

the set of input path elements for this compilation. Set members should be of the type java.io.File. An empty set or null is acceptable for this option. From -inpath

getOutJar

String getOutJar()

Returns:

the output jar file for the compilation results. Return null to leave classfiles unjar'd in output directory From -outjar

getAspectPath

Set<File> getAspectPath()

Returns:

the set of aspect jar files to be used for the compilation. Returning null or an empty set disables this option. Set members should be of type java.io.File. From -aspectpath

getSourcePathResources

Map<String,File> getSourcePathResources()

Get the set of non-Java resources for this compilation. Set members should be of type java.io.File. An empty set or null is acceptable for this option.

Returns:

map from unique resource name to absolute path to source resource (String to File)

getConfigurationChanges

int getConfigurationChanges()

Returns a set of bit flags indicating what has changed in the configuration since it was previously read. This allows the compiler to avoid repeating computation for values that are the same as before.

Returns:

set of bit flags, see the constants in @link CompilerConfigurationChangeFlags. If unsure return EVERYTHING

configurationRead

void configurationRead()

Called by AspectJ once it has processed the configuration object and is ready to do a build. The configuration object may or may not be interested in this event. It probably will be if it is correctly tracking changes and answering getConfigurationChanges() with something other than EVERYTHING.

getClasspathElementsWithModifiedContents

List<String> getClasspathElementsWithModifiedContents()

Return a List (Strings) of the directory elements on the classpath that are likely to contain modified .class files since the previous build and must be checked. This would be used in the situation where a project has a dependency on another project and the dependency is captured by inclusion of one project on the classpath for the other. When the first project is built, we need to check the classpath element on the second projects classpath that represents the bin folder of the first project. By explicitly returning a list here we can avoid checking EVERYTHING.

Returns:

a list of modified elements that should be checked (can be empty) or null if unknown (and in which case every classpath element will be checked)

getProjectEncoding

String getProjectEncoding()

Return the encoding to use for this project. Return null if the platform default should be used. Example return value "UTF-8"

getProcessor

String getProcessor()

Returns:

the list of processor classes to execute

getProcessorPath

String getProcessorPath()

Returns:

the processor path where the specified processor(s) can be found