jarlib-available Task

jarlib-available

Description

Check whether an extension is present in a fileset or an extensionSet. If the extension is present then a property is set.

Note that this task works with extensions as defined by the "Optional Package" specification. For more information about optional packages, see the document Optional Package Versioning in the documentation bundle for your Java2 Standard Edition package, in file guide/extensions/versioning.html or online at http://java.sun.com/j2se/1.3/docs/guide/extensions/versioning.html.

See the Extension and ExtensionSet documentation for further details

Parameters

Attribute	Description	Required
property	The name of property to set if extensions is available.	Yes
file	The file to check for extension	No, one of file, nested ExtensionSet or nested fileset must be present.

Parameters specified as nested elements

extension

Extension the extension to search for.

fileset

FileSets are used to select sets of files to check for extension.

extensionSet

ExtensionSets is the set of extensions to search for extension in.

Examples

Search for extension in single file

  <jarlib-available property="myext.present" file="myfile.jar">
    <extension
      extensionName="org.apache.tools.ant"
      specificationVersion="1.4.9"
      specificationVendor="Apache Software Foundation"/>
  </jarlib-available>

Search for extension in single file refencing external Extension

  <extension id="myext"
    extensionName="org.apache.tools.ant"
    specificationVersion="1.4.9"
    specificationVendor="Apache Software Foundation"/>

  <jarlib-available property="myext.present" file="myfile.jar">
    <extension refid="myext"/>
  </jarlib-available>

Search for extension in fileset

  <extension id="myext"
    extensionName="org.apache.tools.ant"
    specificationVersion="1.4.9"
    specificationVendor="Apache Software Foundation"/>

  <jarlib-available property="myext.present">
    <extension refid="myext"/>
    <fileset dir="lib">
      <include name="*.jar"/>
    </fileset>
  </jarlib-available>

Search for extension in extensionSet

  <extension id="myext"
    extensionName="org.apache.tools.ant"
    specificationVersion="1.4.9"
    specificationVendor="Apache Software Foundation"/>

  <jarlib-available property="myext.present">
    <extension refid="myext"/>
    <extensionSet id="exts3">
      <libfileset
        includeUrl="false"
        includeImpl="true"
        dir="lib">
        <include name="*.jar"/>
      </libfileset>
    </extensionSet>
  </jarlib-available>