Apt (Apache Ant API)
Date: 2015-06-29

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

    Nested Classes
    Modifier and Type | Class and Description
    --- | ---
    `static class` | `Apt.Option` The nested option element.

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

      `Javac.ImplementationSpecificArgument`

  - ### Field Summary

    Fields
    Modifier and Type | Field and Description
    --- | ---
    `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

    Constructors
    Constructor and Description
    `Apt()` Constructor for Apt task.

  - ### Method Summary

    Methods
    Modifier and Type | Method and Description
    --- | ---
    `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<Apt.Option>` | `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

      `add, checkParameters, compile, createBootclasspath, createClasspath, createCompilerArg, createCompilerClasspath, 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, getTaskSuccess, getTempdir, getVerbose, isForkedJavac, isIncludeDestClasses, isJdkCompiler, recreateSrc, resetFileLists, scanDir, setBootclasspath, setBootClasspathRef, setClasspath, setClasspathRef, setCreateMissingPackageInfoClass, setDebug, setDebugLevel, setDepend, setDeprecation, setDestdir, setEncoding, setErrorProperty, setExecutable, setExtdirs, setFailonerror, setIncludeantruntime, setIncludeDestClasses, setIncludejavaruntime, setListfiles, setMemoryInitialSize, setMemoryMaximumSize, setNowarn, setOptimize, setProceed, setSource, setSourcepath, setSourcepathRef, setSrcdir, setTarget, setTempdir, setUpdatedProperty, 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()

      Constructor 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<Apt.Option> 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.