org.apache.tools.ant.taskdefs
Class Apt

java.lang.Object
  org.apache.tools.ant.ProjectComponent
      org.apache.tools.ant.Task
          org.apache.tools.ant.taskdefs.MatchingTask
              org.apache.tools.ant.taskdefs.Javac
                  org.apache.tools.ant.taskdefs.Apt

All Implemented Interfaces:

java.lang.Cloneable, SelectorContainer

public class Apt
extends Javac

Apt Task for running the Annotation processing tool for JDK 1.5. It derives from the existing Javac task, and forces the compiler based on whether we're executing internally, or externally.

Since:

Ant 1.7

Nested Class Summary

static class

Apt.Option The nested option element.

Nested classes/interfaces inherited from class org.apache.tools.ant.taskdefs.Javac

Javac.ImplementationSpecificArgument

Field Summary

static java.lang.String	ERROR_IGNORING_COMPILER_OPTION An warning message when ignoring compiler attribute.
static java.lang.String	ERROR_WRONG_JAVA_VERSION A warning message if used with java < 1.5.
static java.lang.String	EXECUTABLE_NAME The name of the apt tool.
static java.lang.String	WARNING_IGNORING_FORK exposed for debug messages

Fields inherited from class org.apache.tools.ant.taskdefs.Javac

compileList, failOnError, listFiles

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

fileset

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

target, taskName, taskType, wrapper

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

description, location, project

Constructor Summary

Apt()
Construtor for Apt task.

Method Summary

Path	createFactoryPath() Add a path to the factoryPath attribute.
Apt.Option	createOption() Create a nested option.
void	execute() Do the compilation.
java.lang.String	getAptExecutable() Get the name of the apt executable.
java.lang.String	getCompiler() Get the compiler class name.
java.lang.String	getFactory() Get the factory option for the apt compiler.
Path	getFactoryPath() Get the factory path attribute.
java.util.Vector	getOptions() Get the options to the compiler.
java.io.File	getPreprocessDir() Get the preprocessdir attribute.
boolean	isCompile() Get the compile option for the apt compiler.
void	setCompile(boolean compile) Set the compile option for the apt compiler.
void	setCompiler(java.lang.String compiler) Set the compiler.
void	setFactory(java.lang.String factory) Set the factory option for the apt compiler.
void	setFactoryPathRef(Reference ref) Add a reference to a path to the factoryPath attribute.
void	setFork(boolean fork) Set the fork attribute.
void	setPreprocessDir(java.io.File preprocessDir) Set the preprocessdir attribute.

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

checkParameters, compile, createBootclasspath, createClasspath, createCompilerArg, createExtdirs, createSourcepath, createSrc, getBootclasspath, getClasspath, getCompilerVersion, getCurrentCompilerArgs, getDebug, getDebugLevel, getDepend, getDeprecation, getDestdir, getEncoding, getExecutable, getExtdirs, getFailonerror, getFileList, getIncludeantruntime, getIncludejavaruntime, getJavacExecutable, getListfiles, getMemoryInitialSize, getMemoryMaximumSize, getNowarn, getOptimize, getSource, getSourcepath, getSrcdir, getSystemJavac, getTarget, getTempdir, getVerbose, isForkedJavac, isJdkCompiler, recreateSrc, resetFileLists, scanDir, setBootclasspath, setBootClasspathRef, setClasspath, setClasspathRef, setDebug, setDebugLevel, setDepend, setDeprecation, setDestdir, setEncoding, setExecutable, setExtdirs, setFailonerror, setIncludeantruntime, setIncludejavaruntime, setListfiles, setMemoryInitialSize, setMemoryMaximumSize, setNowarn, setOptimize, setProceed, setSource, setSourcepath, setSourcepathRef, setSrcdir, setTarget, setTempdir, setVerbose

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, getDirectoryScanner, getImplicitFileSet, getSelectors, hasSelectors, selectorCount, selectorElements, setCaseSensitive, setDefaultexcludes, setExcludes, setExcludesfile, setFollowSymlinks, setIncludes, setIncludesfile, setProject, XsetIgnore, XsetItems

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

bindToOwner, getOwningTarget, getRuntimeConfigurableWrapper, getTaskName, getTaskType, getWrapper, handleErrorFlush, handleErrorOutput, handleFlush, handleInput, handleOutput, init, isInvalid, log, log, log, log, maybeConfigure, perform, reconfigure, setOwningTarget, setRuntimeConfigurableWrapper, setTaskName, setTaskType

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

clone, getDescription, getLocation, getProject, setDescription, setLocation

Methods inherited from class java.lang.Object

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

Field Detail

EXECUTABLE_NAME

public static final java.lang.String EXECUTABLE_NAME

The name of the apt tool.

See Also:

Constant Field Values

ERROR_IGNORING_COMPILER_OPTION

public static final java.lang.String ERROR_IGNORING_COMPILER_OPTION

An warning message when ignoring compiler attribute.

See Also:

Constant Field Values

ERROR_WRONG_JAVA_VERSION

public static final java.lang.String ERROR_WRONG_JAVA_VERSION

A warning message if used with java < 1.5.

See Also:

Constant Field Values

WARNING_IGNORING_FORK

public static final java.lang.String WARNING_IGNORING_FORK

exposed for debug messages

See Also:

Constant Field Values

Constructor Detail

Apt

public Apt()

Construtor for Apt task. This sets the apt compiler adapter as the compiler in the super class.

Method Detail

getAptExecutable

public java.lang.String getAptExecutable()

Get the name of the apt executable.

Returns:

the name of the executable.

setCompiler

public void setCompiler(java.lang.String compiler)

Set the compiler. This is not allowed and a warning log message is made.

Overrides:

setCompiler in class Javac

Parameters:

compiler - not used.

setFork

public void setFork(boolean fork)

Set the fork attribute. Non-forking APT is highly classpath dependent and appears to be too brittle to work. The sole reason this attribute is retained is the superclass does it

Overrides:

setFork in class Javac

Parameters:

fork - if false; warn the option is ignored.

getCompiler

public java.lang.String getCompiler()

Get the compiler class name.

Overrides:

getCompiler in class Javac

Returns:

the compiler class name.

See Also:

Javac.getCompilerVersion()

isCompile

public boolean isCompile()

Get the compile option for the apt compiler. If this is false the "-nocompile" argument will be used.

Returns:

the value of the compile option.

setCompile

public void setCompile(boolean compile)

Set the compile option for the apt compiler. Default value is true.

Parameters:

compile - if true set the compile option.

getFactory

public java.lang.String getFactory()

Get the factory option for the apt compiler. If this is non-null the "-factory" argument will be used.

Returns:

the value of the factory option.

setFactory

public void setFactory(java.lang.String factory)

Set the factory option for the apt compiler. Default value is null.

Parameters:

factory - the classname of the factory.

setFactoryPathRef

public void setFactoryPathRef(Reference ref)

Add a reference to a path to the factoryPath attribute.

Parameters:

ref - a reference to a path.

createFactoryPath

public Path createFactoryPath()

Add a path to the factoryPath attribute.

Returns:

a path to be configured.

getFactoryPath

public Path getFactoryPath()

Get the factory path attribute. If this is not null, the "-factorypath" argument will be used. The default value is null.

Returns:

the factory path attribute.

createOption

public Apt.Option createOption()

Create a nested option.

Returns:

an option to be configured.

getOptions

public java.util.Vector getOptions()

Get the options to the compiler. Each option will use '"-E" name ["=" value]' argument.

Returns:

the options.

getPreprocessDir

public java.io.File getPreprocessDir()

Get the preprocessdir attribute. This corresponds to the "-s" argument. The default value is null.

Returns:

the preprocessdir attribute.

setPreprocessDir

public void setPreprocessDir(java.io.File preprocessDir)

Set the preprocessdir attribute.

Parameters:

preprocessDir - where to place processor generated source files.

execute

public void execute()
             throws BuildException

Do the compilation.

Overrides:

execute in class Javac

Throws:

BuildException - on error.