org.aspectj.tools.ant.taskdefs
Class AjcTask

java.lang.Object
  org.apache.tools.ant.ProjectComponent
      org.apache.tools.ant.Task
          org.apache.tools.ant.taskdefs.MatchingTask
              org.aspectj.tools.ant.taskdefs.AjcTask

All Implemented Interfaces:

org.apache.tools.ant.types.selectors.SelectorContainer

public class AjcTask
extends org.apache.tools.ant.taskdefs.MatchingTask

This runs the AspectJ 1.1 compiler, supporting all the command-line options. In 1.1.1, ajc copies resources from input jars, but you can copy resources from the source directories using sourceRootCopyFilter. When not forking, things will be copied as needed for each iterative compile, but when forking things are only copied at the completion of a successful compile.

See the development environment guide for usage documentation.

Since:

AspectJ 1.1, Ant 1.5

Nested Class Summary

static class

AjcTask.GuardedCommand Commandline wrapper that only permits addition of non-empty values and converts to argfile form if necessary.

Field Summary

static java.lang.String

COMMAND_EDITOR_NAME

Constructor Summary

AjcTask()

Method Summary

org.apache.tools.ant.types.Path	createArgfiles()
org.apache.tools.ant.types.Path	createAspectpath()
org.apache.tools.ant.types.Path	createBootclasspath()
org.apache.tools.ant.types.Path	createClasspath()
org.apache.tools.ant.types.Path	createExtdirs()
org.apache.tools.ant.types.Path	createForkclasspath()
org.apache.tools.ant.types.Path	createInjars()
org.apache.tools.ant.types.Path	createInpath()
org.apache.tools.ant.types.Path	createInxml()
org.apache.tools.ant.types.Commandline.Argument	createJvmarg() support for nested <jvmarg> elements
org.apache.tools.ant.types.Path	createSourceRoots()
org.apache.tools.ant.types.Path	createSrc()
org.apache.tools.ant.types.Path	createSrcdir()
void	execute() Compile using ajc per settings.
static java.io.File	findAspectjtoolsJar() Find aspectjtools.jar on the task or system classpath.
boolean	isForked()
boolean	isInIncrementalFileMode()
boolean	isInIncrementalMode()
boolean	quit() Halt processing.
void	readArguments(java.lang.String[] args) Read arguments in as if from a command line, mainly to support compiler adapter compilerarg subelement.
void	reset() to use this same Task more than once (testing)
void	setArgfiles(org.apache.tools.ant.types.Path path)
void	setArgfilesref(org.apache.tools.ant.types.Reference ref)
void	setAspectpath(org.apache.tools.ant.types.Path path)
void	setAspectpathref(org.apache.tools.ant.types.Reference ref)
void	setBootclasspath(org.apache.tools.ant.types.Path path)
void	setBootclasspathref(org.apache.tools.ant.types.Reference bootclasspathref)
void	setCheckRuntimeVersion(boolean b)
void	setClasspath(org.apache.tools.ant.types.Path path)
void	setClasspathref(org.apache.tools.ant.types.Reference classpathref)
void	setCommandEditor(ICommandEditor editor) direct API for testing
void	setCommandEditorClass(java.lang.String className) Setup command-line filter.
void	setCompliance(java.lang.String input) Language compliance level.
void	setCopyInjars(boolean doCopy) Flag to copy all non-.class contents of injars to outjar after compile completes.
void	setCrossrefs(boolean on)
void	setDebug(boolean debug)
void	setDebugLevel(java.lang.String level)
void	setDeprecation(boolean deprecation)
void	setDestdir(java.io.File dir)
void	setEmacssym(boolean emacssym)
void	setEncoding(java.lang.String encoding)
void	setExtdirs(org.apache.tools.ant.types.Path path)
void	setExtdirsref(org.apache.tools.ant.types.Reference ref)
void	setFailonerror(boolean failonerror)
void	setFork(boolean fork)
void	setForkclasspath(org.apache.tools.ant.types.Path path)
void	setForkclasspathref(org.apache.tools.ant.types.Reference forkclasspathref)
void	setHelp(boolean help)
void	setIncremental(boolean incremental)
void	setInjars(org.apache.tools.ant.types.Path path)
void	setInjarsref(org.apache.tools.ant.types.Reference ref)
void	setInpath(org.apache.tools.ant.types.Path path)
void	setInpathDirCopyFilter(java.lang.String filter) Option to copy all files from all inpath directories except the files specified here.
void	setInpathref(org.apache.tools.ant.types.Reference ref)
void	setInxml(org.apache.tools.ant.types.Path path)
void	setInxmlref(org.apache.tools.ant.types.Reference ref)
void	setListFileArgs(boolean listFileArgs)
void	setLog(java.io.File file)
void	setLogCommand(boolean logCommand)
void	setMaxmem(java.lang.String maxMem)
void	setMessageHolder(IMessageHolder holder) direct API for testing
void	setMessageHolderClass(java.lang.String className) Setup custom message handling.
void	setNoExit(boolean noExit)
void	setNoImportError(boolean noImportError)
void	setNowarn(boolean nowarn)
void	setNoWeave(boolean b)
void	setOutjar(java.io.File file)
void	setOutxml(boolean outxml)
void	setOutxmlfile(java.lang.String name)
void	setPreserveAllLocals(boolean preserveAllLocals)
void	setProceedOnError(boolean proceedOnError)
void	setReferenceInfo(boolean referenceInfo)
void	setShowWeaveInfo(boolean showweaveinfo)
void	setSource(java.lang.String input) Source compliance level.
void	setSourceRootCopyFilter(java.lang.String filter) Option to copy all files from all source root directories except those specified here.
void	setSourceRoots(org.apache.tools.ant.types.Path roots)
void	setSourcerootsref(org.apache.tools.ant.types.Reference ref)
void	setSrcDir(org.apache.tools.ant.types.Path path)
void	setTagFile(java.io.File file)
void	setTarget(java.lang.String input)
void	setTime(boolean time)
void	setTimers(boolean timers)
java.lang.String	setupAjc(org.apache.tools.ant.taskdefs.Javac javac) This method extracts javac arguments to ajc, and add arguments to make ajc behave more like javac in copying resources.
void	setVerbose(boolean verbose)
void	setVersion(boolean version)
void	setWarn(java.lang.String warnings)
void	setX(java.lang.String input)
void	setXaddSerialVersionUID(boolean addUID)
void	setXDoneSignal(java.lang.String doneSignal)
void	setXJoinpoints(java.lang.String optionalJoinpoints)
void	setXlint(java.lang.String xlint) -Xlint:{error|warning|info} - set default level for -Xlint messages
void	setXlintfile(java.io.File xlintFile) -Xlintfile {lint.properties} - enable or disable specific forms of -Xlint messages based on a lint properties file (default is org/aspectj/weaver/XLintDefault.properties)
void	setXlintwarnings(boolean xlintwarnings) -Xlint - set default level of -Xlint messages to warning (same as -Xlint:warning)
void	setXmlConfigured(boolean xmlConfigured)
void	setXNoInline(boolean noInline)
void	setXNotReweavable(boolean notReweavable)
void	setXNoWeave(boolean b)
void	setXReweavable(boolean reweavable)
void	setXTerminateAfterCompilation(boolean b)
void	setXWeaveDir(java.io.File file)

Methods inherited from class org.apache.tools.ant.taskdefs.MatchingTask

add, addAnd, addContains, addContainsRegexp, addCustom, addDate, addDepend, addDepth, addDifferent, addFilename, addMajority, addModified, addNone, addNot, addOr, addPresent, addSelector, addSize, addType, appendSelector, createExclude, createExcludesFile, createInclude, createIncludesFile, createPatternSet, getSelectors, hasSelectors, selectorCount, selectorElements, setCaseSensitive, setDefaultexcludes, setExcludes, setExcludesfile, setFollowSymlinks, setIncludes, setIncludesfile, setProject, XsetIgnore, XsetItems

Methods inherited from class org.apache.tools.ant.Task

getDescription, getLocation, getOwningTarget, getRuntimeConfigurableWrapper, getTaskName, getTaskType, init, log, log, maybeConfigure, perform, reconfigure, setDescription, setLocation, setOwningTarget, setRuntimeConfigurableWrapper, setTaskName, setTaskType

Methods inherited from class org.apache.tools.ant.ProjectComponent

getProject

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

COMMAND_EDITOR_NAME

public static final java.lang.String COMMAND_EDITOR_NAME

Constructor Detail

AjcTask

public AjcTask()

Method Detail

setupAjc

public java.lang.String setupAjc(org.apache.tools.ant.taskdefs.Javac javac)

This method extracts javac arguments to ajc, and add arguments to make ajc behave more like javac in copying resources.

Pass ajc-specific options using compilerarg sub-element:

 <javac srcdir="src">
     <compilerarg compiler="..." line="-argfile src/args.lst"/>
 <javac>
 

Some javac arguments are not supported in this component (yet):

 String memoryInitialSize;
 boolean includeAntRuntime = true;
 boolean includeJavaRuntime = false;
 

Other javac arguments are not supported in ajc 1.1:

 boolean optimize;
 String forkedExecutable;
 FacadeTaskHelper facade;
 boolean depend;
 String debugLevel;
 Path compileSourcepath;
 

Parameters:

javac - the Javac command to implement (not null)

ajc - the AjcTask to adapt (not null)

destDir - the File class destination directory (may be null)

Returns:

null if no error, or String error otherwise

findAspectjtoolsJar

public static java.io.File findAspectjtoolsJar()

Find aspectjtools.jar on the task or system classpath. Accept aspectj{-}tools{...}.jar mainly to support build systems using maven-style re-naming (e.g., aspectj-tools-1.1.0.jar. Note that we search the task classpath first, though an entry on the system classpath would be loaded first, because it seems more correct as the more specific one.

Returns:

readable File for aspectjtools.jar, or null if not found.

reset

public void reset()

to use this same Task more than once (testing)

setIncremental

public void setIncremental(boolean incremental)

setLogCommand

public void setLogCommand(boolean logCommand)

setHelp

public void setHelp(boolean help)

setVersion

public void setVersion(boolean version)

setXTerminateAfterCompilation

public void setXTerminateAfterCompilation(boolean b)

setXReweavable

public void setXReweavable(boolean reweavable)

setXmlConfigured

public void setXmlConfigured(boolean xmlConfigured)

setXJoinpoints

public void setXJoinpoints(java.lang.String optionalJoinpoints)

setCheckRuntimeVersion

public void setCheckRuntimeVersion(boolean b)

setXNoWeave

public void setXNoWeave(boolean b)

setNoWeave

public void setNoWeave(boolean b)

setXNotReweavable

public void setXNotReweavable(boolean notReweavable)

setXaddSerialVersionUID

public void setXaddSerialVersionUID(boolean addUID)

setXNoInline

public void setXNoInline(boolean noInline)

setShowWeaveInfo

public void setShowWeaveInfo(boolean showweaveinfo)

setNowarn

public void setNowarn(boolean nowarn)

setDeprecation

public void setDeprecation(boolean deprecation)

setWarn

public void setWarn(java.lang.String warnings)

setDebug

public void setDebug(boolean debug)

setDebugLevel

public void setDebugLevel(java.lang.String level)

setEmacssym

public void setEmacssym(boolean emacssym)

setCrossrefs

public void setCrossrefs(boolean on)

setXlintwarnings

public void setXlintwarnings(boolean xlintwarnings)

-Xlint - set default level of -Xlint messages to warning (same as -Xlint:warning)

setXlint

public void setXlint(java.lang.String xlint)

-Xlint:{error|warning|info} - set default level for -Xlint messages

Parameters:

xlint - the String with one of error, warning, ignored

setXlintfile

public void setXlintfile(java.io.File xlintFile)

-Xlintfile {lint.properties} - enable or disable specific forms of -Xlint messages based on a lint properties file (default is org/aspectj/weaver/XLintDefault.properties)

Parameters:

xlintFile - the File with lint properties

setPreserveAllLocals

public void setPreserveAllLocals(boolean preserveAllLocals)

setNoImportError

public void setNoImportError(boolean noImportError)

setEncoding

public void setEncoding(java.lang.String encoding)

setLog

public void setLog(java.io.File file)

setProceedOnError

public void setProceedOnError(boolean proceedOnError)

setVerbose

public void setVerbose(boolean verbose)

setTimers

public void setTimers(boolean timers)

setListFileArgs

public void setListFileArgs(boolean listFileArgs)

setReferenceInfo

public void setReferenceInfo(boolean referenceInfo)

setTime

public void setTime(boolean time)

setNoExit

public void setNoExit(boolean noExit)

setFailonerror

public void setFailonerror(boolean failonerror)

isForked

public boolean isForked()

Returns:

true if fork was set

setFork

public void setFork(boolean fork)

setMaxmem

public void setMaxmem(java.lang.String maxMem)

createJvmarg

public org.apache.tools.ant.types.Commandline.Argument createJvmarg()

support for nested <jvmarg> elements

setTagFile

public void setTagFile(java.io.File file)

setOutjar

public void setOutjar(java.io.File file)

setOutxml

public void setOutxml(boolean outxml)

setOutxmlfile

public void setOutxmlfile(java.lang.String name)

setDestdir

public void setDestdir(java.io.File dir)

setTarget

public void setTarget(java.lang.String input)

Parameters:

input - a String in TARGET_INPUTS

setCompliance

public void setCompliance(java.lang.String input)

Language compliance level. If not set explicitly, eclipse default holds.

Parameters:

input - a String in COMPLIANCE_INPUTS

setSource

public void setSource(java.lang.String input)

Source compliance level. If not set explicitly, eclipse default holds.

Parameters:

input - a String in SOURCE_INPUTS

setCopyInjars

public void setCopyInjars(boolean doCopy)

Flag to copy all non-.class contents of injars to outjar after compile completes. Requires both injars and outjar.

Parameters:

doCopy -

setSourceRootCopyFilter

public void setSourceRootCopyFilter(java.lang.String filter)

Option to copy all files from all source root directories except those specified here. If this is specified and sourceroots are specified, then this will copy all files except those specified in the filter pattern. Requires sourceroots.

Parameters:

filter - a String acceptable as an excludes filter for an Ant Zip fileset.

setInpathDirCopyFilter

public void setInpathDirCopyFilter(java.lang.String filter)

Option to copy all files from all inpath directories except the files specified here. If this is specified and inpath directories are specified, then this will copy all files except those specified in the filter pattern. Requires inpath. If the input does not contain "**\/*.class", then this prepends it, to avoid overwriting woven classes with unwoven input.

Parameters:

filter - a String acceptable as an excludes filter for an Ant Zip fileset.

setX

public void setX(java.lang.String input)

setXDoneSignal

public void setXDoneSignal(java.lang.String doneSignal)

setMessageHolder

public void setMessageHolder(IMessageHolder holder)

direct API for testing

setMessageHolderClass

public void setMessageHolderClass(java.lang.String className)

Setup custom message handling.

Parameters:

className - the String fully-qualified-name of a class reachable from this object's class loader, implementing IMessageHolder, and having a public no-argument constructor.

Throws:

org.apache.tools.ant.BuildException - if unable to create instance of className

setCommandEditor

public void setCommandEditor(ICommandEditor editor)

direct API for testing

setCommandEditorClass

public void setCommandEditorClass(java.lang.String className)

Setup command-line filter. To do this staticly, define the environment variable org.aspectj.tools.ant.taskdefs.AjcTask.COMMAND_EDITOR with the className parameter.

Parameters:

className - the String fully-qualified-name of a class reachable from this object's class loader, implementing ICommandEditor, and having a public no-argument constructor.

Throws:

org.apache.tools.ant.BuildException - if unable to create instance of className

setSourcerootsref

public void setSourcerootsref(org.apache.tools.ant.types.Reference ref)

setSourceRoots

public void setSourceRoots(org.apache.tools.ant.types.Path roots)

createSourceRoots

public org.apache.tools.ant.types.Path createSourceRoots()

setXWeaveDir

public void setXWeaveDir(java.io.File file)

setInjarsref

public void setInjarsref(org.apache.tools.ant.types.Reference ref)

setInpathref

public void setInpathref(org.apache.tools.ant.types.Reference ref)

setInjars

public void setInjars(org.apache.tools.ant.types.Path path)

setInpath

public void setInpath(org.apache.tools.ant.types.Path path)

createInjars

public org.apache.tools.ant.types.Path createInjars()

createInpath

public org.apache.tools.ant.types.Path createInpath()

setClasspath

public void setClasspath(org.apache.tools.ant.types.Path path)

setClasspathref

public void setClasspathref(org.apache.tools.ant.types.Reference classpathref)

createClasspath

public org.apache.tools.ant.types.Path createClasspath()

setBootclasspath

public void setBootclasspath(org.apache.tools.ant.types.Path path)

setBootclasspathref

public void setBootclasspathref(org.apache.tools.ant.types.Reference bootclasspathref)

createBootclasspath

public org.apache.tools.ant.types.Path createBootclasspath()

setForkclasspath

public void setForkclasspath(org.apache.tools.ant.types.Path path)

setForkclasspathref

public void setForkclasspathref(org.apache.tools.ant.types.Reference forkclasspathref)

createForkclasspath

public org.apache.tools.ant.types.Path createForkclasspath()

setExtdirs

public void setExtdirs(org.apache.tools.ant.types.Path path)

setExtdirsref

public void setExtdirsref(org.apache.tools.ant.types.Reference ref)

createExtdirs

public org.apache.tools.ant.types.Path createExtdirs()

setAspectpathref

public void setAspectpathref(org.apache.tools.ant.types.Reference ref)

setAspectpath

public void setAspectpath(org.apache.tools.ant.types.Path path)

createAspectpath

public org.apache.tools.ant.types.Path createAspectpath()

setSrcDir

public void setSrcDir(org.apache.tools.ant.types.Path path)

createSrc

public org.apache.tools.ant.types.Path createSrc()

createSrcdir

public org.apache.tools.ant.types.Path createSrcdir()

isInIncrementalMode

public boolean isInIncrementalMode()

Returns:

true if in incremental mode (command-line or file)

isInIncrementalFileMode

public boolean isInIncrementalFileMode()

Returns:

true if in incremental file mode

setArgfilesref

public void setArgfilesref(org.apache.tools.ant.types.Reference ref)

setArgfiles

public void setArgfiles(org.apache.tools.ant.types.Path path)

createArgfiles

public org.apache.tools.ant.types.Path createArgfiles()

setInxmlref

public void setInxmlref(org.apache.tools.ant.types.Reference ref)

setInxml

public void setInxml(org.apache.tools.ant.types.Path path)

createInxml

public org.apache.tools.ant.types.Path createInxml()

execute

public void execute()
             throws org.apache.tools.ant.BuildException

Compile using ajc per settings.

Overrides:

execute in class org.apache.tools.ant.Task

Throws:

org.apache.tools.ant.BuildException - if the compilation has problems or if there were compiler errors and failonerror is true.

quit

public boolean quit()

Halt processing. This tells main in the same vm to quit. It fails when running in forked mode.

Returns:

true if not in forked mode and main has quit or been told to quit

readArguments

public void readArguments(java.lang.String[] args)

Read arguments in as if from a command line, mainly to support compiler adapter compilerarg subelement.

Parameters:

args - the String[] of arguments to read