It also removes a number of small errors in zip task. Deprecated <prefixedfileset> element of war in favour of normal <fileset> element in zip Submitted By: "Rosen, Alex" <arosen@silverstream.com> git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@268344 13f79535-47bb-0310-9956-ffa450edef68master
@@ -2725,6 +2725,11 @@ You should not include <samp>META-INF/MANIFEST.MF</samp> in your set of files. | |||
If <code>create</code> (the default), the JAR is created anyway with only a manifest. | |||
If <code>skip</code>, the JAR is not created and a warning is issued. | |||
If <code>fail</code>, the JAR is not created and the build is halted with an error. | |||
<p>(The Jar task is a shortcut for specifying the manifest file of a JAR file. | |||
The same thing can be accomplished by using the <i>fullpath</i> | |||
attribute of the filesets in a Zip task. The one difference is that if the | |||
<i>manifest</i> attribute is not specified, the Jar task will | |||
include an empty one for you.)</p> | |||
</p> | |||
<h3>Parameters</h3> | |||
<table border="1" cellpadding="2" cellspacing="0"> | |||
@@ -2791,13 +2796,13 @@ If <code>fail</code>, the JAR is not created and the build is halted with an err | |||
</table> | |||
<h3>Examples</h3> | |||
<pre> <jar jarfile="${dist}/lib/app.jar" basedir="${build}/classes" /></pre> | |||
<p>jars all files in the <code>${build}/classes</code> directory in a file | |||
<p>jars all files in the <code>${build}/classes</code> directory into a file | |||
called <code>app.jar</code> in the <code>${dist}/lib</code> directory.</p> | |||
<pre> <jar jarfile="${dist}/lib/app.jar" | |||
basedir="${build}/classes" | |||
excludes="**/Test.class" | |||
/></pre> | |||
<p>jars all files in the <code>${build}/classes</code> directory in a file | |||
<p>jars all files in the <code>${build}/classes</code> directory into a file | |||
called <code>app.jar</code> in the <code>${dist}/lib</code> directory. Files | |||
with the name <code>Test.class</code> are excluded.</p> | |||
<pre> <jar jarfile="${dist}/lib/app.jar" | |||
@@ -2805,7 +2810,7 @@ with the name <code>Test.class</code> are excluded.</p> | |||
includes="mypackage/test/**" | |||
excludes="**/Test.class" | |||
/></pre> | |||
<p>jars all files in the <code>${build}/classes</code> directory in a file | |||
<p>jars all files in the <code>${build}/classes</code> directory into a file | |||
called <code>app.jar</code> in the <code>${dist}/lib</code> directory. Only | |||
files under the directory <code>mypackage/test</code> are used, and files with | |||
the name <code>Test.class</code> are excluded.</p> | |||
@@ -2816,7 +2821,7 @@ the name <code>Test.class</code> are excluded.</p> | |||
<fileset dir="${src}/resources"/> | |||
</jar></pre> | |||
<p>jars all files in the <code>${build}/classes</code> directory and also | |||
in the <code>${src}/resources</code> directory together in a file | |||
in the <code>${src}/resources</code> directory together into a file | |||
called <code>app.jar</code> in the <code>${dist}/lib</code> directory. | |||
Files with the name <code>Test.class</code> are excluded. | |||
If there are files such as <code>${build}/classes/mypackage/MyClass.class</code> | |||
@@ -4434,14 +4439,14 @@ task to come up with a .tar.gz package.</p> | |||
<h3>Examples</h3> | |||
<pre> <tar tarfile="${dist}/manual.tar" basedir="htdocs/manual" /> | |||
<gzip zipfile="${dist}/manual.tar.gz" src="${dist}/manual.tar" /></pre> | |||
<p>tars all files in the <code>htdocs/manual</code> directory in a file called <code>manual.tar</code> | |||
<p>tars all files in the <code>htdocs/manual</code> directory into a file called <code>manual.tar</code> | |||
in the <code>${dist}</code> directory, then applies the gzip task to compress | |||
it.</p> | |||
<pre> <tar tarfile="${dist}/manual.tar" | |||
basedir="htdocs/manual" | |||
excludes="mydocs/**, **/todo.html" | |||
/></pre> | |||
<p>tars all files in the <code>htdocs/manual</code> directory in a file called <code>manual.tar</code> | |||
<p>tars all files in the <code>htdocs/manual</code> directory into a file called <code>manual.tar</code> | |||
in the <code>${dist}</code> directory. Files in the directory <code>mydocs</code>, | |||
or files with the name <code>todo.html</code> are excluded.</p> | |||
<hr> | |||
@@ -4779,10 +4784,10 @@ carried from tarfile.</p> | |||
<p>An extension of the <a href="#jar">Jar</a> task with special | |||
treatment for files that should end up in the | |||
<code>WEB-INF/lib</code>, <code>WEB-INF/classes</code> or | |||
<code>WEB-INF</code> directories of the Web Application Archive. It | |||
also gives you more control over where your files end up in the | |||
archive by means of its nested <code>prefixedfileset</code> | |||
element.</p> | |||
<code>WEB-INF</code> directories of the Web Application Archive. | |||
<p>(The War task is a shortcut for specifying the particular layout of a WAR file. | |||
The same thing can be accomplished by using the <i>prefix</i> and <i>fullpath</i> | |||
attributes of the filesets in a Zip or Jar task.)</p> | |||
<h3>Parameters</h3> | |||
<table border="1" cellpadding="2" cellspacing="0"> | |||
<tr> | |||
@@ -4866,60 +4871,6 @@ href="#fileset">FileSet</a>. All files included in this fileset will | |||
end up in the <code>WEB-INF</code> directory of the war file. If this | |||
fileset includes a file named <code>web.xml</code>, the file is | |||
ignored and you will get a warning.</p> | |||
<h4>prefixedfileset</h4> | |||
<p>The nested <code>prefixedfileset</code> element specifies a <a | |||
href="#fileset">FileSet</a> with an additional prefix attribute. All | |||
files included in this fileset will end up in the <em>prefix</em> | |||
directory of the war file, where <em>prefix</em> is the value of the | |||
<code>prefix</code> attribute.</p> | |||
<table border="1" cellpadding="2" cellspacing="0"> | |||
<tr> | |||
<td valign="top"><b>Attribute</b></td> | |||
<td valign="top"><b>Description</b></td> | |||
<td align="center" valign="top"><b>Required</b></td> | |||
</tr> | |||
<tr> | |||
<td valign="top">prefix</td> | |||
<td valign="top">The prefix directory to add to each filename when | |||
adding it to the archive. Default is none.</td> | |||
<td valign="top" align="center">No</td> | |||
</tr> | |||
<tr> | |||
<td valign="top">dir</td> | |||
<td valign="top">The root of the directory tree of this FileSet.</td> | |||
<td valign="top" align="center">Yes</td> | |||
</tr> | |||
<tr> | |||
<td valign="top">defaultexcludes</td> | |||
<td valign="top">indicates whether default excludes should be used or not | |||
("yes"/"no"). Default excludes are used when omitted.</td> | |||
<td valign="top" align="center">No</td> | |||
</tr> | |||
<tr> | |||
<td valign="top">includes</td> | |||
<td valign="top">comma separated list of patterns of files that must be | |||
included. All files are included when omitted.</td> | |||
<td valign="top" align="center">No</td> | |||
</tr> | |||
<tr> | |||
<td valign="top">includesfile</td> | |||
<td valign="top">the name of a file. Each line of this file is | |||
taken to be an include pattern</td> | |||
<td valign="top" align="center">No</td> | |||
</tr> | |||
<tr> | |||
<td valign="top">excludes</td> | |||
<td valign="top">comma separated list of patterns of files that must be | |||
excluded. No files (except default excludes) are excluded when omitted.</td> | |||
<td valign="top" align="center">No</td> | |||
</tr> | |||
<tr> | |||
<td valign="top">excludesfile</td> | |||
<td valign="top">the name of a file. Each line of this file is | |||
taken to be an exclude pattern</td> | |||
<td valign="top" align="center">No</td> | |||
</tr> | |||
</table> | |||
<h3>Examples</h3> | |||
<p>Assume the following structure in the project's base directory: | |||
<pre> | |||
@@ -4941,7 +4892,7 @@ then the war file <code>myapp.war</code> created with | |||
<exclude name="jdbc1.jar" /> | |||
</lib> | |||
<classes dir="build/main" /> | |||
<prefixedfileset dir="src/graphics/images/gifs" | |||
<fileset dir="src/graphics/images/gifs" | |||
prefix="images"/> | |||
</war> | |||
</pre> | |||
@@ -4986,6 +4937,13 @@ if <code>basedir</code> is set. You may use any mixture of the implicit file set | |||
and optional subelements like <code><include></code>); explicit nested | |||
<code><fileset></code> elements so long as at least one fileset total is specified. The ZIP file will | |||
only reflect the relative paths of files <em>within</em> each fileset.</p> | |||
<p>Inside of <code><zip></code> elements, nested filesets may include one of two special attributes: | |||
<i>prefix</i> or <i>fullpath</i>. These attributes modify the location of the files when they are placed | |||
inside the archive. If the <i>prefix</i> attribute is set, all the files in the fileset are prefixed | |||
with that path in the archive. If the <i>fullpath</i> attribute is set, the file described by the filset is placed at that | |||
exact location in the archive. (The <i>fullpath</i> attribute can only be set for filesets that | |||
represent a single file. The <i>prefix</i> and <i>fullpath</i> attributes cannot both be set on the | |||
same fileset.)</p> | |||
<p>The <code>whenempty</code> parameter controls what happens when no files match. | |||
If <code>skip</code> (the default), the ZIP is not created and a warning is issued. | |||
If <code>fail</code>, the ZIP is not created and the build is halted with an error. | |||
@@ -5053,31 +5011,36 @@ which should be recognized as such by compliant ZIP manipulation tools.</p> | |||
<pre> <zip zipfile="${dist}/manual.zip" | |||
basedir="htdocs/manual" | |||
/></pre> | |||
<p>zips all files in the <code>htdocs/manual</code> directory in a file called <code>manual.zip</code> | |||
<p>zips all files in the <code>htdocs/manual</code> directory into a file called <code>manual.zip</code> | |||
in the <code>${dist}</code> directory.</p> | |||
<pre> <zip zipfile="${dist}/manual.zip" | |||
basedir="htdocs/manual" | |||
excludes="mydocs/**, **/todo.html" | |||
/></pre> | |||
<p>zips all files in the <code>htdocs/manual</code> directory in a file called <code>manual.zip</code> | |||
in the <code>${dist}</code> directory. Files in the directory <code>mydocs</code>, | |||
<p>zips all files in the <code>htdocs/manual</code> directory. Files in the directory <code>mydocs</code>, | |||
or files with the name <code>todo.html</code> are excluded.</p> | |||
<pre> <zip zipfile="${dist}/manual.zip" | |||
basedir="htdocs/manual" | |||
includes="api/**/*.html" | |||
excludes="**/todo.html" | |||
/></pre> | |||
<p>zips all files in the <code>htdocs/manual</code> directory in a file called <code>manual.zip</code> | |||
in the <code>${dist}</code> directory. Only html files under the directory <code>api</code> | |||
<p>zips all files in the <code>htdocs/manual</code> directory. Only html files under the directory <code>api</code> | |||
are zipped, and files with the name <code>todo.html</code> are excluded.</p> | |||
<pre> <zip zipfile="${dist}/manual.zip"> | |||
<fileset dir="htdocs/manual"/> | |||
<fileset dir="." includes="ChangeLog.txt"/> | |||
</zip></pre> | |||
<p>zips all files in the <code>htdocs/manual</code> directory in a file called <code>manual.zip</code> | |||
in the <code>${dist}</code> directory, and also adds the file <code>ChangeLog.txt</code> in the | |||
<p>zips all files in the <code>htdocs/manual</code> directory, and also adds the file <code>ChangeLog.txt</code> in the | |||
current directory. <code>ChangeLog.txt</code> will be added to the top of the ZIP file, just as if | |||
it had been located at <code>htdocs/manual/ChangeLog.txt</code>.</p> | |||
<pre> <zip zipfile="${dist}/manual.zip"> | |||
<fileset dir="htdocs/manual" prefix="docs/user-guide"/> | |||
<fileset dir="." includes="ChangeLog27.txt" fullpath="docs/ChangeLog.txt"/> | |||
</zip></pre> | |||
<p>zips all files in the <code>htdocs/manual</code> directory into the <code>docs/user-guide</code> directory | |||
in the archive, and also adds the file <code>ChangeLog27.txt</code> in the | |||
current directory as <code>docs/ChangeLog.txt</code>. For example, the archive might end up containing two files: | |||
<code>docs/user-guide/html/index.html</code> and <code>docs/ChangeLog.txt</code></p> | |||
<hr> | |||
<h2><a name="optionaltasks">Optional tasks</a></h2> | |||
@@ -5188,7 +5151,7 @@ supports all attributes of <code><fileset></code> | |||
basedir="htdocs/manual" | |||
/> | |||
</pre></blockquote> | |||
<p>cabs all files in the htdocs/manual directory in a file called | |||
<p>cabs all files in the htdocs/manual directory into a file called | |||
manual.cab in the ${dist} directory.</p> | |||
<blockquote><pre> | |||
<cab cabfile="${dist}/manual.cab" | |||
@@ -5196,7 +5159,7 @@ manual.cab in the ${dist} directory.</p> | |||
excludes="mydocs/**, **/todo.html" | |||
/> | |||
</pre></blockquote> | |||
<p>cabs all files in the htdocs/manual directory in a file called | |||
<p>cabs all files in the htdocs/manual directory into a file called | |||
manual.cab in the ${dist} directory. Files in the directory mydocs, | |||
or files with the name todo.html are excluded.</p> | |||
<blockquote><pre> | |||
@@ -5207,7 +5170,7 @@ or files with the name todo.html are excluded.</p> | |||
verbose="yes" | |||
/> | |||
</pre></blockquote> | |||
<p>cab all files in the htdocs/manual directory in a file called | |||
<p>cab all files in the htdocs/manual directory into a file called | |||
manual.cab in the ${dist} directory. Only html files under the | |||
directory api are archived, and files with the name todo.html are | |||
excluded. Output from the cabarc tool is displayed in the build | |||
@@ -68,35 +68,45 @@ import java.util.zip.*; | |||
public class Jar extends Zip { | |||
private File manifest; | |||
private boolean manifestAdded; | |||
public Jar() { | |||
super(); | |||
archiveType = "jar"; | |||
emptyBehavior = "create"; | |||
} | |||
public void execute() { | |||
if (manifest != null && !manifest.exists()) | |||
throw new BuildException("Manifest file: " + manifest + " does not exists."); | |||
super.execute(); | |||
} | |||
public void setJarfile(File jarFile) { | |||
super.setZipfile(jarFile); | |||
} | |||
/** | |||
* Adds a set of files (nested fileset attribute). | |||
*/ | |||
public void addPrefixedfileset(PrefixedFileSet set) { | |||
log("Warning: Prefixfileset is a deprecated feature. The fileset subelement can be used in it's place", Project.MSG_WARN); | |||
addFileset(set); | |||
} | |||
public void setManifest(File manifestFile) { | |||
manifest = manifestFile; | |||
if (!manifest.exists()) | |||
throw new BuildException("Manifest file: " + manifest + " does not exist."); | |||
// Create a PrefixedFileSet for this file, and pass it up. | |||
PrefixedFileSet fs = new PrefixedFileSet(); | |||
fs.setDir(new File(manifest.getParent())); | |||
fs.setIncludes(manifest.getName()); | |||
fs.setFullpath("META-INF/MANIFEST.MF"); | |||
super.addFileset(fs); | |||
} | |||
protected void initZipOutputStream(ZipOutputStream zOut) | |||
throws IOException, BuildException | |||
{ | |||
// add manifest first | |||
if (manifest != null) { | |||
zipDir(new File(manifest.getParent()), zOut, "META-INF/"); | |||
super.zipFile(manifest, zOut, "META-INF/MANIFEST.MF"); | |||
} else { | |||
// If no manifest is specified, add the default one. | |||
if (manifest == null) { | |||
String s = "/org/apache/tools/ant/defaultManifest.mf"; | |||
InputStream in = this.getClass().getResourceAsStream(s); | |||
if ( in == null ) | |||
@@ -104,53 +114,27 @@ public class Jar extends Zip { | |||
zipDir(null, zOut, "META-INF/"); | |||
zipFile(in, zOut, "META-INF/MANIFEST.MF", System.currentTimeMillis()); | |||
} | |||
} | |||
protected boolean isUpToDate(FileScanner[] scanners, File zipFile) throws BuildException | |||
{ | |||
File[] files = grabFiles(scanners); | |||
if (manifest != null) { | |||
// just add the manifest file to the mix | |||
DirectoryScanner ds = new DirectoryScanner(); | |||
ds.setBasedir(new File(manifest.getParent())); | |||
ds.setIncludes(new String[] {manifest.getName()}); | |||
ds.scan(); | |||
FileScanner[] myScanners = new FileScanner[scanners.length+1]; | |||
System.arraycopy(scanners, 0, myScanners, 0, scanners.length); | |||
myScanners[scanners.length] = ds; | |||
boolean retval = super.isUpToDate(myScanners, zipFile); | |||
if (!retval && files.length == 0) { | |||
log("Note: creating empty "+archiveType+" archive " + zipFile, | |||
Project.MSG_INFO); | |||
} | |||
return retval; | |||
} else if (emptyBehavior.equals("create") && files.length == 0) { | |||
log("Note: creating empty "+archiveType+" archive " + zipFile, | |||
Project.MSG_INFO); | |||
return false; | |||
} else { | |||
// all other cases are handled correctly by Zip's method | |||
return super.isUpToDate(scanners, zipFile); | |||
} | |||
super.initZipOutputStream(zOut); | |||
} | |||
protected void zipFile(File file, ZipOutputStream zOut, String vPath) | |||
throws IOException | |||
{ | |||
// We already added a META-INF/MANIFEST.MF | |||
if (!vPath.equalsIgnoreCase("META-INF/MANIFEST.MF")) { | |||
super.zipFile(file, zOut, vPath); | |||
// If the file being added is META-INF/MANIFEST.MF, we warn if it's not the | |||
// one specified in the "manifest" attribute - or if it's being added twice, | |||
// meaning the same file is specified by the "manifeset" attribute and in | |||
// a <fileset> element. | |||
if (vPath.equalsIgnoreCase("META-INF/MANIFEST.MF")) { | |||
if (manifest == null || !manifest.equals(file) || manifestAdded) { | |||
log("Warning: selected "+archiveType+" files include a META-INF/MANIFEST.MF which will be ignored " + | |||
"(please use manifest attribute to "+archiveType+" task)", Project.MSG_WARN); | |||
} else { | |||
super.zipFile(file, zOut, vPath); | |||
manifestAdded = true; | |||
} | |||
} else { | |||
log("Warning: selected "+archiveType+" files include a META-INF/MANIFEST.MF which will be ignored " + | |||
"(please use manifest attribute to "+archiveType+" task)", Project.MSG_WARN); | |||
super.zipFile(file, zOut, vPath); | |||
} | |||
} | |||
} |
@@ -69,10 +69,7 @@ import java.util.zip.*; | |||
public class War extends Jar { | |||
private File deploymentDescriptor; | |||
private Vector libFileSets = new Vector(); | |||
private Vector classesFileSets = new Vector(); | |||
private Vector webInfFileSets = new Vector(); | |||
private boolean descriptorAdded; | |||
public War() { | |||
super(); | |||
@@ -85,85 +82,64 @@ public class War extends Jar { | |||
} | |||
public void setWebxml(File descr) { | |||
deploymentDescriptor = descr; | |||
deploymentDescriptor = descr; | |||
if (!deploymentDescriptor.exists()) | |||
throw new BuildException("Deployment descriptor: " + deploymentDescriptor + " does not exist."); | |||
// Create a PrefixedFileSet for this file, and pass it up. | |||
PrefixedFileSet fs = new PrefixedFileSet(); | |||
fs.setDir(new File(deploymentDescriptor.getParent())); | |||
fs.setIncludes(deploymentDescriptor.getName()); | |||
fs.setFullpath("WEB-INF/web.xml"); | |||
super.addFileset(fs); | |||
} | |||
public void addLib(FileSet fs) { | |||
libFileSets.addElement(fs); | |||
public void addLib(PrefixedFileSet fs) { | |||
// We just set the prefix for this fileset, and pass it up. | |||
fs.setPrefix("WEB-INF/lib/"); | |||
super.addFileset(fs); | |||
} | |||
public void addClasses(FileSet fs) { | |||
classesFileSets.addElement(fs); | |||
public void addClasses(PrefixedFileSet fs) { | |||
// We just set the prefix for this fileset, and pass it up. | |||
fs.setPrefix("WEB-INF/classes/"); | |||
super.addFileset(fs); | |||
} | |||
public void addWebinf(FileSet fs) { | |||
webInfFileSets.addElement(fs); | |||
public void addWebinf(PrefixedFileSet fs) { | |||
// We just set the prefix for this fileset, and pass it up. | |||
fs.setPrefix("WEB-INF/"); | |||
super.addFileset(fs); | |||
} | |||
/** | |||
* Add the deployment descriptor as well as all files added the | |||
* special way of nested lib, classes or webinf filesets. | |||
*/ | |||
protected void initZipOutputStream(ZipOutputStream zOut) | |||
throws IOException, BuildException | |||
{ | |||
// add deployment descriptor first | |||
if (deploymentDescriptor != null) { | |||
zipDir(new File(deploymentDescriptor.getParent()), zOut, | |||
"WEB-INF/"); | |||
super.zipFile(deploymentDescriptor, zOut, "WEB-INF/web.xml"); | |||
} else { | |||
throw new BuildException("webxml attribute is required", location); | |||
} | |||
addFiles(libFileSets, zOut, "WEB-INF/lib/"); | |||
addFiles(classesFileSets, zOut, "WEB-INF/classes/"); | |||
addFiles(webInfFileSets, zOut, "WEB-INF/"); | |||
super.initZipOutputStream(zOut); | |||
} | |||
protected boolean isUpToDate(FileScanner[] scanners, File zipFile) throws BuildException | |||
{ | |||
// If no webxml file is specified, it's an error. | |||
if (deploymentDescriptor == null) { | |||
throw new BuildException("webxml attribute is required", location); | |||
} | |||
// just add some Scanners for our filesets and web.xml and let | |||
// Jar/Zip do the rest of the work | |||
FileScanner[] myScanners = new FileScanner[scanners.length | |||
+ 1 // web.xml | |||
+ libFileSets.size() | |||
+ classesFileSets.size() | |||
+ webInfFileSets.size()]; | |||
System.arraycopy(scanners, 0, myScanners, 0, scanners.length); | |||
DirectoryScanner ds = new DirectoryScanner(); | |||
ds.setBasedir(new File(deploymentDescriptor.getParent())); | |||
ds.setIncludes(new String[] {deploymentDescriptor.getName()}); | |||
ds.scan(); | |||
myScanners[scanners.length] = ds; | |||
addScanners(myScanners, scanners.length+1, libFileSets); | |||
addScanners(myScanners, scanners.length+1+libFileSets.size(), | |||
classesFileSets); | |||
addScanners(myScanners, scanners.length+1+libFileSets.size()+classesFileSets.size(), | |||
webInfFileSets); | |||
return super.isUpToDate(myScanners, zipFile); | |||
super.initZipOutputStream(zOut); | |||
} | |||
protected void zipFile(File file, ZipOutputStream zOut, String vPath) | |||
throws IOException | |||
{ | |||
// We already added a WEB-INF/web.xml | |||
if (!vPath.equalsIgnoreCase("WEB-INF/web.xml")) { | |||
super.zipFile(file, zOut, vPath); | |||
// If the file being added is WEB-INF/web.xml, we warn if it's not the | |||
// one specified in the "webxml" attribute - or if it's being added twice, | |||
// meaning the same file is specified by the "webxml" attribute and in | |||
// a <fileset> element. | |||
if (vPath.equalsIgnoreCase("WEB-INF/web.xml")) { | |||
if (deploymentDescriptor == null || !deploymentDescriptor.equals(file) || descriptorAdded) { | |||
log("Warning: selected "+archiveType+" files include a WEB-INF/web.xml which will be ignored " + | |||
"(please use webxml attribute to "+archiveType+" task)", Project.MSG_WARN); | |||
} else { | |||
super.zipFile(file, zOut, vPath); | |||
descriptorAdded = true; | |||
} | |||
} else { | |||
log("Warning: selected "+archiveType+" files include a WEB-INF/web.xml which will be ignored " + | |||
"(please use webxml attribute to "+archiveType+" task)", Project.MSG_WARN); | |||
super.zipFile(file, zOut, vPath); | |||
} | |||
} | |||
} | |||
} |
@@ -82,8 +82,7 @@ public class Zip extends MatchingTask { | |||
protected String emptyBehavior = "skip"; | |||
private Vector filesets = new Vector (); | |||
private Hashtable addedDirs = new Hashtable(); | |||
private Vector locFileSets = new Vector(); | |||
/** | |||
* This is the name/location of where to | |||
* create the .zip file. | |||
@@ -110,26 +109,32 @@ public class Zip extends MatchingTask { | |||
/** | |||
* Adds a set of files (nested fileset attribute). | |||
*/ | |||
public void addFileset(FileSet set) { | |||
public void addFileset(PrefixedFileSet set) { | |||
filesets.addElement(set); | |||
} | |||
/** | |||
* FileSet with an additional prefix attribute to specify the | |||
* location we want to move the files to (inside the archive). | |||
* Or, if this FileSet represents only a single file, then the | |||
* fullpath attribute can be set, which specifies the full path | |||
* that the file should have when it is placed in the archive. | |||
*/ | |||
public static class PrefixedFileSet extends FileSet { | |||
private String prefix = ""; | |||
private String fullpath = ""; | |||
public void setPrefix(String loc) { | |||
prefix = loc; | |||
} | |||
public String getPrefix() {return prefix;} | |||
} | |||
public void addPrefixedFileSet(PrefixedFileSet fs) { | |||
locFileSets.addElement(fs); | |||
public void setFullpath(String loc) { | |||
fullpath = loc; | |||
} | |||
public String getFullpath() {return fullpath;} | |||
} | |||
/** | |||
@@ -150,8 +155,7 @@ public class Zip extends MatchingTask { | |||
} | |||
public void execute() throws BuildException { | |||
if (baseDir == null && filesets.size() == 0 && | |||
locFileSets.size() == 0 && "zip".equals(archiveType)) { | |||
if (baseDir == null && filesets.size() == 0 && "zip".equals(archiveType)) { | |||
throw new BuildException( "basedir attribute must be set, or at least " + | |||
"one fileset or prefixedfileset must be given!" ); | |||
} | |||
@@ -160,6 +164,7 @@ public class Zip extends MatchingTask { | |||
throw new BuildException("You must specify the " + archiveType + " file to create!"); | |||
} | |||
// Create the scanners to pass to isUpToDate(). | |||
Vector dss = new Vector (); | |||
if (baseDir != null) | |||
dss.addElement(getDirectoryScanner(baseDir)); | |||
@@ -168,11 +173,9 @@ public class Zip extends MatchingTask { | |||
dss.addElement (fs.getDirectoryScanner(project)); | |||
} | |||
int dssSize = dss.size(); | |||
FileScanner[] scanners = new FileScanner[dssSize + locFileSets.size()]; | |||
FileScanner[] scanners = new FileScanner[dssSize]; | |||
dss.copyInto(scanners); | |||
addScanners(scanners, dssSize, locFileSets); | |||
// quick exit if the target is up to date | |||
// can also handle empty archives | |||
if (isUpToDate(scanners, zipFile)) return; | |||
@@ -190,13 +193,12 @@ public class Zip extends MatchingTask { | |||
} | |||
initZipOutputStream(zOut); | |||
addPrefixedFiles(locFileSets, zOut); | |||
for (int j = 0; j < dssSize; j++) { | |||
addFiles(scanners[j], zOut, ""); | |||
// Add the implicit fileset to the archive. | |||
if (baseDir != null) | |||
addFiles(getDirectoryScanner(baseDir), zOut, "", ""); | |||
// Add the explicit filesets to the archive. | |||
addFiles(filesets, zOut); | |||
success = true; | |||
} | |||
} finally { | |||
// Close the output stream. | |||
try { | |||
@@ -225,18 +227,6 @@ public class Zip extends MatchingTask { | |||
} | |||
} | |||
/** | |||
* Add a DirectoryScanner for each FileSet included in fileSets to scanners | |||
* starting with index startIndex. | |||
*/ | |||
protected void addScanners(FileScanner[] scanners, int startIndex, | |||
Vector fileSets) { | |||
for (int i=0; i<fileSets.size(); i++) { | |||
FileSet fs = (FileSet) fileSets.elementAt(i); | |||
scanners[startIndex+i] = fs.getDirectoryScanner(project); | |||
} | |||
} | |||
/** | |||
* Add all files of the given FileScanner to the ZipOutputStream | |||
* prependig the given prefix to each filename. | |||
@@ -244,11 +234,16 @@ public class Zip extends MatchingTask { | |||
* <p>Ensure parent directories have been added as well. | |||
*/ | |||
protected void addFiles(FileScanner scanner, ZipOutputStream zOut, | |||
String prefix) throws IOException { | |||
String prefix, String fullpath) throws IOException { | |||
if (prefix.length() > 0 && fullpath.length() > 0) | |||
throw new BuildException("Both prefix and fullpath attributes may not be set on the same fileset."); | |||
File thisBaseDir = scanner.getBasedir(); | |||
// directories that matched include patterns | |||
String[] dirs = scanner.getIncludedDirectories(); | |||
if (dirs.length > 0 && fullpath.length() > 0) | |||
throw new BuildException("fullpath attribute may only be specified for filesets that specify a single file."); | |||
for (int i = 0; i < dirs.length; i++) { | |||
String name = dirs[i].replace(File.separatorChar,'/'); | |||
if (!name.endsWith("/")) { | |||
@@ -259,11 +254,23 @@ public class Zip extends MatchingTask { | |||
// files that matched include patterns | |||
String[] files = scanner.getIncludedFiles(); | |||
if (files.length > 1 && fullpath.length() > 0) | |||
throw new BuildException("fullpath attribute may only be specified for filesets that specify a single file."); | |||
for (int i = 0; i < files.length; i++) { | |||
File f = new File(thisBaseDir, files[i]); | |||
String name = files[i].replace(File.separatorChar,'/'); | |||
addParentDirs(thisBaseDir, name, zOut, prefix); | |||
zipFile(f, zOut, prefix+name); | |||
if (fullpath.length() > 0) | |||
{ | |||
// Add this file at the specified location. | |||
addParentDirs(null, fullpath, zOut, ""); | |||
zipFile(f, zOut, fullpath); | |||
} | |||
else | |||
{ | |||
// Add this file with the specified prefix. | |||
String name = files[i].replace(File.separatorChar,'/'); | |||
addParentDirs(thisBaseDir, name, zOut, prefix); | |||
zipFile(f, zOut, prefix+name); | |||
} | |||
} | |||
} | |||
@@ -477,27 +484,15 @@ public class Zip extends MatchingTask { | |||
} | |||
} | |||
/** | |||
* Iterate over the given Vector of filesets and add all files to the | |||
* ZipOutputStream using the given prefix. | |||
*/ | |||
protected void addFiles(Vector v, ZipOutputStream zOut, String prefix) | |||
throws IOException { | |||
for (int i=0; i<v.size(); i++) { | |||
FileSet fs = (FileSet) v.elementAt(i); | |||
DirectoryScanner ds = fs.getDirectoryScanner(project); | |||
addFiles(ds, zOut, prefix); | |||
} | |||
} | |||
/** | |||
* Iterate over the given Vector of prefixedfilesets and add | |||
* all files to the ZipOutputStream using the given prefix. | |||
*/ | |||
protected void addPrefixedFiles(Vector v, ZipOutputStream zOut) | |||
protected void addFiles(Vector filesets, ZipOutputStream zOut) | |||
throws IOException { | |||
for (int i=0; i<v.size(); i++) { | |||
PrefixedFileSet fs = (PrefixedFileSet) v.elementAt(i); | |||
// Add each fileset in the Vector. | |||
for (int i = 0; i<filesets.size(); i++) { | |||
PrefixedFileSet fs = (PrefixedFileSet) filesets.elementAt(i); | |||
DirectoryScanner ds = fs.getDirectoryScanner(project); | |||
String prefix = fs.getPrefix(); | |||
if (prefix.length() > 0 | |||
@@ -505,11 +500,17 @@ public class Zip extends MatchingTask { | |||
&& !prefix.endsWith("\\")) { | |||
prefix += "/"; | |||
} | |||
String fullpath = fs.getFullpath(); | |||
// Need to manually add either fullpath's parent directory, or | |||
// the prefix directory, to the archive. | |||
if (prefix.length() > 0) { | |||
addParentDirs(null, prefix, zOut, ""); | |||
zipDir(null, zOut, prefix); | |||
} | |||
addFiles(ds, zOut, prefix); | |||
} else if (fullpath.length() > 0) { | |||
addParentDirs(null, fullpath, zOut, ""); | |||
} | |||
// Add the fileset. | |||
addFiles(ds, zOut, prefix, fullpath); | |||
} | |||
} | |||
} |