org.apache.tools.ant.taskdefs.optional.jlink
Class JlinkTask

java.lang.Object
  extended by org.apache.tools.ant.ProjectComponent
      extended by org.apache.tools.ant.Task
          extended by org.apache.tools.ant.taskdefs.MatchingTask
              extended by org.apache.tools.ant.taskdefs.optional.jlink.JlinkTask
All Implemented Interfaces:
java.lang.Cloneable, SelectorContainer

public class JlinkTask
extends MatchingTask

This class defines objects that can link together various jar and zip files.

It is basically a wrapper for the jlink code written originally by Patrick Beard. The classes org.apache.tools.ant.taskdefs.optional.jlink.Jlink and org.apache.tools.ant.taskdefs.optional.jlink.ClassNameReader support this class.

For example:

 <jlink compress="false" outfile="out.jar"/>
   <mergefiles>
     <pathelement path="${build.dir}/mergefoo.jar"/>
     <pathelement path="${build.dir}/mergebar.jar"/>
   </mergefiles>
   <addfiles>
     <pathelement path="${build.dir}/mac.jar"/>
     <pathelement path="${build.dir}/pc.zip"/>
   </addfiles>
 </jlink>
 


Field Summary
 
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
JlinkTask()
           
 
Method Summary
 Path createAddfiles()
          Establishes the object that contains the files to be added to the output.
 Path createMergefiles()
          Establishes the object that contains the files to be merged into the output.
 void execute()
          Does the adding and merging.
 void setAddfiles(Path addfiles)
          Sets the files to be added into the output.
 void setCompress(boolean compress)
          Defines whether or not the output should be compacted.
 void setMergefiles(Path mergefiles)
          Sets the files to be merged into the output.
 void setOutfile(java.io.File outfile)
          The output file for this run of jlink.
 
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
 

Constructor Detail

JlinkTask

public JlinkTask()
Method Detail

setOutfile

public void setOutfile(java.io.File outfile)
The output file for this run of jlink. Usually a jar or zip file.

Parameters:
outfile - the output file

createMergefiles

public Path createMergefiles()
Establishes the object that contains the files to be merged into the output.

Returns:
a path to be configured

setMergefiles

public void setMergefiles(Path mergefiles)
Sets the files to be merged into the output.

Parameters:
mergefiles - a path

createAddfiles

public Path createAddfiles()
Establishes the object that contains the files to be added to the output.

Returns:
a path to be configured

setAddfiles

public void setAddfiles(Path addfiles)
Sets the files to be added into the output.

Parameters:
addfiles - a path

setCompress

public void setCompress(boolean compress)
Defines whether or not the output should be compacted.

Parameters:
compress - a boolean value

execute

public void execute()
             throws BuildException
Does the adding and merging.

Overrides:
execute in class Task
Throws:
BuildException - on error