Package org.apache.tools.ant
Class TaskAdapter
java.lang.Object
org.apache.tools.ant.ProjectComponent
org.apache.tools.ant.Task
org.apache.tools.ant.TaskAdapter
- All Implemented Interfaces:
Cloneable
,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.
-
Field Summary
Fields inherited from class org.apache.tools.ant.ProjectComponent
description, location, project
-
Constructor Summary
ConstructorDescriptionNo-arg constructor for reflection.TaskAdapter
(Object proxy) Constructor for given proxy. -
Method Summary
Modifier and TypeMethodDescriptionvoid
checkProxyClass
(Class<?> proxyClass) Check if the proxy class is a valid class to use with this adapter.static void
checkTaskClass
(Class<?> taskClass, Project project) Checks whether or not a class is suitable to be adapted by TaskAdapter.void
execute()
Executes the proxied task.getProxy()
Returns the target object being proxied.void
Sets the target object to proxy for.Methods inherited from class org.apache.tools.ant.Task
bindToOwner, getOwningTarget, getRuntimeConfigurableWrapper, getTaskName, getTaskType, getWrapper, handleErrorFlush, handleErrorOutput, handleFlush, handleInput, handleOutput, init, isInvalid, log, log, log, log, maybeConfigure, perform, reconfigure, setOwningTarget, setRuntimeConfigurableWrapper, setTaskName, setTaskType
Methods inherited from class org.apache.tools.ant.ProjectComponent
clone, getDescription, getLocation, getProject, setDescription, setLocation, setProject
Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Methods inherited from interface org.apache.tools.ant.TypeAdapter
getProject, setProject
-
Constructor Details
-
TaskAdapter
public TaskAdapter()No-arg constructor for reflection. -
TaskAdapter
Constructor for given proxy. So you could write easier codemyTaskContainer.addTask(new TaskAdapter(myProxy));
- Parameters:
proxy
- The object which Ant should use as task.
-
-
Method Details
-
checkTaskClass
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 benull
.project
- Project to log warnings/errors to. Must not benull
.- See Also:
-
checkProxyClass
Check if the proxy class is a valid class to use with this adapter. The class must have a public no-arg "execute()" method.- Specified by:
checkProxyClass
in interfaceTypeAdapter
- Parameters:
proxyClass
- the class to check.
-
execute
Executes the proxied task.- Overrides:
execute
in classTask
- Throws:
BuildException
- if the project could not be set or the method could not be executed.
-
setProxy
Sets the target object to proxy for.- Specified by:
setProxy
in interfaceTypeAdapter
- Parameters:
o
- The target object. Must not benull
.
-
getProxy
Returns the target object being proxied.- Specified by:
getProxy
in interfaceTypeAdapter
- Returns:
- the target proxy object.
-