. */ include_once 'phing/IntrospectionHelper.php'; include_once 'phing/TaskContainer.php'; /** * The nested element handler class. * * This class handles the occurance of runtime registered tags like * datatypes (fileset, patternset, etc) and it's possible nested tags. It * introspects the implementation of the class and sets up the data structures. * * @author Andreas Aderhold * @copyright 2001,2002 THYRELL. All rights reserved * @version $Id$ * @access public * @package phing.parser */ class NestedElementHandler extends AbstractHandler { /** * Reference to the parent object that represents the parent tag * of this nested element * @var object */ private $parent; /** * Reference to the child object that represents the child tag * of this nested element * @var object */ private $child; /** * Reference to the parent wrapper object * @var object */ private $parentWrapper; /** * Reference to the child wrapper object * @var object */ private $childWrapper; /** * Reference to the related target object * @var object the target instance */ private $target; /** * Constructs a new NestedElement handler and sets up everything. * * @param object the ExpatParser object * @param object the parent handler that invoked this handler * @param object the ProjectConfigurator object * @param object the parent object this element is contained in * @param object the parent wrapper object * @param object the target object this task is contained in * @access public */ function __construct($parser, $parentHandler, $configurator, $parent, $parentWrapper, $target) { parent::__construct($parser, $parentHandler); $this->configurator = $configurator; if ($parent instanceof TaskAdapter) { $this->parent = $parent->getProxy(); } else { $this->parent = $parent; } $this->parentWrapper = $parentWrapper; $this->target = $target; } /** * Executes initialization actions required to setup the data structures * related to the tag. *

* This includes: *

creation of the nested element
calling the setters for attributes
adding the element to the container object
adding a reference to the element (if id attribute is given)

* * @param string the tag that comes in * @param array attributes the tag carries * @throws ExpatParseException if the setup process fails * @access public */ function init($propType, $attrs) { $configurator = $this->configurator; $project = $this->configurator->project; // introspect the parent class that is custom $parentClass = get_class($this->parent); $ih = IntrospectionHelper::getHelper($parentClass); try { if ($this->parent instanceof UnknownElement) { $this->child = new UnknownElement(strtolower($propType)); $this->parent->addChild($this->child); } else { $this->child = $ih->createElement($project, $this->parent, strtolower($propType)); } $configurator->configureId($this->child, $attrs); if ($this->parentWrapper !== null) { $this->childWrapper = new RuntimeConfigurable($this->child, $propType); $this->childWrapper->setAttributes($attrs); $this->parentWrapper->addChild($this->childWrapper); } else { $configurator->configure($this->child, $attrs, $project); $ih->storeElement($project, $this->parent, $this->child, strtolower($propType)); } } catch (BuildException $exc) { throw new ExpatParseException("Error initializing nested element <$propType>", $exc, $this->parser->getLocation()); } } /** * Handles character data. * * @param string the CDATA that comes in * @throws ExpatParseException if the CDATA could not be set-up properly * @access public */ function characters($data) { $configurator = $this->configurator; $project = $this->configurator->project; if ($this->parentWrapper === null) { try { $configurator->addText($project, $this->child, $data); } catch (BuildException $exc) { throw new ExpatParseException($exc->getMessage(), $this->parser->getLocation()); } } else { $this->childWrapper->addText($data); } } /** * Checks for nested tags within the current one. Creates and calls * handlers respectively. * * @param string the tag that comes in * @param array attributes the tag carries * @access public */ function startElement($name, $attrs) { //print(get_class($this) . " name = $name, attrs = " . implode(",",$attrs) . "\n"); if ($this->child instanceof TaskContainer) { // taskcontainer nested element can contain other tasks - no other // nested elements possible $tc = new TaskHandler($this->parser, $this, $this->configurator, $this->child, $this->childWrapper, $this->target); $tc->init($name, $attrs); } else { $neh = new NestedElementHandler($this->parser, $this, $this->configurator, $this->child, $this->childWrapper, $this->target); $neh->init($name, $attrs); } } }