Prev Class | Next Class | Frames | No Frames |
Summary: Nested | Field | Method | Constr | Detail: Nested | Field | Method | Constr |
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
public class Javac
extends MatchingTask
Nested Class Summary | |
class |
|
Field Summary | |
protected File[] | |
protected boolean | |
protected boolean |
Fields inherited from class org.apache.tools.ant.taskdefs.MatchingTask | |
fileset |
Fields inherited from class org.apache.tools.ant.Task | |
description , location , target , taskName , taskType , wrapper |
Fields inherited from class org.apache.tools.ant.ProjectComponent | |
project |
Constructor Summary | |
|
Method Summary | |
protected void |
|
protected void |
|
Path |
|
Path |
|
Javac.ImplementationSpecificArgument |
|
Path |
|
Path |
|
Path |
|
void |
|
Path |
|
Path |
|
String |
|
String |
|
String[] |
|
boolean |
|
String |
|
boolean |
|
boolean |
|
File |
|
String |
|
String |
|
Path |
|
boolean |
|
File[] |
|
boolean |
|
boolean |
|
String |
|
boolean |
|
String |
|
String |
|
boolean |
|
boolean |
|
String |
|
Path |
|
Path |
|
protected String | |
String |
|
File |
|
boolean |
|
boolean |
|
protected boolean |
|
protected Path |
|
protected void |
|
protected void |
|
void |
|
void |
|
void |
|
void |
|
void |
|
void |
|
void |
|
void |
|
void |
|
void |
|
void |
|
void |
|
void |
|
void |
|
void |
|
void |
|
void |
|
void |
|
void |
|
void |
|
void |
|
void |
|
void |
|
void |
|
void |
|
void |
|
void | |
void |
|
void |
|
void |
|
Methods inherited from class org.apache.tools.ant.taskdefs.MatchingTask | |
XsetIgnore , XsetItems , 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 |
Methods inherited from class org.apache.tools.ant.Task | |
execute , getDescription , getLocation , getOwningTarget , getRuntimeConfigurableWrapper , getTaskName , getTaskType , getWrapper , handleErrorFlush , handleErrorOutput , handleFlush , handleInput , handleOutput , init , isInvalid , log , log , maybeConfigure , perform , reconfigure , setDescription , setLocation , setOwningTarget , setRuntimeConfigurableWrapper , setTaskName , setTaskType |
Methods inherited from class org.apache.tools.ant.ProjectComponent | |
getProject , log , log , setProject |
protected File[] compileList
protected boolean failOnError
protected boolean listFiles
protected void checkParameters() throws BuildException
Check that all required attributes have been set and nothing silly has been entered.
- Throws:
BuildException
- if an error occurs
- Since:
- Ant 1.5
protected void compile()
Perform the compilation.
- Since:
- Ant 1.5
public Path createBootclasspath()
Adds a path to the bootclasspath.
- Returns:
- a path to be configured
public Path createClasspath()
Adds a path to the classpath.
- Returns:
- a class path to be configured
public Javac.ImplementationSpecificArgument createCompilerArg()
Adds an implementation specific command-line argument.
- Returns:
- a ImplementationSpecificArgument to be configured
public Path createSourcepath()
Adds a path to sourcepath.
- Returns:
- a sourcepath to be configured
public void execute() throws BuildException
Executes the task.
- Throws:
BuildException
- if an error occurs
public Path getBootclasspath()
Gets the bootclasspath that will be used to compile the classes against.
- Returns:
- the boot path
public Path getClasspath()
Gets the classpath to be used for this compilation.
- Returns:
- the class path
public String getCompiler()
The implementation for this particular task. Defaults to the build.compiler property but can be overridden via the compiler and fork attributes. If fork has been set to true, the result will be extJavac and not classic or java1.2 - no matter what the compiler attribute looks like.
- Since:
- Ant 1.5
- See Also:
getCompilerVersion()
public String getCompilerVersion()
The implementation for this particular task. Defaults to the build.compiler property but can be overridden via the compiler attribute. This method does not take the fork attribute into account.
- Since:
- Ant 1.5
- See Also:
getCompiler()
public String[] getCurrentCompilerArgs()
Get the additional implementation specific command line arguments.
- Returns:
- array of command line arguments, guaranteed to be non-null.
public boolean getDebug()
Gets the debug flag.
- Returns:
- the debug flag
public String getDebugLevel()
Get the value of debugLevel.
- Returns:
- value of debugLevel.
public boolean getDepend()
Gets the depend flag.
- Returns:
- the depend flag
public boolean getDeprecation()
Gets the deprecation flag.
- Returns:
- the deprecation flag
public File getDestdir()
Gets the destination directory into which the java source files should be compiled.
- Returns:
- the destination directory
public String getEncoding()
Gets the java source file encoding name.
- Returns:
- the source file encoding name
public String getExecutable()
The value of the executable attribute, if any.
- Returns:
- the name of the java executable
- Since:
- Ant 1.6
public Path getExtdirs()
Gets the extension directories that will be used during the compilation.
- Returns:
- the extension directories as a path
public boolean getFailonerror()
Gets the failonerror flag.
- Returns:
- the failonerror flag
public File[] getFileList()
Gets the list of files to be compiled.
- Returns:
- the list of files as an array
public boolean getIncludeantruntime()
Gets whether or not the ant classpath is to be included in the classpath.
- Returns:
- whether or not the ant classpath is to be included in the classpath
public boolean getIncludejavaruntime()
Gets whether or not the java runtime should be included in this task's classpath.
- Returns:
- the includejavaruntime attribute
public String getJavacExecutable()
The name of the javac executable to use in fork-mode. This is either the name specified with the executable attribute or the full path of the javac compiler of the VM Ant is currently running in - guessed by Ant. You should not invoke this method if you want to get the value of the executable command - usegetExecutable
for this.
- Returns:
- the name of the javac executable
public boolean getListfiles()
Get the listfiles flag.
- Returns:
- the listfiles flag
public String getMemoryInitialSize()
Gets the memoryInitialSize flag.
- Returns:
- the memoryInitialSize flag
public String getMemoryMaximumSize()
Gets the memoryMaximumSize flag.
- Returns:
- the memoryMaximumSize flag
public boolean getNowarn()
Should the -nowarn option be used.
- Returns:
- true if the -nowarn option should be used
public boolean getOptimize()
Gets the optimize flag.
- Returns:
- the optimize flag
public String getSource()
Get the value of source.
- Returns:
- value of source.
public Path getSourcepath()
Gets the sourcepath to be used for this compilation.
- Returns:
- the source path
public Path getSrcdir()
Gets the source dirs to find the source java files.
- Returns:
- the source directories as a path
protected String getSystemJavac()
- Returns:
- the executable name of the java compiler
public String getTarget()
Gets the target VM that the classes will be compiled for.
- Returns:
- the target VM
public File getTempdir()
Where Ant should place temporary files.
- Returns:
- the temporary directory
- Since:
- Ant 1.6
public boolean getVerbose()
Gets the verbose flag.
- Returns:
- the verbose flag
public boolean isForkedJavac()
Is this a forked invocation of JDK's javac?
- Returns:
- true if this is a forked invocation
protected boolean isJdkCompiler(String compilerImpl)
Is the compiler implementation a jdk compiler
- Parameters:
compilerImpl
- the name of the compiler implementation
- Returns:
- true if compilerImpl is "modern", "classic", "javac1.1", "javac1.2", "javac1.3", "javac1.4" or "javac1.5".
protected void resetFileLists()
Clear the list of files to be compiled and copied..
protected void scanDir(File srcDir, File destDir, String[] files)
Scans the directory looking for source files to be compiled. The results are returned in the class variable compileList
- Parameters:
srcDir
- The source directorydestDir
- The destination directoryfiles
- An array of filenames
public void setBootClasspathRef(Reference r)
Adds a reference to a classpath defined elsewhere.
- Parameters:
r
- a reference to a classpath
public void setBootclasspath(Path bootclasspath)
Sets the bootclasspath that will be used to compile the classes against.
- Parameters:
bootclasspath
- a path to use as a boot class path (may be more than one)
public void setClasspath(Path classpath)
Set the classpath to be used for this compilation.
- Parameters:
classpath
- an Ant Path object containing the compilation classpath.
public void setClasspathRef(Reference r)
Adds a reference to a classpath defined elsewhere.
- Parameters:
r
- a reference to a classpath
public void setCompiler(String compiler)
Choose the implementation for this particular task.
- Parameters:
compiler
- the name of the compiler
- Since:
- Ant 1.5
public void setDebug(boolean debug)
Indicates whether source should be compiled with debug information; defaults to off.
- Parameters:
debug
- if true compile with debug information
public void setDebugLevel(String v)
Keyword list to be appended to the -g command-line switch. This will be ignored by all implementations except modern and classic(ver >= 1.2). Legal values are none or a comma-separated list of the following keywords: lines, vars, and source. If debuglevel is not specified, by default, :none will be appended to -g. If debug is not turned on, this attribute will be ignored.
- Parameters:
v
- Value to assign to debugLevel.
public void setDepend(boolean depend)
Enables dependency-tracking for compilers that support this (jikes and classic).
- Parameters:
depend
- if true enable dependency-tracking
public void setDeprecation(boolean deprecation)
Indicates whether source should be compiled with deprecation information; defaults to off.
- Parameters:
deprecation
- if true turn on deprecation information
public void setDestdir(File destDir)
Set the destination directory into which the Java source files should be compiled.
- Parameters:
destDir
- the destination director
public void setEncoding(String encoding)
Set the Java source file encoding name.
- Parameters:
encoding
- the source file encoding
public void setExecutable(String forkExec)
Sets the name of the javac executable. Ignored unless fork is true or extJavac has been specified as the compiler.
- Parameters:
forkExec
- the name of the executable
public void setExtdirs(Path extdirs)
Sets the extension directories that will be used during the compilation.
- Parameters:
extdirs
- a path
public void setFailonerror(boolean fail)
Indicates whether the build will continue even if there are compilation errors; defaults to true.
- Parameters:
fail
- if true halt the build on failure
public void setFork(boolean f)
If true, forks the javac compiler.
- Parameters:
f
- "true|false|on|off|yes|no"
public void setIncludeantruntime(boolean include)
If true, includes Ant's own classpath in the classpath.
- Parameters:
include
- if true, includes Ant's own classpath in the classpath
public void setIncludejavaruntime(boolean include)
If true, includes the Java runtime libraries in the classpath.
- Parameters:
include
- if true, includes the Java runtime libraries in the classpath
public void setListfiles(boolean list)
If true, list the source files being handed off to the compiler.
- Parameters:
list
- if true list the source files
public void setMemoryInitialSize(String memoryInitialSize)
The initial size of the memory for the underlying VM if javac is run externally; ignored otherwise. Defaults to the standard VM memory setting. (Examples: 83886080, 81920k, or 80m)
- Parameters:
memoryInitialSize
- string to pass to VM
public void setMemoryMaximumSize(String memoryMaximumSize)
The maximum size of the memory for the underlying VM if javac is run externally; ignored otherwise. Defaults to the standard VM memory setting. (Examples: 83886080, 81920k, or 80m)
- Parameters:
memoryMaximumSize
- string to pass to VM
public void setNowarn(boolean flag)
If true, enables the -nowarn option.
- Parameters:
flag
- if true, enable the -nowarn option
public void setOptimize(boolean optimize)
If true, compiles with optimization enabled.
- Parameters:
optimize
- if true compile with optimization enabled
public void setProceed(boolean proceed)
- Parameters:
proceed
- inverse of failoferror
public void setSource(String v)
Value of the -source command-line switch; will be ignored by all implementations except modern and jikes. If you use this attribute together with jikes, you must make sure that your version of jikes supports the -source switch. Legal values are 1.3, 1.4 and 1.5 - by default, no -source argument will be used at all.
- Parameters:
v
- Value to assign to source.
public void setSourcepath(Path sourcepath)
Set the sourcepath to be used for this compilation.
- Parameters:
sourcepath
- the source path
public void setSourcepathRef(Reference r)
Adds a reference to a source path defined elsewhere.
- Parameters:
r
- a reference to a source path
public void setSrcdir(Path srcDir)
Set the source directories to find the source Java files.
- Parameters:
srcDir
- the source directories as a path
public void setTarget(String target)
Sets the target VM that the classes will be compiled for. Valid values depend on the compiler, for jdk 1.4 the valid values are "1.1", "1.2", "1.3", "1.4" and "1.5".
- Parameters:
target
- the target VM
public void setTempdir(File tmpDir)
Where Ant should place temporary files.
- Parameters:
tmpDir
- the temporary directory
- Since:
- Ant 1.6
public void setVerbose(boolean verbose)
If true, asks the compiler for verbose output.
- Parameters:
verbose
- if true, asks the compiler for verbose output