Class NetRexxC

java.lang.Object

org.apache.tools.ant.ProjectComponent

org.apache.tools.ant.Task

org.apache.tools.ant.taskdefs.MatchingTask

org.apache.tools.ant.taskdefs.optional.NetRexxC

All Implemented Interfaces:

Cloneable, SelectorContainer

public class NetRexxC
extends MatchingTask

Compiles NetRexx source files. This task can take the following arguments:

• binary
• classpath
• comments
• compile
• console
• crossref
• decimal
• destdir
• diag
• explicit
• format
• keep
• logo
• replace
• savelog
• srcdir
• sourcedir
• strictargs
• strictassign
• strictcase
• strictimport
• symbols
• time
• trace
• utf8
• verbose
• suppressMethodArgumentNotUsed
• suppressPrivatePropertyNotUsed
• suppressVariableNotUsed
• suppressExceptionNotSignalled
• suppressDeprecation
• removeKeepExtension

Of these arguments, the srcdir argument is required.

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:

1. The current directory, and,
2. The directory the source is in (see sourcedir option)

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	NetRexxC.TraceAttr	Enumerated class corresponding to the trace attribute.
static class	NetRexxC.VerboseAttr	Enumerated class corresponding to the verbose attribute.

Field Summary

Fields inherited from class MatchingTask

fileset

Modifier and Type	Field	Description
protected FileSet	fileset

Fields inherited from class Task

target, taskName, taskType, wrapper

Modifier and Type	Field	Description
protected Target	target	Deprecated. since 1.6.x.
protected String	taskName	Deprecated. since 1.6.x.
protected String	taskType	Deprecated. since 1.6.x.
protected RuntimeConfigurable	wrapper	Deprecated. since 1.6.x.

Fields inherited from class ProjectComponent

description, location, project

Modifier and Type	Field	Description
protected String	description	Deprecated. since 1.6.x.
protected Location	location	Deprecated. since 1.6.x.
protected Project	project	Deprecated. since 1.6.x.

Constructor Summary

Constructors

Constructor	Description
NetRexxC()

Method Summary

Modifier and Type	Method	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(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(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 whether 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(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(String trace)	Turns on or off tracing and directs the resultant trace output Valid values are: "trace", "trace1", "trace2" and "notrace".
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	setUtf8(boolean utf8)	Tells the NetRexx compiler that the source is in UTF8.
void	setVerbose(String verbose)	Whether lots of warnings and error messages should be generated
void	setVerbose(NetRexxC.VerboseAttr verbose)	Whether lots of warnings and error messages should be generated

Methods inherited from class 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

Modifier and Type	Method	Description
void	add(FileSelector selector)	add an arbitrary selector
void	addAnd(AndSelector selector)	add an "And" selector entry on the selector list
void	addContains(ContainsSelector selector)	add a contains selector entry on the selector list
void	addContainsRegexp(ContainsRegexpSelector selector)	add a regular expression selector entry on the selector list
void	addCustom(ExtendSelector selector)	add an extended selector entry on the selector list
void	addDate(DateSelector selector)	add a selector date entry on the selector list
void	addDepend(DependSelector selector)	add a depends selector entry on the selector list
void	addDepth(DepthSelector selector)	add a depth selector entry on the selector list
void	addDifferent(DifferentSelector selector)	add a type selector entry on the type list
void	addFilename(FilenameSelector selector)	add a selector filename entry on the selector list
void	addMajority(MajoritySelector selector)	add a majority selector entry on the selector list
void	addModified(ModifiedSelector selector)	add the modified selector
void	addNone(NoneSelector selector)	add a "None" selector entry on the selector list
void	addNot(NotSelector selector)	add a "Not" selector entry on the selector list
void	addOr(OrSelector selector)	add an "Or" selector entry on the selector list
void	addPresent(PresentSelector selector)	add a present selector entry on the selector list
void	addSelector(SelectSelector selector)	add a "Select" selector entry on the selector list
void	addSize(SizeSelector selector)	add a selector size entry on the selector list
void	addType(TypeSelector selector)	add a type selector entry on the type list
void	appendSelector(FileSelector selector)	Add a new selector into this container.
PatternSet.NameEntry	createExclude()	add a name entry on the exclude list
PatternSet.NameEntry	createExcludesFile()	add a name entry on the include files list
PatternSet.NameEntry	createInclude()	add a name entry on the include list
PatternSet.NameEntry	createIncludesFile()	add a name entry on the include files list
PatternSet	createPatternSet()	add a set of patterns
protected DirectoryScanner	getDirectoryScanner(File baseDir)	Returns the directory scanner needed to access the files to process.
protected final FileSet	getImplicitFileSet()	Accessor for the implicit fileset.
FileSelector[]	getSelectors(Project p)	Returns the set of selectors as an array.
boolean	hasSelectors()	Indicates whether there are any selectors here.
int	selectorCount()	Gives the count of the number of selectors in this container
Enumeration<FileSelector>	selectorElements()	Returns an enumerator for accessing the set of selectors.
void	setCaseSensitive(boolean isCaseSensitive)	Sets case sensitivity of the file system
void	setDefaultexcludes(boolean useDefaultExcludes)	Sets whether default exclusions should be used or not.
void	setExcludes(String excludes)	Sets the set of exclude patterns.
void	setExcludesfile(File excludesfile)	Sets the name of the file containing the includes patterns.
void	setFollowSymlinks(boolean followSymlinks)	Sets whether or not symbolic links or Windows junctions should be followed.
void	setIncludes(String includes)	Sets the set of include patterns.
void	setIncludesfile(File includesfile)	Sets the name of the file containing the includes patterns.
void	setProject(Project project)	Sets the project object of this component.
void	XsetIgnore(String ignoreString)	List of filenames and directory names to not include.
void	XsetItems(String itemString)	Set this to be the items in the base directory that you want to be included.

Methods inherited from class Task

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

Modifier and Type	Method	Description
final void	bindToOwner(Task owner)	Bind a task to another; use this when configuring a newly created task to do work on behalf of another.
Target	getOwningTarget()	Returns the container target of this task.
RuntimeConfigurable	getRuntimeConfigurableWrapper()	Returns the wrapper used for runtime configuration.
String	getTaskName()	Returns the name to use in logging messages.
String	getTaskType()	Return the type of task.
protected RuntimeConfigurable	getWrapper()	Return the runtime configurable structure for this task.
protected void	handleErrorFlush(String output)	Handles an error line by logging it with the WARN priority.
protected void	handleErrorOutput(String output)	Handles an error output by logging it with the WARN priority.
protected void	handleFlush(String output)	Handles output by logging it with the INFO priority.
protected int	handleInput(byte[] buffer, int offset, int length)	Handle an input request by this task.
protected void	handleOutput(String output)	Handles output by logging it with the INFO priority.
protected final boolean	isInvalid()	Has this task been marked invalid?
void	log(String msg)	Logs a message with the default (INFO) priority.
void	log(String msg, int msgLevel)	Logs a message with the given priority.
void	log(String msg, Throwable t, int msgLevel)	Logs a message with the given priority.
void	log(Throwable t, int msgLevel)	Logs a message with the given priority.
void	maybeConfigure()	Configures this task - if it hasn't been done already.
final void	perform()	Performs this task if it's still valid, or gets a replacement version and performs that otherwise.
void	reconfigure()	Force the task to be reconfigured from its RuntimeConfigurable.
void	setOwningTarget(Target target)	Sets the target container of this task.
void	setRuntimeConfigurableWrapper(RuntimeConfigurable wrapper)	Sets the wrapper to be used for runtime configuration.
void	setTaskName(String name)	Sets the name to use in logging messages.
void	setTaskType(String type)	Sets the name with which the task has been invoked.

Methods inherited from class ProjectComponent

clone, getDescription, getLocation, getProject, setDescription, setLocation

Modifier and Type	Method	Description
Object	clone()
String	getDescription()	Returns the description of the current action.
Location	getLocation()	Returns the file/location where this task was defined.
Project	getProject()	Returns the project to which this component belongs.
void	setDescription(String desc)	Sets a description of the current action.
void	setLocation(Location location)	Sets the file/location where this task was defined.

Methods inherited from class Object

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

Constructor Details

NetRexxC

public NetRexxC()

Method Details

setBinary

public void setBinary(boolean binary)

Set whether literals are treated as binary, rather than NetRexx types. Valid true values are "yes", "on" or "true". Anything else sets the flag to false. The default is false.

Parameters:

binary - a boolean value.

setClasspath

public void setClasspath(String classpath)

Set the classpath used for NetRexx compilation.

Parameters:

classpath - the classpath to use.

setComments

public void setComments(boolean comments)

Set whether comments are passed through to the generated java source. Valid true values are "yes", "on" or "true". Anything else sets the flag to false. The default value is false.

Parameters:

comments - a boolean value.

setCompact

public void setCompact(boolean compact)

Set whether error messages come out in compact or verbose format. Valid true values are "yes", "on" or "true". Anything else sets the flag to false. The default value is true.

Parameters:

compact - a boolean value.

setCompile

public void setCompile(boolean compile)

Set whether the NetRexx compiler should compile the generated java code. Valid true values are "yes", "on" or "true". Anything else sets the flag to false. The default value is true. Setting this flag to false, will automatically set the keep flag to true.

Parameters:

compile - a boolean value.

setConsole

public void setConsole(boolean console)

Set whether or not compiler messages should be displayed on the 'console'. Note that this task will rely on the default value for filtering compile messages. Valid true values are "yes", "on" or "true". Anything else sets the flag to false. The default value is false.

Parameters:

console - a boolean value.

setCrossref

public void setCrossref(boolean crossref)

Whether variable cross references are generated. Valid true values are "yes", "on" or "true". Anything else sets the flag to false. The default value is false.

Parameters:

crossref - a boolean value.

setDecimal

public void setDecimal(boolean decimal)

Set whether decimal arithmetic should be used for the netrexx code. Setting this to off will report decimal arithmetic as an error, for performance critical applications. Valid true values are "yes", "on" or "true". Anything else sets the flag to false. The default value is true.

Parameters:

decimal - a boolean value.

setDestDir

public void setDestDir(File destDirName)

Set the destination directory into which the NetRexx source files should be copied and then compiled.

Parameters:

destDirName - the destination directory.

setDiag

public void setDiag(boolean diag)

Whether diagnostic information about the compile is generated

Parameters:

diag - a boolean value.

setExplicit

public void setExplicit(boolean explicit)

Sets whether variables must be declared explicitly before use. Valid true values are "yes", "on" or "true". Anything else sets the flag to false. The default value is false.

Parameters:

explicit - a boolean value.

setFormat

public void setFormat(boolean format)

Whether the generated java code is formatted nicely or left to match NetRexx line numbers for call stack debugging. Valid true values are "yes", "on" or "true". Anything else sets the flag to false. The default value false.

Parameters:

format - a boolean value.

setJava

public void setJava(boolean java)

Whether the generated java code is produced. This is not implemented yet.

Parameters:

java - a boolean value.

setKeep

public void setKeep(boolean keep)

Sets whether the generated java source file should be kept after compilation. The generated files will have an extension of .java.keep, not .java. See setRemoveKeepExtension Valid true values are "yes", "on" or "true". Anything else sets the flag to false. The default value is false.

Parameters:

keep - a boolean value.

See Also:

• setRemoveKeepExtension(boolean)

setLogo

public void setLogo(boolean logo)

Whether the compiler text logo is displayed when compiling. Valid true values are "yes", "on" or "true". Anything else sets the flag to false. The default value is false.

Parameters:

logo - a boolean value.

setReplace

public void setReplace(boolean replace)

Whether the generated .java file should be replaced when compiling. Valid true values are "yes", "on" or "true". Anything else sets the flag to false. The default value is false.

Parameters:

replace - a boolean value.

setSavelog

public void setSavelog(boolean savelog)

Sets whether the compiler messages will be written to NetRexxC.log as well as to the console. Valid true values are "yes", "on" or "true". Anything else sets the flag to false. The default value is false.

Parameters:

savelog - a boolean value.

setSourcedir

public void setSourcedir(boolean sourcedir)

Tells the NetRexx compiler to store the class files in the same directory as the source files. The alternative is the working directory. Valid true values are "yes", "on" or "true". Anything else sets the flag to false. The default value is true.

Parameters:

sourcedir - a boolean value.

setSrcDir

public void setSrcDir(File srcDirName)

Set the source dir to find the source Java files.

Parameters:

srcDirName - the source directory.

setStrictargs

public void setStrictargs(boolean strictargs)

Tells the NetRexx compiler that method calls always need parentheses, even if no arguments are needed, e.g. 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.

Parameters:

strictargs - a boolean value.

setStrictassign

public void setStrictassign(boolean strictassign)

Tells the NetRexx compile that assignments must match exactly on type. Valid true values are "yes", "on" or "true". Anything else sets the flag to false. The default value is false.

Parameters:

strictassign - a boolean value.

setStrictcase

public void setStrictcase(boolean strictcase)

Specifies whether the NetRexx compiler should be case sensitive or not. Valid true values are "yes", "on" or "true". Anything else sets the flag to false. The default value is false.

Parameters:

strictcase - a boolean value.

setStrictimport

public void setStrictimport(boolean strictimport)

Sets whether classes need to be imported explicitly using an 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.

Parameters:

strictimport - a boolean value.

setStrictprops

public void setStrictprops(boolean strictprops)

Sets whether local properties need to be qualified explicitly using this. Valid true values are "yes", "on" or "true". Anything else sets the flag to false. The default value is false.

Parameters:

strictprops - a boolean value.

setStrictsignal

public void setStrictsignal(boolean strictsignal)

Whether the compiler should force catching of exceptions by explicitly named types. Valid true values are "yes", "on" or "true". Anything else sets the flag to false. The default value is false

Parameters:

strictsignal - a boolean value.

setSymbols

public void setSymbols(boolean symbols)

Sets whether debug symbols should be generated into the class file. Valid true values are "yes", "on" or "true". Anything else sets the flag to false. The default value is false.

Parameters:

symbols - a boolean value.

setTime

public void setTime(boolean time)

Asks the NetRexx compiler to print compilation times to the console Valid true values are "yes", "on" or "true". Anything else sets the flag to false. The default value is false.

Parameters:

time - a boolean value.

setTrace

public void setTrace(NetRexxC.TraceAttr trace)

Turns on or off tracing and directs the resultant trace output Valid values are: "trace", "trace1", "trace2" and "notrace". "trace" and "trace2".

Parameters:

trace - the value to set.

setTrace

public void setTrace(String trace)

Turns on or off tracing and directs the resultant trace output Valid values are: "trace", "trace1", "trace2" and "notrace". "trace" and "trace2".

Parameters:

trace - the value to set.

setUtf8

public void setUtf8(boolean utf8)

Tells the NetRexx compiler that the source is in UTF8. Valid true values are "yes", "on" or "true". Anything else sets the flag to false. The default value is false.

Parameters:

utf8 - a boolean value.

setVerbose

public void setVerbose(NetRexxC.VerboseAttr verbose)

Whether lots of warnings and error messages should be generated

Parameters:

verbose - the value to set - verbose<level> or noverbose.

setVerbose

public void setVerbose(String verbose)

Whether lots of warnings and error messages should be generated

Parameters:

verbose - the value to set - verbose<level> or noverbose.

setSuppressMethodArgumentNotUsed

public 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. The warning is logged as verbose message, though.

Parameters:

suppressMethodArgumentNotUsed - a boolean value.

setSuppressPrivatePropertyNotUsed

public 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. The warning is logged as verbose message, though.

Parameters:

suppressPrivatePropertyNotUsed - a boolean value.

setSuppressVariableNotUsed

public void setSuppressVariableNotUsed(boolean suppressVariableNotUsed)

Whether the task should suppress the "Variable is set but not used" in strictargs-Mode. Be careful with this one! The warning is logged as verbose message, though.

Parameters:

suppressVariableNotUsed - a boolean value.

setSuppressExceptionNotSignalled

public 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. The warning is logged as verbose message, though.

Parameters:

suppressExceptionNotSignalled - a boolean value.

setSuppressDeprecation

public void setSuppressDeprecation(boolean suppressDeprecation)

Tells whether we should filter out any deprecation-messages of the compiler out.

Parameters:

suppressDeprecation - a boolean value.

setRemoveKeepExtension

public void setRemoveKeepExtension(boolean removeKeepExtension)

Tells whether the trailing .keep in nocompile-mode should be removed so that the resulting java source really ends on .java. This facilitates the use of the javadoc tool later on.

Parameters:

removeKeepExtension - boolean

init

public void init()

init-Method sets defaults from Properties. That way, when ant is called with arguments like -Dant.netrexxc.verbose=verbose5 one can easily take control of all netrexxc-tasks.

Overrides:

init in class Task

execute

public void execute()
             throws BuildException

Executes the task - performs the actual compiler call.

Overrides:

execute in class Task

Throws:

BuildException - on error.