| 
 | ||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
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.dotnet.DotnetBaseMatchingTask
                          |
                          +--org.apache.tools.ant.taskdefs.optional.dotnet.Ilasm
Assembles .NET Intermediate Language files. ilasm.exe must be on the execute path, unless another executable or the full path to that executable is specified in the executable parameter
All parameters are optional: <il/> should suffice to produce a debug build of all *.il files. The option set is roughly compatible with the CSharp class; even though the command line options are only vaguely equivalent. [The low level commands take things like /OUT=file, csc wants /out:file ... /verbose is used some places; /quiet here in ildasm... etc.] It would be nice if someone made all the command line tools consistent (and not as brittle as the java cmdline tools)
The task is a directory based task, so attributes like includes="*.il" and excludes="broken.il" can be used to control the files pulled in. You can also use nested <src> filesets to refer to source.
| Nested Class Summary | |
| static class | Ilasm.TargetTypesTarget types to build. | 
| Field Summary | |
| protected  boolean | debugdebug flag. | 
| protected static java.lang.String | exe_nameName of the executable. | 
| protected static java.lang.String | exe_titletitle of task for external presentation | 
| protected  java.lang.String | extraOptionsany extra command options? | 
| protected  boolean | failOnErrorflag to control action on execution trouble | 
| protected static java.lang.String | file_extwhat is the file extension we search on? | 
| protected static java.lang.String | file_patternand now derive the search pattern from the extension | 
| protected  boolean | listinglisting flag | 
| protected  java.util.Vector | referenceFilesetsfilesets of references | 
| protected  java.io.File | resourceFileresource file (.res format) to include in the app. | 
| protected  java.lang.String | targetTypetype of target. | 
| protected  boolean | verboseverbose flag | 
| Fields inherited from class org.apache.tools.ant.taskdefs.optional.dotnet.DotnetBaseMatchingTask | 
| filesets, outputFile, srcDir | 
| 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 | |
| Ilasm()constructor inits everything and set up the search pattern | |
| Method Summary | |
|  void | addReference(FileSet reference)add a new reference fileset to the compilation | 
|  void | Clear()reset all contents. | 
|  void | execute()This is the execution entry point. | 
|  boolean | getDebug()query the debug flag | 
| protected  java.lang.String | getDebugParameter()get the argument or null for no argument needed | 
|  java.lang.String | getExtraOptions()Gets the ExtraOptions attribute | 
| protected  java.lang.String | getExtraOptionsParameter()get any extra options or null for no argument needed | 
|  boolean | getFailOnError()query fail on error flag | 
| protected  java.lang.String | getKeyfileParameter()get the argument or null for no argument needed | 
| protected  java.lang.String | getListingParameter()turn the listing flag into a parameter for ILASM | 
| protected  java.lang.String | getOutputFileParameter()get the output file | 
| protected  java.lang.String | getResourceFileParameter()Gets the resourceFileParameter attribute of the Ilasm task | 
|  java.lang.String | getTargetType()accessor method for target type | 
| protected  java.lang.String | getTargetTypeParameter()g get the target type or null for no argument needed | 
| protected  java.lang.String | getVerboseParameter()turn the verbose flag into a parameter for ILASM | 
| protected static boolean | isFileManagedBinary(java.io.File file)test for a file being managed or not | 
| protected  boolean | notEmpty(java.lang.String s)test for a string containing something useful | 
|  void | setDebug(boolean f)set the debug flag on or off. | 
|  void | setExtraOptions(java.lang.String extraOptions)Any extra options which are not explicitly supported by this task. | 
|  void | setFailOnError(boolean b)If true, fails if ilasm tool fails. | 
|  void | setKeyfile(java.io.File keyfile)the name of a file containing a private key. | 
|  void | setListing(boolean b)If true, produce a listing (off by default). | 
|  void | setOutputFile(java.io.File params)Set the output file; identical to setDestFile | 
|  void | setOwner(java.lang.String s)Sets the Owner attribute. | 
|  void | setResourceFile(java.io.File fileName)name of resource file to include. | 
|  void | setTargetType(Ilasm.TargetTypes targetType)set the target type to one of exe|library | 
|  void | setTargetType(java.lang.String targetType)Sets the type of target, either "exe" or "library". | 
|  void | setVerbose(boolean b)If true, enable verbose ILASM output. | 
| Methods inherited from class org.apache.tools.ant.taskdefs.optional.dotnet.DotnetBaseMatchingTask | 
| addFilesAndExecute, addFilesToCommand, addSrc, buildFileList, getDestFile, getOutputFileTimestamp, getSrcDir, setDestFile, setSrcDir | 
| 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 | 
| 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 | 
| Methods inherited from class java.lang.Object | 
| clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait | 
| Field Detail | 
protected static final java.lang.String exe_name
protected static final java.lang.String file_ext
protected static final java.lang.String file_pattern
protected static final java.lang.String exe_title
protected java.lang.String targetType
protected boolean verbose
protected boolean listing
protected java.io.File resourceFile
protected boolean failOnError
protected boolean debug
protected java.lang.String extraOptions
protected java.util.Vector referenceFilesets
| Constructor Detail | 
public Ilasm()
| Method Detail | 
public void Clear()
public void setTargetType(java.lang.String targetType)
                   throws BuildException
targetType - one of exe|library|
BuildException - if target is not one of
      exe|librarypublic java.lang.String getTargetType()
protected java.lang.String getTargetTypeParameter()
public void setOwner(java.lang.String s)
s - The new Owner valueprotected boolean notEmpty(java.lang.String s)
s - any string
public void setVerbose(boolean b)
b - flag set to true for verbose onprotected java.lang.String getVerboseParameter()
public void setListing(boolean b)
b - flag set to true for listing onprotected java.lang.String getListingParameter()
public void setOutputFile(java.io.File params)
params - The new outputFile valueDotnetBaseMatchingTask.setDestFile(java.io.File)protected java.lang.String getOutputFileParameter()
public void setResourceFile(java.io.File fileName)
fileName - path to the file. Can be relative, absolute, whatever.protected java.lang.String getResourceFileParameter()
public void setFailOnError(boolean b)
b - The new failOnError valuepublic boolean getFailOnError()
public void setDebug(boolean f)
f - on/off flagpublic boolean getDebug()
protected java.lang.String getDebugParameter()
public void setKeyfile(java.io.File keyfile)
keyfile - The new keyfile valueprotected java.lang.String getKeyfileParameter()
public void setExtraOptions(java.lang.String extraOptions)
extraOptions - The new ExtraOptions valuepublic java.lang.String getExtraOptions()
protected java.lang.String getExtraOptionsParameter()
public void setTargetType(Ilasm.TargetTypes targetType)
targetType - 
public void execute()
             throws BuildException
execute in class TaskBuildException - if the assembly failed and FailOnError is truepublic void addReference(FileSet reference)
reference - protected static boolean isFileManagedBinary(java.io.File file)
| 
 | ||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||