diff options
Diffstat (limited to 'framework/src/ant/apache-ant-1.9.6/src/main/org/apache/tools/ant/helper/ProjectHelperImpl.java')
| -rw-r--r-- | framework/src/ant/apache-ant-1.9.6/src/main/org/apache/tools/ant/helper/ProjectHelperImpl.java | 1026 |
1 files changed, 0 insertions, 1026 deletions
diff --git a/framework/src/ant/apache-ant-1.9.6/src/main/org/apache/tools/ant/helper/ProjectHelperImpl.java b/framework/src/ant/apache-ant-1.9.6/src/main/org/apache/tools/ant/helper/ProjectHelperImpl.java deleted file mode 100644 index f828d292..00000000 --- a/framework/src/ant/apache-ant-1.9.6/src/main/org/apache/tools/ant/helper/ProjectHelperImpl.java +++ /dev/null @@ -1,1026 +0,0 @@ -/* - * Licensed to the Apache Software Foundation (ASF) under one or more - * contributor license agreements. See the NOTICE file distributed with - * this work for additional information regarding copyright ownership. - * The ASF licenses this file to You under the Apache License, Version 2.0 - * (the "License"); you may not use this file except in compliance with - * the License. You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Unless required by applicable law or agreed to in writing, software - * distributed under the License is distributed on an "AS IS" BASIS, - * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - * See the License for the specific language governing permissions and - * limitations under the License. - * - */ -package org.apache.tools.ant.helper; - -import java.io.File; -import java.io.FileInputStream; -import java.io.FileNotFoundException; -import java.io.IOException; -import java.io.UnsupportedEncodingException; -import java.util.Locale; - -import org.apache.tools.ant.BuildException; -import org.apache.tools.ant.IntrospectionHelper; -import org.apache.tools.ant.Location; -import org.apache.tools.ant.Project; -import org.apache.tools.ant.ProjectHelper; -import org.apache.tools.ant.RuntimeConfigurable; -import org.apache.tools.ant.Target; -import org.apache.tools.ant.Task; -import org.apache.tools.ant.TaskContainer; -import org.apache.tools.ant.TypeAdapter; -import org.apache.tools.ant.UnknownElement; -import org.apache.tools.ant.util.FileUtils; -import org.apache.tools.ant.util.JAXPUtils; -import org.xml.sax.AttributeList; -import org.xml.sax.DocumentHandler; -import org.xml.sax.HandlerBase; -import org.xml.sax.InputSource; -import org.xml.sax.Locator; -import org.xml.sax.SAXException; -import org.xml.sax.SAXParseException; -import org.xml.sax.helpers.XMLReaderAdapter; - -/** - * Original helper. - * - */ -public class ProjectHelperImpl extends ProjectHelper { - - /** - * helper for path -> URI and URI -> path conversions. - */ - private static final FileUtils FILE_UTILS = FileUtils.getFileUtils(); - - /** - * SAX 1 style parser used to parse the given file. This may - * in fact be a SAX 2 XMLReader wrapped in an XMLReaderAdapter. - */ - private org.xml.sax.Parser parser; - - /** The project to configure. */ - private Project project; - - /** The configuration file to parse. */ - private File buildFile; - - /** - * Parent directory of the build file. Used for resolving entities - * and setting the project's base directory. - */ - private File buildFileParent; - - /** - * Locator for the configuration file parser. - * Used for giving locations of errors etc. - */ - private Locator locator; - - /** - * Target that all other targets will depend upon implicitly. - * - * <p>This holds all tasks and data type definitions that have - * been placed outside of targets.</p> - */ - private Target implicitTarget = new Target(); - - /** - * default constructor - */ - public ProjectHelperImpl() { - implicitTarget.setName(""); - } - - /** - * Parses the project file, configuring the project as it goes. - * - * @param project project instance to be configured. - * @param source the source from which the project is read. - * @exception BuildException if the configuration is invalid or cannot - * be read. - */ - public void parse(Project project, Object source) throws BuildException { - if (!(source instanceof File)) { - throw new BuildException("Only File source supported by " - + "default plugin"); - } - File bFile = (File) source; - FileInputStream inputStream = null; - InputSource inputSource = null; - - this.project = project; - this.buildFile = new File(bFile.getAbsolutePath()); - buildFileParent = new File(this.buildFile.getParent()); - - try { - try { - parser = JAXPUtils.getParser(); - } catch (BuildException e) { - parser = new XMLReaderAdapter(JAXPUtils.getXMLReader()); - } - String uri = FILE_UTILS.toURI(bFile.getAbsolutePath()); - inputStream = new FileInputStream(bFile); - inputSource = new InputSource(inputStream); - inputSource.setSystemId(uri); - project.log("parsing buildfile " + bFile + " with URI = " + uri, Project.MSG_VERBOSE); - HandlerBase hb = new RootHandler(this); - parser.setDocumentHandler(hb); - parser.setEntityResolver(hb); - parser.setErrorHandler(hb); - parser.setDTDHandler(hb); - parser.parse(inputSource); - } catch (SAXParseException exc) { - Location location = new Location(exc.getSystemId(), exc.getLineNumber(), exc - .getColumnNumber()); - - Throwable t = exc.getException(); - if (t instanceof BuildException) { - BuildException be = (BuildException) t; - if (be.getLocation() == Location.UNKNOWN_LOCATION) { - be.setLocation(location); - } - throw be; - } - throw new BuildException(exc.getMessage(), t, location); - } catch (SAXException exc) { - Throwable t = exc.getException(); - if (t instanceof BuildException) { - throw (BuildException) t; - } - throw new BuildException(exc.getMessage(), t); - } catch (FileNotFoundException exc) { - throw new BuildException(exc); - } catch (UnsupportedEncodingException exc) { - throw new BuildException("Encoding of project file is invalid.", exc); - } catch (IOException exc) { - throw new BuildException("Error reading project file: " + exc.getMessage(), exc); - } finally { - FileUtils.close(inputStream); - } - } - - /** - * The common superclass for all SAX event handlers used to parse - * the configuration file. Each method just throws an exception, - * so subclasses should override what they can handle. - * - * Each type of XML element (task, target, etc.) in Ant has - * a specific subclass. - * - * In the constructor, this class takes over the handling of SAX - * events from the parent handler and returns - * control back to the parent in the endElement method. - */ - static class AbstractHandler extends HandlerBase { - // CheckStyle:VisibilityModifier OFF - bc - - /** - * Previous handler for the document. - * When the next element is finished, control returns - * to this handler. - */ - protected DocumentHandler parentHandler; - - /** Helper impl. With non-static internal classes, the compiler will generate - this automatically - but this will fail with some compilers ( reporting - "Expecting to find object/array on stack" ). If we pass it - explicitly it'll work with more compilers. - */ - ProjectHelperImpl helperImpl; - // CheckStyle:VisibilityModifier ON - - /** - * Creates a handler and sets the parser to use it - * for the current element. - * - * @param helperImpl the ProjectHelperImpl instance associated - * with this handler. - * - * @param parentHandler The handler which should be restored to the - * parser at the end of the element. - * Must not be <code>null</code>. - */ - public AbstractHandler(ProjectHelperImpl helperImpl, DocumentHandler parentHandler) { - this.parentHandler = parentHandler; - this.helperImpl = helperImpl; - - // Start handling SAX events - helperImpl.parser.setDocumentHandler(this); - } - - /** - * Handles the start of an element. This base implementation just - * throws an exception. - * - * @param tag The name of the element being started. - * Will not be <code>null</code>. - * @param attrs Attributes of the element being started. - * Will not be <code>null</code>. - * - * @exception SAXParseException if this method is not overridden, or in - * case of error in an overridden version - */ - public void startElement(String tag, AttributeList attrs) throws SAXParseException { - throw new SAXParseException("Unexpected element \"" + tag + "\"", helperImpl.locator); - } - - /** - * Handles text within an element. This base implementation just - * throws an exception. - * - * @param buf A character array of the text within the element. - * Will not be <code>null</code>. - * @param start The start element in the array. - * @param count The number of characters to read from the array. - * - * @exception SAXParseException if this method is not overridden, or in - * case of error in an overridden version - */ - public void characters(char[] buf, int start, int count) throws SAXParseException { - String s = new String(buf, start, count).trim(); - - if (s.length() > 0) { - throw new SAXParseException("Unexpected text \"" + s + "\"", helperImpl.locator); - } - } - - /** - * Handles the end of an element. Any required clean-up is performed - * by the finished() method and then the original handler is restored to - * the parser. - * - * @param name The name of the element which is ending. - * Will not be <code>null</code>. - * - * @exception SAXException in case of error (not thrown in - * this implementation) - */ - public void endElement(String name) throws SAXException { - // Let parent resume handling SAX events - helperImpl.parser.setDocumentHandler(parentHandler); - } - } - - /** - * Handler for the root element. Its only child must be the "project" element. - */ - static class RootHandler extends HandlerBase { - // CheckStyle:VisibilityModifier OFF - bc - ProjectHelperImpl helperImpl; - // CheckStyle:VisibilityModifier ON - - public RootHandler(ProjectHelperImpl helperImpl) { - this.helperImpl = helperImpl; - } - - /** - * Resolves file: URIs relative to the build file. - * - * @param publicId The public identifier, or <code>null</code> - * if none is available. Ignored in this - * implementation. - * @param systemId The system identifier provided in the XML - * document. Will not be <code>null</code>. - */ - public InputSource resolveEntity(String publicId, String systemId) { - - helperImpl.project.log("resolving systemId: " + systemId, Project.MSG_VERBOSE); - - if (systemId.startsWith("file:")) { - String path = FILE_UTILS.fromURI(systemId); - - File file = new File(path); - if (!file.isAbsolute()) { - file = FILE_UTILS.resolveFile(helperImpl.buildFileParent, path); - helperImpl.project.log("Warning: '" + systemId + "' in " + helperImpl.buildFile - + " should be expressed simply as '" + path.replace('\\', '/') - + "' for compliance with other XML tools", Project.MSG_WARN); - } - try { - InputSource inputSource = new InputSource(new FileInputStream(file)); - inputSource.setSystemId(FILE_UTILS.toURI(file.getAbsolutePath())); - return inputSource; - } catch (FileNotFoundException fne) { - helperImpl.project.log(file.getAbsolutePath() + " could not be found", - Project.MSG_WARN); - } - } - // use default if not file or file not found - return null; - } - - /** - * Handles the start of a project element. A project handler is created - * and initialised with the element name and attributes. - * - * @param tag The name of the element being started. - * Will not be <code>null</code>. - * @param attrs Attributes of the element being started. - * Will not be <code>null</code>. - * - * @exception SAXParseException if the tag given is not - * <code>"project"</code> - */ - public void startElement(String tag, AttributeList attrs) throws SAXParseException { - if (tag.equals("project")) { - new ProjectHandler(helperImpl, this).init(tag, attrs); - } else { - throw new SAXParseException("Config file is not of expected " + "XML type", - helperImpl.locator); - } - } - - /** - * Sets the locator in the project helper for future reference. - * - * @param locator The locator used by the parser. - * Will not be <code>null</code>. - */ - public void setDocumentLocator(Locator locator) { - helperImpl.locator = locator; - } - } - - /** - * Handler for the top level "project" element. - */ - static class ProjectHandler extends AbstractHandler { - - /** - * Constructor which just delegates to the superconstructor. - * - * @param parentHandler The handler which should be restored to the - * parser at the end of the element. - * Must not be <code>null</code>. - */ - public ProjectHandler(ProjectHelperImpl helperImpl, DocumentHandler parentHandler) { - super(helperImpl, parentHandler); - } - - /** - * Initialisation routine called after handler creation - * with the element name and attributes. The attributes which - * this handler can deal with are: <code>"default"</code>, - * <code>"name"</code>, <code>"id"</code> and <code>"basedir"</code>. - * - * @param tag Name of the element which caused this handler - * to be created. Should not be <code>null</code>. - * Ignored in this implementation. - * @param attrs Attributes of the element which caused this - * handler to be created. Must not be <code>null</code>. - * - * @exception SAXParseException if an unexpected attribute is - * encountered or if the <code>"default"</code> attribute - * is missing. - */ - public void init(String tag, AttributeList attrs) throws SAXParseException { - String def = null; - String name = null; - String id = null; - String baseDir = null; - - for (int i = 0; i < attrs.getLength(); i++) { - String key = attrs.getName(i); - String value = attrs.getValue(i); - - if (key.equals("default")) { - def = value; - } else if (key.equals("name")) { - name = value; - } else if (key.equals("id")) { - id = value; - } else if (key.equals("basedir")) { - baseDir = value; - } else { - throw new SAXParseException( - "Unexpected attribute \"" + attrs.getName(i) - + "\"", helperImpl.locator); - } - } - - if (def != null && !def.equals("")) { - helperImpl.project.setDefault(def); - } else { - throw new BuildException("The default attribute is required"); - } - - if (name != null) { - helperImpl.project.setName(name); - helperImpl.project.addReference(name, helperImpl.project); - } - - if (id != null) { - helperImpl.project.addReference(id, helperImpl.project); - } - - if (helperImpl.project.getProperty("basedir") != null) { - helperImpl.project.setBasedir(helperImpl.project.getProperty("basedir")); - } else { - if (baseDir == null) { - helperImpl.project.setBasedir(helperImpl.buildFileParent.getAbsolutePath()); - } else { - // check whether the user has specified an absolute path - if ((new File(baseDir)).isAbsolute()) { - helperImpl.project.setBasedir(baseDir); - } else { - File resolvedBaseDir = FILE_UTILS.resolveFile(helperImpl.buildFileParent, - baseDir); - helperImpl.project.setBaseDir(resolvedBaseDir); - } - } - } - - helperImpl.project.addTarget("", helperImpl.implicitTarget); - } - - /** - * Handles the start of a top-level element within the project. An - * appropriate handler is created and initialised with the details - * of the element. - * - * @param name The name of the element being started. - * Will not be <code>null</code>. - * @param attrs Attributes of the element being started. - * Will not be <code>null</code>. - * - * @exception SAXParseException if the tag given is not - * <code>"taskdef"</code>, <code>"typedef"</code>, - * <code>"property"</code>, <code>"target"</code> - * or a data type definition - */ - public void startElement(String name, AttributeList attrs) throws SAXParseException { - if (name.equals("target")) { - handleTarget(name, attrs); - } else { - handleElement(helperImpl, this, helperImpl.implicitTarget, name, attrs); - } - } - - /** - * Handles a target definition element by creating a target handler - * and initialising is with the details of the element. - * - * @param tag The name of the element to be handled. - * Will not be <code>null</code>. - * @param attrs Attributes of the element to be handled. - * Will not be <code>null</code>. - * - * @exception SAXParseException if an error occurs initialising - * the handler - */ - private void handleTarget(String tag, AttributeList attrs) throws SAXParseException { - new TargetHandler(helperImpl, this).init(tag, attrs); - } - } - - /** - * Handler for "target" elements. - */ - static class TargetHandler extends AbstractHandler { - private Target target; - - /** - * Constructor which just delegates to the superconstructor. - * - * @param parentHandler The handler which should be restored to the - * parser at the end of the element. - * Must not be <code>null</code>. - */ - public TargetHandler(ProjectHelperImpl helperImpl, DocumentHandler parentHandler) { - super(helperImpl, parentHandler); - } - - /** - * Initialisation routine called after handler creation - * with the element name and attributes. The attributes which - * this handler can deal with are: <code>"name"</code>, - * <code>"depends"</code>, <code>"if"</code>, - * <code>"unless"</code>, <code>"id"</code> and - * <code>"description"</code>. - * - * @param tag Name of the element which caused this handler - * to be created. Should not be <code>null</code>. - * Ignored in this implementation. - * @param attrs Attributes of the element which caused this - * handler to be created. Must not be <code>null</code>. - * - * @exception SAXParseException if an unexpected attribute is encountered - * or if the <code>"name"</code> attribute is missing. - */ - public void init(String tag, AttributeList attrs) throws SAXParseException { - String name = null; - String depends = ""; - String ifCond = null; - String unlessCond = null; - String id = null; - String description = null; - - for (int i = 0; i < attrs.getLength(); i++) { - String key = attrs.getName(i); - String value = attrs.getValue(i); - - if (key.equals("name")) { - name = value; - if (name.equals("")) { - throw new BuildException("name attribute must not" + " be empty", - new Location(helperImpl.locator)); - } - } else if (key.equals("depends")) { - depends = value; - } else if (key.equals("if")) { - ifCond = value; - } else if (key.equals("unless")) { - unlessCond = value; - } else if (key.equals("id")) { - id = value; - } else if (key.equals("description")) { - description = value; - } else { - throw new SAXParseException("Unexpected attribute \"" + key + "\"", - helperImpl.locator); - } - } - - if (name == null) { - throw new SAXParseException("target element appears without a name attribute", - helperImpl.locator); - } - - target = new Target(); - - // implicit target must be first on dependency list - target.addDependency(""); - - target.setName(name); - target.setIf(ifCond); - target.setUnless(unlessCond); - target.setDescription(description); - helperImpl.project.addTarget(name, target); - - if (id != null && !id.equals("")) { - helperImpl.project.addReference(id, target); - } - - // take care of dependencies - - if (depends.length() > 0) { - target.setDepends(depends); - } - } - - /** - * Handles the start of an element within a target. - * - * @param name The name of the element being started. - * Will not be <code>null</code>. - * @param attrs Attributes of the element being started. - * Will not be <code>null</code>. - * - * @exception SAXParseException if an error occurs when initialising - * the appropriate child handler - */ - public void startElement(String name, AttributeList attrs) throws SAXParseException { - handleElement(helperImpl, this, target, name, attrs); - } - } - - /** - * Start a new DataTypeHandler if element is known to be a - * data-type and a TaskHandler otherwise. - * - * <p>Factored out of TargetHandler.</p> - * - * @since Ant 1.6 - */ - private static void handleElement(ProjectHelperImpl helperImpl, DocumentHandler parent, - Target target, String elementName, AttributeList attrs) throws SAXParseException { - if (elementName.equals("description")) { - new DescriptionHandler(helperImpl, parent); - } else if (helperImpl.project.getDataTypeDefinitions().get(elementName) != null) { - new DataTypeHandler(helperImpl, parent, target).init(elementName, attrs); - } else { - new TaskHandler(helperImpl, parent, target, null, target).init(elementName, attrs); - } - } - - /** - * Handler for "description" elements. - */ - static class DescriptionHandler extends AbstractHandler { - - /** - * Constructor which just delegates to the superconstructor. - * - * @param parentHandler The handler which should be restored to the - * parser at the end of the element. - * Must not be <code>null</code>. - */ - public DescriptionHandler(ProjectHelperImpl helperImpl, - DocumentHandler parentHandler) { - super(helperImpl, parentHandler); - } - - /** - * Adds the text as description to the project. - * - * @param buf A character array of the text within the element. - * Will not be <code>null</code>. - * @param start The start element in the array. - * @param count The number of characters to read from the array. - */ - public void characters(char[] buf, int start, int count) { - String text = new String(buf, start, count); - String currentDescription = helperImpl.project.getDescription(); - if (currentDescription == null) { - helperImpl.project.setDescription(text); - } else { - helperImpl.project.setDescription(currentDescription + text); - } - } - - } - - /** - * Handler for all task elements. - */ - static class TaskHandler extends AbstractHandler { - /** Containing target, if any. */ - private Target target; - - /** - * Container for the task, if any. If target is - * non-<code>null</code>, this must be too. - */ - private TaskContainer container; - - /** - * Task created by this handler. - */ - private Task task; - - /** - * Wrapper for the parent element, if any. The wrapper for this - * element will be added to this wrapper as a child. - */ - private RuntimeConfigurable parentWrapper; - - /** - * Wrapper for this element which takes care of actually configuring - * the element, if this element is contained within a target. - * Otherwise the configuration is performed with the configure method. - * @see ProjectHelper#configure(Object,AttributeList,Project) - */ - private RuntimeConfigurable wrapper = null; - - /** - * Constructor. - * - * @param parentHandler The handler which should be restored to the - * parser at the end of the element. - * Must not be <code>null</code>. - * - * @param container Container for the element. - * Must not be <code>null</code>. - * - * @param parentWrapper Wrapper for the parent element, if any. - * May be <code>null</code>. - * - * @param target Target this element is part of. - * Must not be <code>null</code>. - */ - public TaskHandler(ProjectHelperImpl helperImpl, DocumentHandler parentHandler, - TaskContainer container, - RuntimeConfigurable parentWrapper, Target target) { - super(helperImpl, parentHandler); - this.container = container; - this.parentWrapper = parentWrapper; - this.target = target; - } - - /** - * Initialisation routine called after handler creation - * with the element name and attributes. This configures - * the element with its attributes and sets it up with - * its parent container (if any). Nested elements are then - * added later as the parser encounters them. - * - * @param tag Name of the element which caused this handler - * to be created. Must not be <code>null</code>. - * - * @param attrs Attributes of the element which caused this - * handler to be created. Must not be <code>null</code>. - * - * @exception SAXParseException in case of error (not thrown in - * this implementation) - */ - public void init(String tag, AttributeList attrs) throws SAXParseException { - try { - task = helperImpl.project.createTask(tag); - } catch (BuildException e) { - // swallow here, will be thrown again in - // UnknownElement.maybeConfigure if the problem persists. - } - if (task == null) { - task = new UnknownElement(tag); - task.setProject(helperImpl.project); - //TODO task.setTaskType(tag); - task.setTaskName(tag); - } - task.setLocation(new Location(helperImpl.locator)); - helperImpl.configureId(task, attrs); - - task.setOwningTarget(target); - container.addTask(task); - task.init(); - wrapper = task.getRuntimeConfigurableWrapper(); - wrapper.setAttributes(attrs); - if (parentWrapper != null) { - parentWrapper.addChild(wrapper); - } - } - - /** - * Adds text to the task, using the wrapper. - * - * @param buf A character array of the text within the element. - * Will not be <code>null</code>. - * @param start The start element in the array. - * @param count The number of characters to read from the array. - */ - public void characters(char[] buf, int start, int count) { - wrapper.addText(buf, start, count); - } - - /** - * Handles the start of an element within a target. Task containers - * will always use another task handler, and all other tasks - * will always use a nested element handler. - * - * @param name The name of the element being started. - * Will not be <code>null</code>. - * @param attrs Attributes of the element being started. - * Will not be <code>null</code>. - * - * @exception SAXParseException if an error occurs when initialising - * the appropriate child handler - */ - public void startElement(String name, AttributeList attrs) throws SAXParseException { - if (task instanceof TaskContainer) { - // task can contain other tasks - no other nested elements possible - new TaskHandler(helperImpl, this, (TaskContainer) task, wrapper, target).init(name, - attrs); - } else { - new NestedElementHandler(helperImpl, this, task, wrapper, target).init(name, attrs); - } - } - } - - /** - * Handler for all nested properties. - */ - static class NestedElementHandler extends AbstractHandler { - /** Parent object (task/data type/etc). */ - private Object parent; - - /** The nested element itself. */ - private Object child; - - /** - * Wrapper for the parent element, if any. The wrapper for this - * element will be added to this wrapper as a child. - */ - private RuntimeConfigurable parentWrapper; - - /** - * Wrapper for this element which takes care of actually configuring - * the element, if a parent wrapper is provided. - * Otherwise the configuration is performed with the configure method. - * @see ProjectHelper#configure(Object,AttributeList,Project) - */ - private RuntimeConfigurable childWrapper = null; - - /** Target this element is part of, if any. */ - private Target target; - - /** - * Constructor. - * - * @param parentHandler The handler which should be restored to the - * parser at the end of the element. - * Must not be <code>null</code>. - * - * @param parent Parent of this element (task/data type/etc). - * Must not be <code>null</code>. - * - * @param parentWrapper Wrapper for the parent element, if any. - * Must not be <code>null</code>. - * - * @param target Target this element is part of. - * Must not be <code>null</code>. - */ - public NestedElementHandler(ProjectHelperImpl helperImpl, - DocumentHandler parentHandler, - Object parent, - RuntimeConfigurable parentWrapper, - Target target) { - super(helperImpl, parentHandler); - - if (parent instanceof TypeAdapter) { - this.parent = ((TypeAdapter) parent).getProxy(); - } else { - this.parent = parent; - } - this.parentWrapper = parentWrapper; - this.target = target; - } - - /** - * Initialisation routine called after handler creation - * with the element name and attributes. This configures - * the element with its attributes and sets it up with - * its parent container (if any). Nested elements are then - * added later as the parser encounters them. - * - * @param propType Name of the element which caused this handler - * to be created. Must not be <code>null</code>. - * - * @param attrs Attributes of the element which caused this - * handler to be created. Must not be <code>null</code>. - * - * @exception SAXParseException in case of error, such as a - * BuildException being thrown during configuration. - */ - public void init(String propType, AttributeList attrs) throws SAXParseException { - Class<?> parentClass = parent.getClass(); - IntrospectionHelper ih = IntrospectionHelper.getHelper(helperImpl.project, parentClass); - - try { - String elementName = propType.toLowerCase(Locale.ENGLISH); - if (parent instanceof UnknownElement) { - UnknownElement uc = new UnknownElement(elementName); - uc.setProject(helperImpl.project); - ((UnknownElement) parent).addChild(uc); - child = uc; - } else { - child = ih.createElement(helperImpl.project, parent, elementName); - } - helperImpl.configureId(child, attrs); - - childWrapper = new RuntimeConfigurable(child, propType); - childWrapper.setAttributes(attrs); - parentWrapper.addChild(childWrapper); - } catch (BuildException exc) { - throw new SAXParseException(exc.getMessage(), helperImpl.locator, exc); - } - } - - /** - * Adds text to the element, using the wrapper. - * - * @param buf A character array of the text within the element. - * Will not be <code>null</code>. - * @param start The start element in the array. - * @param count The number of characters to read from the array. - */ - public void characters(char[] buf, int start, int count) { - childWrapper.addText(buf, start, count); - } - - /** - * Handles the start of an element within this one. Task containers - * will always use a task handler, and all other elements - * will always use another nested element handler. - * - * @param name The name of the element being started. - * Will not be <code>null</code>. - * @param attrs Attributes of the element being started. - * Will not be <code>null</code>. - * - * @exception SAXParseException if an error occurs when initialising - * the appropriate child handler - */ - public void startElement(String name, AttributeList attrs) throws SAXParseException { - if (child instanceof TaskContainer) { - // taskcontainer nested element can contain other tasks - no other - // nested elements possible - new TaskHandler(helperImpl, this, (TaskContainer) child, childWrapper, target) - .init(name, attrs); - } else { - new NestedElementHandler(helperImpl, this, child, childWrapper, target).init(name, - attrs); - } - } - } - - /** - * Handler for all data types directly subordinate to project or target. - */ - static class DataTypeHandler extends AbstractHandler { - /** Parent target, if any. */ - private Target target; - - /** The element being configured. */ - private Object element; - - /** Wrapper for this element, if it's part of a target. */ - private RuntimeConfigurable wrapper = null; - - /** - * Constructor with a target specified. - * - * @param parentHandler The handler which should be restored to the - * parser at the end of the element. - * Must not be <code>null</code>. - * - * @param target The parent target of this element. - * Must not be <code>null</code>. - */ - public DataTypeHandler(ProjectHelperImpl helperImpl, DocumentHandler parentHandler, - Target target) { - super(helperImpl, parentHandler); - this.target = target; - } - - /** - * Initialisation routine called after handler creation - * with the element name and attributes. This configures - * the element with its attributes and sets it up with - * its parent container (if any). Nested elements are then - * added later as the parser encounters them. - * - * @param propType Name of the element which caused this handler - * to be created. Must not be <code>null</code>. - * - * @param attrs Attributes of the element which caused this - * handler to be created. Must not be <code>null</code>. - * - * @exception SAXParseException in case of error, such as a - * BuildException being thrown during configuration. - */ - public void init(String propType, AttributeList attrs) throws SAXParseException { - try { - element = helperImpl.project.createDataType(propType); - if (element == null) { - throw new BuildException("Unknown data type " + propType); - } - wrapper = new RuntimeConfigurable(element, propType); - wrapper.setAttributes(attrs); - target.addDataType(wrapper); - } catch (BuildException exc) { - throw new SAXParseException(exc.getMessage(), helperImpl.locator, exc); - } - } - - /** - * Adds text to the using the wrapper. - * - * @param buf A character array of the text within the element. - * Will not be <code>null</code>. - * @param start The start element in the array. - * @param count The number of characters to read from the array. - * - * @see ProjectHelper#addText(Project,Object,char[],int,int) - */ - public void characters(char[] buf, int start, int count) { - wrapper.addText(buf, start, count); - } - - /** - * Handles the start of an element within this one. - * This will always use a nested element handler. - * - * @param name The name of the element being started. - * Will not be <code>null</code>. - * @param attrs Attributes of the element being started. - * Will not be <code>null</code>. - * - * @exception SAXParseException if an error occurs when initialising - * the child handler - */ - public void startElement(String name, AttributeList attrs) throws SAXParseException { - new NestedElementHandler(helperImpl, this, element, wrapper, target).init(name, attrs); - } - } - - /** - * Scans an attribute list for the <code>id</code> attribute and - * stores a reference to the target object in the project if an - * id is found. - * <p> - * This method was moved out of the configure method to allow - * it to be executed at parse time. - * - * @see #configure(Object,AttributeList,Project) - */ - private void configureId(Object target, AttributeList attr) { - String id = attr.getValue("id"); - if (id != null) { - project.addReference(id, target); - } - } -} |