<extract-archive>
Extracts the contents of the archive specified by
LOCATION and writes them to the chosen directory.
| Name | XPath | Description | Reagent Type | Expected Type | Required |
|---|---|---|---|---|---|
| CONTEXT | @context | Optional context from which missing elements of the LOCATION will be inferred if it is relative. The default is the value of the 'Attributes.CONTEXT' request attribute (if present) or the directory from which Java is executing (otherwise). | PHRASE | java.lang.String | No |
| LOCATION | @location | Optional location of a resource; if omitted, the value of the 'Attributes.LOCATION' request attribute will be used. LOCATION may be a filesystem path or a URL, and may be absolute or relative; if a relative value is provided, it will be resolved based on the value of CONTEXT. | PHRASE | java.lang.String | No |
| TO_DIR | @to-dir | Optional file system directory to which the specified archive will be extracted. It may be absolute or relative. If relative, it will be evaluated from the directory in which Java is executing. | PHRASE | java.lang.String | No |
Extracts Apache Tomcat version 6.0.16 to the current user's home directory:
<extract-archive location="apache-tomcat-6.0.16.zip" to-dir="${sysprop(user.home)}"/>