Apache Ant User Manual

Unjar/Untar/Unwar/Unzip

Description

Unzips a zip-, war-, tar- or jarfile.

For JDK 1.1 "last modified time" field is set to current time instead of being carried from the archive file.

PatternSets are used to select files to extract from the archive. If no patternset is used, all files are extracted.

FileSets may be used used to select archived files to perform unarchival upon.

File permissions will not be restored on extracted files.

The untar task recognizes the long pathname entries used by GNU tar.

Parameters

Attribute	Description	Required
src	archive file to expand.	Yes, if filesets are not used.
dest	directory where to store the expanded files.	Yes, if outfile is not specified.
overwrite	Overwrite files, even if they are newer than the corresponding entries in the archive (true or false, default is true).	No
outfile	List the contents of the archive into this file.	Yes, if dest is not specified.
verbose	Include file details when listing contents of the archive into outfile? Defaults to false.	No

Examples

<unzip src="${tomcat_src}/tools-src.zip" dest="${tools.home}" />

<gunzip src="tools.tar.gz"/> <untar src="tools.tar" dest="${tools.home}"/>

<unzip src="${tomcat_src}/tools-src.zip"
       dest="${tools.home}"
       outfile="${outfile}"
       vebose="on">
    <patternset>
        <include name="**/*.java"/>
        <exclude name="**/Test*.java"/>
    <patternset/>
<unzip/>

<unzip dest="${tools.home}"
       outfile="${outfile}"
       vebose="on">
    <patternset>
        <include name="**/*.java"/>
        <exclude name="**/Test*.java"/>
    <patternset/>
    <fileset dir=".">
        <include name="**/*.zip"/>
        <exclude name="**/tmp*.zip"/>
    <fileset/>
<unzip/>