Description
Adds a task definition to the current project, such that this new task can be
used in the current project. Two attributes are needed, the name that identifies
this task uniquely, and the full name of the class (including the packages) that
implements this task.
You can also define a group of tasks at once using the file or
resource attributes. These attributes point to files in the format of
Java property files. Each line defines a single task in the
format:
taskname=fully.qualified.java.classname
Taskdef should be used to add your own tasks to the system. See also "Writing your own task".
Parameters
Attribute |
Description |
Required |
name |
the name of the task |
Yes, unless file or resource have
been specified. |
classname |
the full class name implementing the task |
Yes, unless file or resource have
been specified. |
file |
Name of the property file to load
taskname/classname pairs from. |
No |
resource |
Name of the property resource to load
taskname/classname pairs from. |
No |
classpath | the classpath to
use when looking up classname or
resource . |
No |
classpathref |
Reference to a classpath to
use when looking up classname or
resource . |
No |
loaderRef | the name of the loader that is
used to load the class, constructed from the specified classpath. Use this to
allow multiple tasks/types to be loaded with the same loader, so they can call
each other. ( introduced in ant1.5 ) |
No |
Parameters specified as nested elements
classpath
Taskdef 's classpath attribute is a PATH like structure and can also be set via a nested
classpath element.
Examples
<taskdef name="myjavadoc" classname="com.mydomain.JavadocTask"/>
makes a task called myjavadoc available to Ant. The class com.mydomain.JavadocTask
implements the task.
Copyright © 2000-2002 Apache Software Foundation. All rights
Reserved.
|