org.apache.tools.ant.util

Class CollectionUtils

  • java.lang.Object
    • org.apache.tools.ant.util.CollectionUtils


  • public class CollectionUtils
    extends java.lang.Object
    A set of helper methods related to collection manipulation.
    Since:
    Ant 1.5
    • Field Summary

      Fields 
      Modifier and Type Field and Description
      static java.util.List EMPTY_LIST
      Deprecated. 
    • Constructor Summary

      Constructors 
      Constructor and Description
      CollectionUtils() 
    • Method Summary

      All Methods Static Methods Concrete Methods Deprecated Methods 
      Modifier and Type Method and Description
      static <E> java.util.Enumeration<E> append(java.util.Enumeration<E> e1, java.util.Enumeration<E> e2)
      Append one enumeration to another.
      static <T> java.util.Collection<T> asCollection(java.util.Iterator<? extends T> iter)
      Returns a collection containing all elements of the iterator.
      static <E> java.util.Enumeration<E> asEnumeration(java.util.Iterator<E> iter)
      Adapt the specified Iterator to the Enumeration interface.
      static <E> java.util.Iterator<E> asIterator(java.util.Enumeration<E> e)
      Adapt the specified Enumeration to the Iterator interface.
      static boolean equals(java.util.Dictionary<?,?> d1, java.util.Dictionary<?,?> d2)
      Deprecated. 
      since 1.6.x.
      static boolean equals(java.util.Vector<?> v1, java.util.Vector<?> v2)
      Deprecated. 
      since 1.6.x.
      static java.lang.String flattenToString(java.util.Collection<?> c)
      Creates a comma separated list of all values held in the given collection.
      static int frequency(java.util.Collection<?> c, java.lang.Object o)
      Counts how often the given Object occurs in the given collection using equals() for comparison.
      static <K,V> void putAll(java.util.Dictionary<? super K,? super V> m1, java.util.Dictionary<? extends K,? extends V> m2)
      Deprecated. 
      since 1.6.x.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Field Detail

      • EMPTY_LIST

        @Deprecated
        public static final java.util.List EMPTY_LIST
        Deprecated. 
    • Constructor Detail

      • CollectionUtils

        public CollectionUtils()
    • Method Detail

      • equals

        @Deprecated
        public static boolean equals(java.util.Vector<?> v1,
                                                 java.util.Vector<?> v2)
        Deprecated. since 1.6.x.
        Please use Vector.equals() or List.equals().
        Parameters:
        v1 - the first vector.
        v2 - the second vector.
        Returns:
        true if the vectors are equal.
        Since:
        Ant 1.5
      • equals

        @Deprecated
        public static boolean equals(java.util.Dictionary<?,?> d1,
                                                 java.util.Dictionary<?,?> d2)
        Deprecated. since 1.6.x.
        Dictionary does not have an equals. Please use Map.equals().

        Follows the equals contract of Java 2's Map.

        Parameters:
        d1 - the first directory.
        d2 - the second directory.
        Returns:
        true if the directories are equal.
        Since:
        Ant 1.5
      • flattenToString

        public static java.lang.String flattenToString(java.util.Collection<?> c)
        Creates a comma separated list of all values held in the given collection.
        Parameters:
        c - collection to transform
        Returns:
        string representation of the collection
        Since:
        Ant 1.8.0
      • putAll

        @Deprecated
        public static <K,V> void putAll(java.util.Dictionary<? super K,? super V> m1,
                                                    java.util.Dictionary<? extends K,? extends V> m2)
        Deprecated. since 1.6.x.
        Dictionary does not know the putAll method. Please use Map.putAll().
        Type Parameters:
        K - type of the key
        V - type of the value
        Parameters:
        m1 - the to directory.
        m2 - the from directory.
        Since:
        Ant 1.6
      • append

        public static <E> java.util.Enumeration<E> append(java.util.Enumeration<E> e1,
                                                          java.util.Enumeration<E> e2)
        Append one enumeration to another. Elements are evaluated lazily.
        Type Parameters:
        E - element type
        Parameters:
        e1 - the first enumeration.
        e2 - the subsequent enumeration.
        Returns:
        an enumeration representing e1 followed by e2.
        Since:
        Ant 1.6.3
      • asEnumeration

        public static <E> java.util.Enumeration<E> asEnumeration(java.util.Iterator<E> iter)
        Adapt the specified Iterator to the Enumeration interface.
        Type Parameters:
        E - element type
        Parameters:
        iter - the Iterator to adapt.
        Returns:
        an Enumeration.
      • asIterator

        public static <E> java.util.Iterator<E> asIterator(java.util.Enumeration<E> e)
        Adapt the specified Enumeration to the Iterator interface.
        Type Parameters:
        E - element type
        Parameters:
        e - the Enumeration to adapt.
        Returns:
        an Iterator.
      • asCollection

        public static <T> java.util.Collection<T> asCollection(java.util.Iterator<? extends T> iter)
        Returns a collection containing all elements of the iterator.
        Type Parameters:
        T - element type
        Parameters:
        iter - the Iterator to convert
        Returns:
        the collection
        Since:
        Ant 1.8.0
      • frequency

        public static int frequency(java.util.Collection<?> c,
                                    java.lang.Object o)
        Counts how often the given Object occurs in the given collection using equals() for comparison.
        Parameters:
        c - collection in which to search
        o - object to search
        Returns:
        frequency
        Since:
        Ant 1.8.0