public class NetRexxC extends MatchingTask
When this task executes, it will recursively scan the srcdir looking for NetRexx source files to compile. This task makes its compile decision based on timestamp.
Before files are compiled they and any other file in the srcdir will be copied to the destdir allowing support files to be located properly in the classpath. The reason for copying the source files before the compile is that NetRexxC has only two destinations for classfiles:
Modifier and Type | Class and Description |
---|---|
static class |
NetRexxC.TraceAttr
Enumerated class corresponding to the trace attribute.
|
static class |
NetRexxC.VerboseAttr
Enumerated class corresponding to the verbose attribute.
|
fileset
description, location, project
Constructor and Description |
---|
NetRexxC() |
Modifier and Type | Method and Description |
---|---|
void |
execute()
Executes the task - performs the actual compiler call.
|
void |
init()
init-Method sets defaults from Properties.
|
void |
setBinary(boolean binary)
Set whether literals are treated as binary, rather than NetRexx types.
|
void |
setClasspath(java.lang.String classpath)
Set the classpath used for NetRexx compilation.
|
void |
setComments(boolean comments)
Set whether comments are passed through to the generated java source.
|
void |
setCompact(boolean compact)
Set whether error messages come out in compact or verbose format.
|
void |
setCompile(boolean compile)
Set whether the NetRexx compiler should compile the generated java code.
|
void |
setConsole(boolean console)
Set whether or not compiler messages should be displayed on the 'console'.
|
void |
setCrossref(boolean crossref)
Whether variable cross references are generated.
|
void |
setDecimal(boolean decimal)
Set whether decimal arithmetic should be used for the netrexx code.
|
void |
setDestDir(java.io.File destDirName)
Set the destination directory into which the NetRexx source files
should be copied and then compiled.
|
void |
setDiag(boolean diag)
Whether diagnostic information about the compile is generated
|
void |
setExplicit(boolean explicit)
Sets whether variables must be declared explicitly before use.
|
void |
setFormat(boolean format)
Whether the generated java code is formatted nicely or left to match
NetRexx line numbers for call stack debugging.
|
void |
setJava(boolean java)
Whether the generated java code is produced.
|
void |
setKeep(boolean keep)
Sets whether the generated java source file should be kept after
compilation.
|
void |
setLogo(boolean logo)
Whether the compiler text logo is displayed when compiling.
|
void |
setRemoveKeepExtension(boolean removeKeepExtension)
Tells wether the trailing .keep in nocompile-mode should be removed
so that the resulting java source really ends on .java.
|
void |
setReplace(boolean replace)
Whether the generated .java file should be replaced when compiling.
|
void |
setSavelog(boolean savelog)
Sets whether the compiler messages will be written to NetRexxC.log as
well as to the console.
|
void |
setSourcedir(boolean sourcedir)
Tells the NetRexx compiler to store the class files in the same
directory as the source files.
|
void |
setSrcDir(java.io.File srcDirName)
Set the source dir to find the source Java files.
|
void |
setStrictargs(boolean strictargs)
Tells the NetRexx compiler that method calls always need parentheses,
even if no arguments are needed, e.g.
|
void |
setStrictassign(boolean strictassign)
Tells the NetRexx compile that assignments must match exactly on type.
|
void |
setStrictcase(boolean strictcase)
Specifies whether the NetRexx compiler should be case sensitive or not.
|
void |
setStrictimport(boolean strictimport)
Sets whether classes need to be imported explicitly using an
import
statement. |
void |
setStrictprops(boolean strictprops)
Sets whether local properties need to be qualified explicitly using
this . |
void |
setStrictsignal(boolean strictsignal)
Whether the compiler should force catching of exceptions by explicitly
named types.
|
void |
setSuppressDeprecation(boolean suppressDeprecation)
Tells whether we should filter out any deprecation-messages
of the compiler out.
|
void |
setSuppressExceptionNotSignalled(boolean suppressExceptionNotSignalled)
Whether the task should suppress the "FooException is in SIGNALS list
but is not signalled within the method", which is sometimes rather
useless.
|
void |
setSuppressMethodArgumentNotUsed(boolean suppressMethodArgumentNotUsed)
Whether the task should suppress the "Method argument is not used" in
strictargs-Mode, which can not be suppressed by the compiler itself.
|
void |
setSuppressPrivatePropertyNotUsed(boolean suppressPrivatePropertyNotUsed)
Whether the task should suppress the "Private property is defined but
not used" in strictargs-Mode, which can be quite annoying while
developing.
|
void |
setSuppressVariableNotUsed(boolean suppressVariableNotUsed)
Whether the task should suppress the "Variable is set but not used" in
strictargs-Mode.
|
void |
setSymbols(boolean symbols)
Sets whether debug symbols should be generated into the class file.
|
void |
setTime(boolean time)
Asks the NetRexx compiler to print compilation times to the console
Valid true values are "yes", "on" or "true".
|
void |
setTrace(NetRexxC.TraceAttr trace)
Turns on or off tracing and directs the resultant trace output Valid
values are: "trace", "trace1", "trace2" and "notrace".
|
void |
setTrace(java.lang.String trace)
Turns on or off tracing and directs the resultant trace output Valid
values are: "trace", "trace1", "trace2" and "notrace".
|
void |
setUtf8(boolean utf8)
Tells the NetRexx compiler that the source is in UTF8.
|
void |
setVerbose(NetRexxC.VerboseAttr verbose)
Whether lots of warnings and error messages should be generated
|
void |
setVerbose(java.lang.String verbose)
Whether lots of warnings and error messages should be generated
|
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
bindToOwner, getOwningTarget, getRuntimeConfigurableWrapper, getTaskName, getTaskType, getWrapper, handleErrorFlush, handleErrorOutput, handleFlush, handleInput, handleOutput, isInvalid, log, log, log, log, maybeConfigure, perform, reconfigure, setOwningTarget, setRuntimeConfigurableWrapper, setTaskName, setTaskType
clone, getDescription, getLocation, getProject, setDescription, setLocation
public void setBinary(boolean binary)
binary
- a boolean
value.public void setClasspath(java.lang.String classpath)
classpath
- the classpath to use.public void setComments(boolean comments)
comments
- a boolean
value.public void setCompact(boolean compact)
compact
- a boolean
value.public void setCompile(boolean compile)
compile
- a boolean
value.public void setConsole(boolean console)
console
- a boolean
value.public void setCrossref(boolean crossref)
crossref
- a boolean
value.public void setDecimal(boolean decimal)
decimal
- a boolean
value.public void setDestDir(java.io.File destDirName)
destDirName
- the destination directory.public void setDiag(boolean diag)
diag
- a boolean
value.public void setExplicit(boolean explicit)
explicit
- a boolean
value.public void setFormat(boolean format)
format
- a boolean
value.public void setJava(boolean java)
java
- a boolean
value.public void setKeep(boolean keep)
keep
- a boolean
value.setRemoveKeepExtension(boolean)
public void setLogo(boolean logo)
logo
- a boolean
value.public void setReplace(boolean replace)
replace
- a boolean
value.public void setSavelog(boolean savelog)
savelog
- a boolean
value.public void setSourcedir(boolean sourcedir)
sourcedir
- a boolean
value.public void setSrcDir(java.io.File srcDirName)
srcDirName
- the source directory.public void setStrictargs(boolean strictargs)
aStringVar.getBytes
vs. aStringVar.getBytes()
.
Valid true values are "yes", "on" or "true". Anything else sets the flag to false.
The default value is false.strictargs
- a boolean
value.public void setStrictassign(boolean strictassign)
strictassign
- a boolean
value.public void setStrictcase(boolean strictcase)
strictcase
- a boolean
value.public void setStrictimport(boolean strictimport)
import
statement. By default the NetRexx compiler will import certain packages
automatically.
Valid true values are "yes", "on" or "true". Anything else sets the flag to false.
The default value is false.strictimport
- a boolean
value.public void setStrictprops(boolean strictprops)
this
.
Valid true values are "yes", "on" or "true". Anything else sets the flag to false.
The default value is false.strictprops
- a boolean
value.public void setStrictsignal(boolean strictsignal)
strictsignal
- a boolean
value.public void setSymbols(boolean symbols)
symbols
- a boolean
value.public void setTime(boolean time)
time
- a boolean
value.public void setTrace(NetRexxC.TraceAttr trace)
trace
- the value to set.public void setTrace(java.lang.String trace)
trace
- the value to set.public void setUtf8(boolean utf8)
utf8
- a boolean
value.public void setVerbose(NetRexxC.VerboseAttr verbose)
verbose
- the value to set - verbose<level> or noverbose.public void setVerbose(java.lang.String verbose)
verbose
- the value to set - verbose<level> or noverbose.public void setSuppressMethodArgumentNotUsed(boolean suppressMethodArgumentNotUsed)
suppressMethodArgumentNotUsed
- a boolean
value.public void setSuppressPrivatePropertyNotUsed(boolean suppressPrivatePropertyNotUsed)
suppressPrivatePropertyNotUsed
- a boolean
value.public void setSuppressVariableNotUsed(boolean suppressVariableNotUsed)
suppressVariableNotUsed
- a boolean
value.public void setSuppressExceptionNotSignalled(boolean suppressExceptionNotSignalled)
suppressExceptionNotSignalled
- a boolean
value.public void setSuppressDeprecation(boolean suppressDeprecation)
suppressDeprecation
- a boolean
value.public void setRemoveKeepExtension(boolean removeKeepExtension)
public void init()
public void execute() throws BuildException
execute
in class Task
BuildException
- on error.