Package net.sourceforge.pmd.util

Class CollectionUtil

  • @Deprecated
@InternalApi
public final class CollectionUtil
extends Object
    Deprecated.
    Is internal API
    Generic collection and array-related utility functions for java.util types. See ClassUtil for comparable facilities for short name lookup.
    Version:
    $Revision$
    Author:
    Brian Remedios

    • Field Detail

      • COLLECTION_INTERFACES_BY_NAMES

        public static final TypeMap COLLECTION_INTERFACES_BY_NAMES
        Deprecated.

      • COLLECTION_CLASSES_BY_NAMES

        public static final TypeMap COLLECTION_CLASSES_BY_NAMES
        Deprecated.

    • Method Detail

      • addWithoutDuplicates

        public static <T> int addWithoutDuplicates​(Collection<T> source,
                                           Collection<T> target)
        Deprecated.
        Add elements from the source to the target as long as they don't already exist there. Return the number of items actually added.
        Parameters:
        source -
        target -
        Returns:
        int

      • getCollectionTypeFor

        public static Class<?> getCollectionTypeFor​(String shortName)
        Deprecated.
        Returns the collection type if we recognize it by its short name.
        Parameters:
        shortName - String
        Returns:
        Class

      • isCollectionType

        public static boolean isCollectionType​(String typeName,
                                       boolean includeInterfaces)
        Deprecated.
        Return whether we can identify the typeName as a java.util collection class or interface as specified.
        Parameters:
        typeName - String
        includeInterfaces - boolean
        Returns:
        boolean

      • isCollectionType

        public static boolean isCollectionType​(Class<?> clazzType,
                                       boolean includeInterfaces)
        Deprecated.
        Return whether we can identify the typeName as a java.util collection class or interface as specified.
        Parameters:
        clazzType - Class
        includeInterfaces - boolean
        Returns:
        boolean

      • asSet

        public static <T> Set<T> asSet​(T[] items)
        Deprecated.
        Returns the items as a populated set.
        Parameters:
        items - Object[]
        Returns:
        Set

      • mapFrom

        public static <K,​V> Map<K,​V> mapFrom​(K[] keys,
                                                 V[] values)
        Deprecated.
        Creates and returns a map populated with the keyValuesSets where the value held by the tuples are they key and value in that order.
        Parameters:
        keys - K[]
        values - V[]
        Returns:
        Map

      • invertedMapFrom

        public static <K,​V> Map<V,​K> invertedMapFrom​(Map<K,​V> source)
        Deprecated.
        Returns a map based on the source but with the key & values swapped.
        Parameters:
        source - Map
        Returns:
        Map

      • toList

        public static <T> List<T> toList​(Iterator<T> it)
        Deprecated.
        Consumes all the elements of the iterator and returns a list containing them. The iterator is then unusable
        Parameters:
        it - An iterator
        Returns:
        a list containing the elements remaining on the iterator

      • arraysAreEqual

        @Deprecated
public static boolean arraysAreEqual​(Object value,
                                     Object otherValue)
        Deprecated.
        Objects.deepEquals(Object, Object)
        Returns true if the objects are array instances and each of their elements compares via equals as well.
        Parameters:
        value - Object
        otherValue - Object
        Returns:
        boolean

      • valuesAreTransitivelyEqual

        @Deprecated
public static boolean valuesAreTransitivelyEqual​(Object[] thisArray,
                                                 Object[] thatArray)
        Deprecated.
        Arrays.deepEquals(Object[], Object[])
        Returns whether the arrays are equal by examining each of their elements, even if they are arrays themselves.
        Parameters:
        thisArray - Object[]
        thatArray - Object[]
        Returns:
        boolean

      • isEmpty

        public static boolean isEmpty​(Object[] items)
        Deprecated.
        Returns whether the items array is null or has zero length.
        Parameters:
        items -
        Returns:
        boolean

      • isNotEmpty

        public static boolean isNotEmpty​(Object[] items)
        Deprecated.
        Returns whether the items array is non-null and has at least one entry.
        Parameters:
        items -
        Returns:
        boolean

      • areSemanticEquals

        @Deprecated
public static <T> boolean areSemanticEquals​(T[] a,
                                            T[] b)
        Deprecated.
        Arrays.deepEquals(Object[], Object[])
        Returns true if both arrays are if both are null or have zero-length, otherwise return the false if their respective elements are not equal by position.
        Type Parameters:
        T -
        Parameters:
        a -
        b -
        Returns:
        boolean

      • addWithoutDuplicates

        @Deprecated
public static <T> T[] addWithoutDuplicates​(T[] values,
                                           T newValue)
        Deprecated.
        If the newValue is already held within the values array then the values array is returned, otherwise a new array is created appending the newValue to the end.
        Type Parameters:
        T -
        Parameters:
        values -
        newValue -
        Returns:
        an array containing the union of values and newValue

      • addWithoutDuplicates

        @Deprecated
public static <T> T[] addWithoutDuplicates​(T[] values,
                                           T[] newValues)
        Deprecated.
        Returns an array of values as a union set of the two input arrays.
        Type Parameters:
        T -
        Parameters:
        values -
        newValues -
        Returns:
        the union of the two arrays