From 69d3c11ffb6e0fa87b538edd752f74598293c424 Mon Sep 17 00:00:00 2001 From: Erik Hatcher Date: Sun, 5 Jan 2003 21:25:52 +0000 Subject: [PATCH] obsolete. i'm leaving the datatype code here as i haven't migrated it to XDoclet yet. git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@273756 13f79535-47bb-0310-9956-ffa450edef68 --- .../apache/tools/ant/xdoclet/TaskSubTask.java | 166 ----- .../tools/ant/xdoclet/TaskTagsHandler.java | 662 ------------------ .../task_defaults_properties.template | 3 - proposal/xdocs/templates/task_xdoc.template | 60 -- 4 files changed, 891 deletions(-) delete mode 100644 proposal/xdocs/src/org/apache/tools/ant/xdoclet/TaskSubTask.java delete mode 100644 proposal/xdocs/src/org/apache/tools/ant/xdoclet/TaskTagsHandler.java delete mode 100644 proposal/xdocs/templates/task_defaults_properties.template delete mode 100644 proposal/xdocs/templates/task_xdoc.template diff --git a/proposal/xdocs/src/org/apache/tools/ant/xdoclet/TaskSubTask.java b/proposal/xdocs/src/org/apache/tools/ant/xdoclet/TaskSubTask.java deleted file mode 100644 index 8a7b9cf2a..000000000 --- a/proposal/xdocs/src/org/apache/tools/ant/xdoclet/TaskSubTask.java +++ /dev/null @@ -1,166 +0,0 @@ -/* - * The Apache Software License, Version 1.1 - * - * Copyright (c) 2002 The Apache Software Foundation. All rights - * reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions - * are met: - * - * 1. Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * 2. Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in - * the documentation and/or other materials provided with the - * distribution. - * - * 3. The end-user documentation included with the redistribution, if - * any, must include the following acknowlegement: - * "This product includes software developed by the - * Apache Software Foundation (http://www.apache.org/)." - * Alternately, this acknowlegement may appear in the software itself, - * if and wherever such third-party acknowlegements normally appear. - * - * 4. The names "The Jakarta Project", "Ant", and "Apache Software - * Foundation" must not be used to endorse or promote products derived - * from this software without prior written permission. For written - * permission, please contact apache@apache.org. - * - * 5. Products derived from this software may not be called "Apache" - * nor may "Apache" appear in their names without prior written - * permission of the Apache Group. - * - * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED - * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES - * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE - * DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR - * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, - * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT - * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF - * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND - * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, - * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT - * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF - * SUCH DAMAGE. - * ==================================================================== - * - * This software consists of voluntary contributions made by many - * individuals on behalf of the Apache Software Foundation. For more - * information on the Apache Software Foundation, please see - * . - */ -package org.apache.tools.ant.xdoclet; - -import com.sun.javadoc.ClassDoc; -import com.sun.javadoc.MethodDoc; -import com.sun.javadoc.Tag; -import xdoclet.TemplateSubTask; -import xdoclet.XDocletException; -import xdoclet.XDocletTagSupport; -import xdoclet.util.TypeConversionUtil; - -import java.io.File; - -/** - * Custom XDoclet subtask to handle Ant specific needs - */ -public class TaskSubTask extends TemplateSubTask { - public final static String SUBTASK_NAME = "tasks"; - - - public String getSubTaskName() { - return SUBTASK_NAME; - } - - /** - * Returns true if the class is an Ant task. This causes the task to be processed - * by the XDoclet template task. - */ - protected boolean matchesGenerationRules(ClassDoc clazz) throws XDocletException { - return isAntTask(clazz); - } - - /** - * Checks many factors to determine if the class is indeed an Ant task - * or not. - * - * @todo perhaps make deprecation switch configurable - */ - public static final boolean isAntTask(ClassDoc clazz) throws XDocletException { - if (clazz.isAbstract()) { - return false; - } - - // no inner classes (for now - but is this possible? desired?) - if (clazz.containingClass() != null) { - return false; - } - - String ignoreValue = XDocletTagSupport.getClassTagValue(clazz, "ant:task", "ignore", 0, null, "false", false, false); - boolean ignore = TypeConversionUtil.stringToBoolean(ignoreValue, true); - - if (ignore) { - return false; - } - -/* - Tag[] tags = clazz.tags(); - for (int i = 0; i < tags.length; i++) { - if ("@deprecated".equals(tags[i].name())) { - return false; - } - } -*/ - if (hasExecuteMethod(clazz)) { - return true; - } - - return false; - } - - /** - * Check for class implementing an execute() method. Recursive calls are - * made to superclasses. - */ - private static boolean hasExecuteMethod(ClassDoc clazz) { - if (clazz == null) { - return false; - } - - // It ain't a task if we've climbed back to Task itself. - // Also ignore other special Ant classes - if ("org.apache.tools.ant.Task".equals(clazz.qualifiedName()) || - "org.apache.tools.ant.Target".equals(clazz.qualifiedName()) || - "org.apache.tools.ant.TaskAdapter".equals(clazz.qualifiedName()) || - "org.apache.tools.ant.UnknownElement".equals(clazz.qualifiedName())) { - return false; - } - - // need to check that only runtime exceptions are thrown? - MethodDoc[] methods = clazz.methods(); - for (int i = 0; i < methods.length; i++) { - if ("execute".equals(methods[i].name())) { - if (methods[i].parameters().length == 0) { - if (methods[i].returnType().typeName().equals("void")) { - return true; - } - } - } - } - - return hasExecuteMethod(clazz.superclass()); - } - - /** - * Custom file naming. Use the task name for the file name rather than the - * default class name. - */ - protected String getGeneratedFileName(ClassDoc clazz) throws XDocletException { - String dir = TaskTagsHandler.getCategoryName(clazz); - String taskName = TaskTagsHandler.getTaskName(clazz); - - return new File(dir, taskName + ".xml").toString(); - } -} diff --git a/proposal/xdocs/src/org/apache/tools/ant/xdoclet/TaskTagsHandler.java b/proposal/xdocs/src/org/apache/tools/ant/xdoclet/TaskTagsHandler.java deleted file mode 100644 index b25c4a22c..000000000 --- a/proposal/xdocs/src/org/apache/tools/ant/xdoclet/TaskTagsHandler.java +++ /dev/null @@ -1,662 +0,0 @@ -/* - * The Apache Software License, Version 1.1 - * - * Copyright (c) 2002 The Apache Software Foundation. All rights - * reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions - * are met: - * - * 1. Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * 2. Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in - * the documentation and/or other materials provided with the - * distribution. - * - * 3. The end-user documentation included with the redistribution, if - * any, must include the following acknowlegement: - * "This product includes software developed by the - * Apache Software Foundation (http://www.apache.org/)." - * Alternately, this acknowlegement may appear in the software itself, - * if and wherever such third-party acknowlegements normally appear. - * - * 4. The names "The Jakarta Project", "Ant", and "Apache Software - * Foundation" must not be used to endorse or promote products derived - * from this software without prior written permission. For written - * permission, please contact apache@apache.org. - * - * 5. Products derived from this software may not be called "Apache" - * nor may "Apache" appear in their names without prior written - * permission of the Apache Group. - * - * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED - * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES - * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE - * DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR - * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, - * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT - * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF - * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND - * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, - * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT - * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF - * SUCH DAMAGE. - * ==================================================================== - * - * This software consists of voluntary contributions made by many - * individuals on behalf of the Apache Software Foundation. For more - * information on the Apache Software Foundation, please see - * . - */ -package org.apache.tools.ant.xdoclet; - -import com.sun.javadoc.*; -import org.apache.tools.ant.IntrospectionHelper; -import org.apache.tools.ant.types.EnumeratedAttribute; -import xdoclet.XDocletException; -import xdoclet.XDocletTagSupport; -import xdoclet.tags.AbstractProgramElementTagsHandler; -import xdoclet.tags.MethodTagsHandler; - -import java.util.ArrayList; -import java.util.Arrays; -import java.util.Collections; -import java.util.Comparator; -import java.util.Enumeration; -import java.util.HashMap; -import java.util.List; -import java.util.Map; -import java.util.Properties; -import java.lang.reflect.InvocationTargetException; - -/** - * Custom tag handler for XDoclet templates for Ant-specific processing. - * - * @author Erik Hatcher - * - * @todo clean up logic so that all setters are gathered first (even - * superclass) and sorted along wih them - * @todo need to create better logic for finding proper setters - * @todo add ifIsAntTask, among other convenience tags - */ -public class TaskTagsHandler extends XDocletTagSupport { - - /** Default category for tasks without a category attribute. */ - public static final String DEFAULT_CATEGORY = "other"; - - /** - * Iterates over all Ant tasks - */ - public void forAllTasks(String template, Properties attributes) throws XDocletException { - ClassDoc[] classes = AbstractProgramElementTagsHandler.getAllClasses(); - ClassDoc cur_class = null; - - for (int i = 0; i < classes.length; i++) { - cur_class = classes[i]; - setCurrentClass(cur_class); - - if (TaskSubTask.isAntTask(cur_class)) { - generate(template); - } - } - } - - /** - * Iterates over all Ant attributes. - * - *@param template XDoclet template - *@param attributes Tag parameters - *@exception XDocletException Oops! - */ - public void forAllAttributes(String template, Properties attributes) throws XDocletException { - // throw exception if not an Ant task - - ClassDoc cur_class = getCurrentClass(); - - MethodDoc[] methods = getAttributeMethods(cur_class); - - for (int i = 0; i < methods.length; i++) { - setCurrentMethod(methods[i]); - generate(template); - } - } - - /** - * Determines if there's at least one Ant attribute. - * - *@param template XDoclet template - *@param attributes Tag parameters - *@exception XDocletException Oops! - */ - public void ifHasAttributes(String template, Properties attributes) throws XDocletException { - // throw exception if not an Ant task - - ClassDoc cur_class = getCurrentClass(); - - MethodDoc[] methods = getAttributeMethods(cur_class); - - if (methods.length > 0) { - generate(template); - } - } - - /** - * Iterates over all Ant nested element methods (addXXX, addConfiguredXXX, addXXX) - * - *@param template XDoclet template - *@param attributes Tag parameters - *@exception XDocletException Oops! - */ - public void forAllElements(String template, Properties attributes) throws XDocletException { - // throw exception if not an Ant task - - ClassDoc cur_class = getCurrentClass(); - - MethodDoc[] methods = getElementMethods(cur_class); - - for (int i = 0; i < methods.length; i++) { - setCurrentMethod(methods[i]); - generate(template); - } - } - - - /** - * Provides the element name for the current method - */ - public String elementName() throws XDocletException { - String methodName = getCurrentMethod().name(); - String elementName = ""; - if (methodName.startsWith("addConfigured")) { - elementName = methodName.substring(13, methodName.length()); - } else if (methodName.startsWith("add")) { - elementName = methodName.substring(3, methodName.length()); - } else if (methodName.startsWith("create")) { - elementName = methodName.substring(6, methodName.length()); - } - return elementName.toLowerCase(); - } - - static private Map attributeDisplayMap = new HashMap(); - static private Map elementDisplayMap = new HashMap(); - - static { - attributeDisplayMap.put("java.lang.String","String"); - attributeDisplayMap.put("boolean","boolean"); - attributeDisplayMap.put("org.apache.tools.ant.types.Path","Path"); - attributeDisplayMap.put("org.apache.tools.ant.types.Reference","Reference"); - attributeDisplayMap.put("java.io.File","File"); - attributeDisplayMap.put("java.util.Date","Date"); - attributeDisplayMap.put("java.net.URL","URL"); - attributeDisplayMap.put("java.lang.Long","long"); - attributeDisplayMap.put("java.lang.Integer","int"); - attributeDisplayMap.put("java.lang.Float","float"); - attributeDisplayMap.put("java.lang.Double","double"); - - elementDisplayMap.put("org.apache.tools.ant.types.Path","Path"); - elementDisplayMap.put("org.apache.tools.ant.types.FileSet","Fileset"); - elementDisplayMap.put("org.apache.tools.ant.taskdefs.Property", "see <property>"); - elementDisplayMap.put("org.apache.tools.ant.types.Mapper","Mapper"); - elementDisplayMap.put("org.apache.tools.ant.types.PatternSet", "Patternset"); - elementDisplayMap.put("org.apache.tools.ant.types.FileList","Filelist"); - elementDisplayMap.put("org.apache.tools.ant.types.FilterChain", "FilterChain"); - elementDisplayMap.put("org.apache.tools.ant.types.FilterSet", "Filterset"); - elementDisplayMap.put("org.apache.tools.ant.types.ZipFileSet", "ZipFileset"); - elementDisplayMap.put("org.apache.tools.ant.types.DirSet", "Dirset"); - elementDisplayMap.put("org.apache.tools.ant.types.XMLCatalog", "XMLCatalog"); - } - - public String displayAttributeType() throws XDocletException { - String methodType = getCurrentMethod().parameters()[0].type().qualifiedTypeName(); - String display = (String) attributeDisplayMap.get(methodType); - if (display == null) { - - System.out.println("type = " + methodType); - Class clazz = getAttributeClass(methodType); - if (clazz == null) { - return methodType; - } - - Object instance = null; - try { - instance = clazz.newInstance(); - } catch (InstantiationException e) { - } catch (IllegalAccessException e) { - } - - if (instance != null && instance instanceof EnumeratedAttribute) { - EnumeratedAttribute enum = (EnumeratedAttribute) instance; - String[] values = enum.getValues(); - display = ""; - for (int i=0; i < values.length; i++) { - display += """ + values[i] + """; - if (i != (values.length - 1)) { - display += ", "; - } - } - return display; - } - - display = ""; - } - return display; - } - - private Class getAttributeClass(String type) throws XDocletException { - Class clazz = null; - try { - clazz = Class.forName(type); - } catch (ClassNotFoundException e) { - int lastDotPosition = type.lastIndexOf('.'); - if (lastDotPosition < 0) { - // probably a primitive - return null; - } - type = type.substring(0,lastDotPosition) + "$" + type.substring(lastDotPosition + 1); - try { - clazz = Class.forName(type); - } catch (ClassNotFoundException e1) { - throw new XDocletException(e1.getMessage()); - } - } - return clazz; - } - - public String displayElementType() throws XDocletException { - String elementType = elementType(); - String display = (String) elementDisplayMap.get(elementType); - if (display == null) { - display = ""; - } - return display; - } - - /** - * Provides the element type for the current method - */ - public String elementType() throws XDocletException { - ClassDoc classDoc = elementClassDoc(); - if (classDoc == null) { - throw new XDocletException("Method is not an Ant element!"); - } - return classDoc.qualifiedName(); - } - - /** - * Provides the element type for the current method. If the return type - * is null, the first parameter is used. - */ - private ClassDoc elementClassDoc() { - ClassDoc classDoc = null; - String methodName = getCurrentMethod().name(); - if (methodName.startsWith("addConfigured") || - methodName.startsWith("add") || - methodName.startsWith("create")) { - classDoc = getCurrentMethod().returnType().asClassDoc(); - if (classDoc == null) { - Parameter[] params = getCurrentMethod().parameters(); - if (params.length == 1) { - classDoc = params[0].type().asClassDoc(); - } - } - } - return classDoc; - } - - /** - * Provides the Ant task name. - * - * @see #getTaskName(ClassDoc) - */ - public String taskName() throws XDocletException { - return getTaskName(getCurrentClass()); - } - - public String propertyName() { - return MethodTagsHandler.getPropertyNameFor( getCurrentMethod() ).toLowerCase(); - } - - private static String[] fluffPrefixes = { "set a","set the","sets a","sets the" }; - - public String shortMethodDescription() throws XDocletException { - Tag[] tags = getCurrentMethod().firstSentenceTags(); - String desc = null; - - if( tags != null && tags.length > 0 ) { - desc = tags[0].text(); - } - - if( desc == null || desc.length() == 0 ) - { - desc = "no description"; - } - - desc = desc.trim(); - String descLower = desc.toLowerCase(); - for (int i=0; i < fluffPrefixes.length; i++) { - String prefix = fluffPrefixes[i].toLowerCase() + " "; - if (descLower.startsWith(prefix)) { - desc = desc.substring(prefix.length()); - break; - } - } - - desc = desc.substring(0,1).toUpperCase() + desc.substring(1); - - if (!desc.endsWith(".")) { - desc += "."; - } - - return desc; - } - - /** - * Provides the Ant task name. - * - * Order of rules: - *
    - *
  1. Value of @ant:task name="..."
    2. - *
  2. Lowercased classname with "Task" suffix removed
    3. - *
- */ - public static final String getTaskName(ClassDoc clazz) throws XDocletException { - // sheesh! There should be a friendlier method than this! - String tagValue = getTagValue(clazz, "ant:task", "name", -1, - null, null, null, null, - null, false, XDocletTagSupport.FOR_CLASS, false); - - if (tagValue == null) { - // use classname, but strip "Task" suffix if there - tagValue = clazz.name(); - - if (tagValue.endsWith("Task")) { - tagValue = tagValue.substring(0, tagValue.indexOf("Task")); - } - - tagValue = tagValue.toLowerCase(); - } - return tagValue; - } - - /** - * Provides the Ant category name. - * - * @see #getCategoryName(ClassDoc) - */ - public String categoryName() throws XDocletException { - return getCategoryName(getCurrentClass()); - } - - /** - * Provides the Ant category name as the Value of the category attribute, - * @ant:task category="...". - */ - public static final String getCategoryName(ClassDoc clazz) throws XDocletException { - String tagValue = getTagValue(clazz, "ant:task", "category", -1, - null, null, null, null, - null, false, XDocletTagSupport.FOR_CLASS, false); - if (tagValue != null) { - tagValue = tagValue.toLowerCase(); - } else { - tagValue = DEFAULT_CATEGORY; - } - return tagValue; - } - - - /** - * @todo refactor to cache methods per class, and save some time - */ - private MethodDoc[] getAttributeMethods(ClassDoc cur_class) throws XDocletException { - // Use Ant's own introspection mechanism to gather the - // attributes this class supports - IntrospectionHelper is = null; - try { - is = IntrospectionHelper.getHelper(Class.forName(cur_class.qualifiedName())); - } catch (ClassNotFoundException e) { - throw new XDocletException(e,e.getMessage()); - } - - // Regroup the attributes, since IntrospectionHelper - // doesn't give us the whole data structure directly - Enumeration enum = is.getAttributes(); - Properties attributeTypeMap = new Properties(); - while (enum.hasMoreElements()) { - String name = (String) enum.nextElement(); - Class type = is.getAttributeType(name); - attributeTypeMap.setProperty(name, type.getName()); -// System.out.println(name + " = " + type.getName()); - } - - // We need to return MethodDoc[] from this method - // so get all methods from the current class - MethodDoc[] allMethods = getMethods(cur_class); - - // And now filter the MethodDoc's based - // on what IntrospectionHelper says - List attributeMethods = new ArrayList(); - for (int i = 0; i < allMethods.length; i++) { - MethodDoc method = allMethods[i]; - String methodName = method.name(); - if (!methodName.startsWith("set")) { - continue; - } - - String attributeName = methodName.substring(3).toLowerCase(); - if ((method.parameters().length != 1) || (!method.isPublic())) { - continue; - } - String attributeType = method.parameters()[0].typeName(); - - String mapAttribute = attributeTypeMap.getProperty(attributeName); - if (mapAttribute == null) { - continue; - } - - // inner classes are noted with $ in our map, but not - // n the parameter type name. - if (!attributeType.equals(mapAttribute.replace('$','.'))) { - continue; - } - -// System.out.println(methodName + " : " + attributeName + " : " + attributeType); - - attributeMethods.add(method); - } - - return (MethodDoc[]) attributeMethods.toArray(new MethodDoc[0]); - } - - /** - * @todo add checks for number parameters and appropriate return value - * check for proper exception too? - * method prefixes: add, create, addConfigured (but not addText) - * - * @todo add DynamicConfigurator (this should be noted in the template, not dealt with here) - */ - private MethodDoc[] getElementMethods(ClassDoc cur_class) throws XDocletException { - // Use Ant's own introspection mechanism to gather the - // elements this class supports - IntrospectionHelper is = null; - try { - is = IntrospectionHelper.getHelper(Class.forName(cur_class.qualifiedName())); - } catch (ClassNotFoundException e) { - throw new XDocletException(e.getMessage()); - } - - // Regroup the elements, since IntrospectionHelper - // doesn't give us the whole data structure directly - Enumeration enum = is.getNestedElements(); - Properties elementTypeMap = new Properties(); - while (enum.hasMoreElements()) { - String name = (String) enum.nextElement(); - Class type = is.getElementType(name); - elementTypeMap.setProperty(name, type.getName()); -// System.out.println(name + " = " + type.getName()); - } - - // We need to return MethodDoc[] from this method - // so get all methods from the current class - MethodDoc[] allMethods = getMethods(cur_class); - - // And now filter the MethodDoc's based - // on what IntrospectionHelper says - List elementMethods = new ArrayList(); - for (int i = 0; i < allMethods.length; i++) { - MethodDoc method = allMethods[i]; - String methodName = method.name(); - - // Object create(), void add(Object), void addConfigured(Object) - String elementName = null; - boolean adder = false; // true if addXXX or addConfiguredXXX - if (methodName.startsWith("create")) { - elementName = methodName.substring(6).toLowerCase(); - } - - if (methodName.startsWith("add")) { - int length = 3; - if (methodName.startsWith("addConfigured")) { - length = 13; - } - - elementName = methodName.substring(length).toLowerCase(); - adder = true; - } - - if (elementName == null) { - continue; - } - -// System.out.println("elementName = " + elementName); - String elementType = null; - if (adder) { - if (method.parameters().length != 1) { - continue; - } - elementType = method.parameters()[0].typeName(); - } else { - elementType = method.returnType().qualifiedTypeName(); - } - - if (!method.isPublic()) { - continue; - } - - String mapElementType = elementTypeMap.getProperty(elementName); -// System.out.println("elementType = " + elementType + " mapElementType = " + mapElementType); - if (mapElementType == null) { - continue; - } - - // inner classes are noted with $ in our map, but not - // the parameter type name. - if (!elementType.equals(mapElementType.replace('$','.'))) { - continue; - } - - - elementMethods.add(method); - } - - return (MethodDoc[]) elementMethods.toArray(new MethodDoc[0]); - } - - /** - * This is a slightly refactored (thank you IntelliJ) version of - * some cut-and-paste from XDoclet code. It sorts all methods together - * rather than in batches of superclasses like XDoclet stuff does. - */ - private MethodDoc[] getMethods(ClassDoc cur_class) throws XDocletException { - Map already = new HashMap(); - - List methods = new ArrayList(); - - while (cur_class != null) { - // hardcoded to stop when it hits Task, nothing there - // or above that needs to be processed - if (cur_class.qualifiedName().equals("org.apache.tools.ant.Task") || - cur_class.qualifiedName().equals("org.apache.tools.ant.taskdefs.MatchingTask")) { - break; - } - List curMethods = Arrays.asList(cur_class.methods()); - - for (int j = 0; j < curMethods.size(); j++) { - MethodDoc method = (MethodDoc) curMethods.get(j); - if (isDeprecated(method)) { - continue; - } - if (shouldIgnore(method)) { - continue; - } - String methodName = method.name(); - if (method.containingClass() == cur_class) { - if (already.containsKey(methodName) == false) { - already.put(methodName, method); - methods.add(method); - } - } - } - - cur_class = cur_class.superclass(); - } - - return sortMethods(methods); - } - - private boolean isDeprecated (MethodDoc method) { - Tag[] tags = method.tags(); - for (int i=0; i < tags.length; i++) { - if (tags[i].name().equals("@deprecated")) { - return true; - } - } - return false; - } - - /** - * For now, lump attributes and elements together since we won't - * have those tags on the same method. - */ - private boolean shouldIgnore (MethodDoc method) throws XDocletException { - String value = getTagValue(method, "ant:attribute", "ignore", -1, - null, null, null, null, - null, false, XDocletTagSupport.FOR_METHOD, false); - if ("true".equals(value)) { - return true; - } - value = getTagValue(method, "ant:element", "ignore", -1, - null, null, null, null, - null, false, XDocletTagSupport.FOR_METHOD, false); - if ("true".equals(value)) { - return true; - } - return false; - } - - private MethodDoc[] sortMethods(List methods) { - //sort methods - Collections.sort(methods, - new Comparator() { - public int compare(Object o1, Object o2) { - MethodDoc m1 = (MethodDoc) o1; - MethodDoc m2 = (MethodDoc) o2; - - return m1.name().compareTo(m2.name()); - } - - - public boolean equals(Object obj) { - //dumb - return obj == this; - } - }); - - return (MethodDoc[]) methods.toArray(new MethodDoc[0]); - } - - -} - diff --git a/proposal/xdocs/templates/task_defaults_properties.template b/proposal/xdocs/templates/task_defaults_properties.template deleted file mode 100644 index 99fbdb9ed..000000000 --- a/proposal/xdocs/templates/task_defaults_properties.template +++ /dev/null @@ -1,3 +0,0 @@ - -= - diff --git a/proposal/xdocs/templates/task_xdoc.template b/proposal/xdocs/templates/task_xdoc.template deleted file mode 100644 index f97a31658..000000000 --- a/proposal/xdocs/templates/task_xdoc.template +++ /dev/null @@ -1,60 +0,0 @@ - -deprecated="true" - matchingTask="true"> - - - - ]]> - - ]]> - - - - - - - deprecated="true" - briefType=""> - ]]> - - ]]> - - - - - - - deprecated="true" - briefType="" - - abstract="true"> - - ]]> - - ]]> - - - - - - - - - - deprecated="true"> - - ]]> - - - - - - - -