| 
 | ||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Object
  |
  +--org.apache.tools.ant.ProjectComponent
        |
        +--org.apache.tools.ant.Task
              |
              +--org.apache.tools.ant.UnknownElement
Wrapper class that holds all the information necessary to create a task or data type that did not exist when Ant started, or one which has had its definition updated to use a different implementation class.
| Field Summary | 
| Fields inherited from class org.apache.tools.ant.Task | 
| description, location, target, taskName, taskType, wrapper | 
| Fields inherited from class org.apache.tools.ant.ProjectComponent | 
| project | 
| Constructor Summary | |
| UnknownElement(java.lang.String elementName)Creates an UnknownElement for the given element name. | |
| Method Summary | |
|  void | addChild(UnknownElement child)Adds a child element to this element. | 
|  void | applyPreSet(UnknownElement u)This is used then the realobject of the UE is a PreSetDefinition. | 
|  void | configure(java.lang.Object realObject)Configure the given object from this UnknownElement | 
|  void | execute()Executes the real object if it's a task. | 
|  java.util.List | getChildren() | 
| protected  java.lang.String | getComponentName() | 
|  java.lang.String | getNamespace()Return the namespace of the XML element associated with this component. | 
| protected  BuildException | getNotFoundException(java.lang.String what,
                     java.lang.String elementName)Returns a very verbose exception for when a task/data type cannot be found. | 
|  java.lang.String | getQName()Return the qname of the XML element associated with this component. | 
|  java.lang.Object | getRealThing()Return the configured object | 
|  java.lang.String | getTag()Returns the name of the XML element which generated this unknown element. | 
|  Task | getTask()Returns the task instance after it has been created and if it is a task. | 
|  java.lang.String | getTaskName()Returns the name to use in logging messages. | 
|  RuntimeConfigurable | getWrapper()Get the RuntimeConfigurable instance for this UnknownElement, containing the configuration information. | 
| protected  void | handleChildren(java.lang.Object parent,
               RuntimeConfigurable parentWrapper)Creates child elements, creates children of the children (recursively), and sets attributes of the child elements. | 
| protected  void | handleErrorFlush(java.lang.String output)Handles error output sent to System.err by this task or its real task. | 
| protected  void | handleErrorOutput(java.lang.String output)Handles error output sent to System.err by this task or its real task. | 
| protected  void | handleFlush(java.lang.String output)Handles output sent to System.out by this task or its real task. | 
| protected  int | handleInput(byte[] buffer,
            int offset,
            int length)Handle an input request by this task | 
| protected  void | handleOutput(java.lang.String output)Handles output sent to System.out by this task or its real task. | 
| protected  java.lang.Object | makeObject(UnknownElement ue,
           RuntimeConfigurable w)Creates a named task or data type. | 
| protected  Task | makeTask(UnknownElement ue,
         RuntimeConfigurable w)Creates a named task and configures it up to the init() stage. | 
|  void | maybeConfigure()Creates the real object instance and child elements, then configures the attributes and text of the real object. | 
|  void | setNamespace(java.lang.String namespace)Set the namespace of the XML element associated with this component. | 
|  void | setQName(java.lang.String qname)Set the namespace qname of the XML element. | 
|  boolean | similar(java.lang.Object obj)like contents equals, but ignores project | 
| Methods inherited from class org.apache.tools.ant.Task | 
| getDescription, getLocation, getOwningTarget, getRuntimeConfigurableWrapper, getTaskType, init, isInvalid, log, log, perform, reconfigure, setDescription, setLocation, setOwningTarget, setRuntimeConfigurableWrapper, setTaskName, setTaskType | 
| Methods inherited from class org.apache.tools.ant.ProjectComponent | 
| getProject, setProject | 
| Methods inherited from class java.lang.Object | 
| clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait | 
| Constructor Detail | 
public UnknownElement(java.lang.String elementName)
elementName - The name of the unknown element.
                    Must not be null.| Method Detail | 
public java.util.List getChildren()
public java.lang.String getTag()
public java.lang.String getNamespace()
public void setNamespace(java.lang.String namespace)
namespace - URI used in the xmlns declaration.public java.lang.String getQName()
public void setQName(java.lang.String qname)
qname - the qualified name of the elementpublic RuntimeConfigurable getWrapper()
getWrapper in class Task
public void maybeConfigure()
                    throws BuildException
maybeConfigure in class TaskBuildException - if the configuration failspublic void configure(java.lang.Object realObject)
realObject - the real object this UnknownElement is representing.protected void handleOutput(java.lang.String output)
handleOutput in class Taskoutput - The output to log. Should not be null.
protected int handleInput(byte[] buffer,
                          int offset,
                          int length)
                   throws java.io.IOException
Task
handleInput in class Taskbuffer - the buffer into which data is to be read.offset - the offset into the buffer at which data is stored.length - the amount of data to read
java.io.IOException - if the data cannot be readTask.handleInput(byte[], int, int)protected void handleFlush(java.lang.String output)
handleFlush in class Taskoutput - The output to log. Should not be null.protected void handleErrorOutput(java.lang.String output)
handleErrorOutput in class Taskoutput - The error output to log. Should not be null.protected void handleErrorFlush(java.lang.String output)
handleErrorFlush in class Taskoutput - The error output to log. Should not be null.public void execute()
execute in class Taskpublic void addChild(UnknownElement child)
child - The child element to add. Must not be null.
protected void handleChildren(java.lang.Object parent,
                              RuntimeConfigurable parentWrapper)
                       throws BuildException
parent - The configured object for the parent.
               Must not be null.parentWrapper - The wrapper containing child wrappers
                      to be configured. Must not be null
                      if there are any children.
BuildException - if the children cannot be configured.protected java.lang.String getComponentName()
public void applyPreSet(UnknownElement u)
u - an UnknownElement containing the attributes, elements and text
protected java.lang.Object makeObject(UnknownElement ue,
                                      RuntimeConfigurable w)
ue - The unknown element to create the real object for.
           Must not be null.w - Ignored in this implementation.
protected Task makeTask(UnknownElement ue,
                        RuntimeConfigurable w)
ue - The UnknownElement to create the real task for.
           Must not be null.w - Ignored.
null if the task name is not recognised.
protected BuildException getNotFoundException(java.lang.String what,
                                              java.lang.String elementName)
what - The kind of thing being created. For example, when
             a task name could not be found, this would be
             "task". Should not be null.elementName - The name of the element which could not be found.
                    Should not be null.
public java.lang.String getTaskName()
getTaskName in class Taskpublic Task getTask()
null if the real object is not
         a task.public java.lang.Object getRealThing()
public boolean similar(java.lang.Object obj)
obj - the object to check against
| 
 | ||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||