org.apache.tools.ant.types.resources: public class: Sort

org.apache.tools.ant.types.resources
public class: Sort [javadoc | source]

java.lang.Object
   org.apache.tools.ant.ProjectComponent
      org.apache.tools.ant.types.DataType
         org.apache.tools.ant.types.resources.BaseResourceCollectionWrapper
            org.apache.tools.ant.types.resources.Sort

All Implemented Interfaces:
ResourceCollection, Cloneable

ResourceCollection that sorts another ResourceCollection. Note that Sort must not be used in cases where the ordering of the objects being sorted might change during the sorting process.

since: Ant - 1.7

Fields inherited from org.apache.tools.ant.types.DataType:
ref, checked

Fields inherited from org.apache.tools.ant.ProjectComponent:
project, location, description

Method from org.apache.tools.ant.types.resources.Sort Summary:
add, dieOnCircularReference, getCollection

Methods from org.apache.tools.ant.types.resources.BaseResourceCollectionWrapper:
add, dieOnCircularReference, getCollection, getResourceCollection, isCache, isFilesystemOnly, iterator, setCache, size, toString

Methods from org.apache.tools.ant.types.DataType:
checkAttributesAllowed, checkChildrenAllowed, circularReference, clone, dieOnCircularReference, dieOnCircularReference, dieOnCircularReference, getCheckedRef, getCheckedRef, getCheckedRef, getCheckedRef, getDataTypeName, getRefid, invokeCircularReferenceCheck, isChecked, isReference, noChildrenAllowed, setChecked, setRefid, toString, tooManyAttributes

Methods from org.apache.tools.ant.ProjectComponent:
clone, getDescription, getLocation, getProject, log, log, setDescription, setLocation, setProject

Methods from java.lang.Object:
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method from org.apache.tools.ant.types.resources.Sort Detail:
public synchronized void add(ResourceComparator c) { if (isReference()) { throw noChildrenAllowed(); } comp.add(c); FailFast.invalidate(this); } Add a ResourceComparator to this Sort ResourceCollection. If multiple ResourceComparators are added, they will be processed in LIFO order.
protected synchronized void dieOnCircularReference(Stack stk, Project p) throws BuildException { if (isChecked()) { return; } if (isReference()) { super.dieOnCircularReference(stk, p); } else { DataType.invokeCircularReferenceCheck(comp, stk, p); setChecked(true); } } Overrides the BaseResourceCollectionContainer version to recurse on nested ResourceComparators.
protected synchronized Collection getCollection() { ResourceCollection rc = getResourceCollection(); Iterator iter = rc.iterator(); if (!(iter.hasNext())) { return Collections.EMPTY_SET; } SortedBag b = new SortedBag(comp); while (iter.hasNext()) { b.add(iter.next()); } return b; } Sort the contained elements.

Method from org.apache.tools.ant.types.resources.Sort Detail:

 public synchronized  void add(ResourceComparator c) {
        if (isReference()) {
            throw noChildrenAllowed();
        }
        comp.add(c);
        FailFast.invalidate(this);
}

Add a ResourceComparator to this Sort ResourceCollection. If multiple ResourceComparators are added, they will be processed in LIFO order.

 protected synchronized  void dieOnCircularReference(Stack stk,
    Project p) throws BuildException {
        if (isChecked()) {
            return;
        }
        if (isReference()) {
            super.dieOnCircularReference(stk, p);
        } else {
            DataType.invokeCircularReferenceCheck(comp, stk, p);
            setChecked(true);
        }
}

Overrides the BaseResourceCollectionContainer version to recurse on nested ResourceComparators.

 protected synchronized Collection getCollection() {
                  
        ResourceCollection rc = getResourceCollection();
        Iterator iter = rc.iterator();
        if (!(iter.hasNext())) {
            return Collections.EMPTY_SET;
        }
        SortedBag b = new SortedBag(comp);
        while (iter.hasNext()) {
            b.add(iter.next());
        }
        return b;
}

Sort the contained elements.