org.apache.tools.ant

Class TaskAdapter

public class TaskAdapter extends Task implements TypeAdapter

Uses introspection to "adapt" an arbitrary Bean which doesn't itself extend Task, but still contains an execute method and optionally a setProject method.
Constructor Summary
TaskAdapter()
No-arg constructor for reflection.
TaskAdapter(Object proxy)
Constructor for given proxy.
Method Summary
voidcheckProxyClass(Class proxyClass)
Check if the proxy class is a valid class to use with this adapter.
static voidcheckTaskClass(Class taskClass, Project project)
Checks whether or not a class is suitable to be adapted by TaskAdapter.
voidexecute()
Executes the proxied task.
ObjectgetProxy()
Returns the target object being proxied.
voidsetProxy(Object o)
Sets the target object to proxy for.

Constructor Detail

TaskAdapter

public TaskAdapter()
No-arg constructor for reflection.

TaskAdapter

public TaskAdapter(Object proxy)
Constructor for given proxy. So you could write easier code
 myTaskContainer.addTask( new TaskAdapter(myProxy) );
 

Parameters: proxy The object which Ant should use as task.

Method Detail

checkProxyClass

public void checkProxyClass(Class proxyClass)
Check if the proxy class is a valid class to use with this adapter. The class must have a public no-arg "execute()" method.

Parameters: proxyClass the class to check.

checkTaskClass

public static void checkTaskClass(Class taskClass, Project project)
Checks whether or not a class is suitable to be adapted by TaskAdapter. If the class is of type Dispatchable, the check is not performed because the method that will be executed will be determined only at runtime of the actual task and not during parse time. This only checks conditions which are additionally required for tasks adapted by TaskAdapter. Thus, this method should be called by Project.checkTaskClass. Throws a BuildException and logs as Project.MSG_ERR for conditions that will cause the task execution to fail. Logs other suspicious conditions with Project.MSG_WARN.

Parameters: taskClass Class to test for suitability. Must not be null. project Project to log warnings/errors to. Must not be null.

See Also: checkTaskClass

execute

public void execute()
Executes the proxied task.

Throws: BuildException if the project could not be set or the method could not be executed.

getProxy

public Object getProxy()
Returns the target object being proxied.

Returns: the target proxy object.

setProxy

public void setProxy(Object o)
Sets the target object to proxy for.

Parameters: o The target object. Must not be null.