Skip navigation links
org.identityconnectors.common
Class CollectionUtil
java.lang.Object
org.identityconnectors.common.CollectionUtil
-
public final class CollectionUtil
- extends java.lang.Object
Method Summary |
static
|
asReadOnlyList(java.util.List<T> list)
Returns a read-only list. |
static
|
asReadOnlyMap(java.util.Map<T,K> map)
|
static boolean |
equals(java.lang.Object o1, java.lang.Object o2)
Equality function that properly handles arrays, lists, maps, lists of arrays, and maps of arrays. |
static boolean |
equals(java.lang.Object o1, java.lang.Object o2, boolean ignoreCase)
|
static
|
forceCompare(java.lang.Object o1, java.lang.Object o2)
Forces the compare of two comparable objects and removes any warnings generated by the compiler. |
static int |
hashCode(java.lang.Object o)
hashCode function that properly handles arrays, collections, maps, collections of arrays, and maps of arrays. |
static
|
intersection(java.util.Collection<T> c1, java.util.Collection<T> c2)
Returns the intersection of two Collection s as an unmodifiable set. |
static boolean |
isCaseInsensitiveMap(java.util.Map<?,?> map)
Returns true if the given map is a case-insensitive map |
static boolean |
isCaseInsensitiveSet(java.util.Set<?> set)
Returns true if the given set is a case-insensitive set |
static
|
isEmpty(java.util.Collection<T> c)
Determine if Collection is empty or not, protects against null being passed in. |
static
<T> java.util.SortedMap<java.lang.String,T> |
|
newCaseInsensitiveMap()
Creates a case-insenstive map |
static java.util.SortedSet<java.lang.String> |
newCaseInsensitiveSet()
Creates a case-insensitive set |
static
|
newList(java.util.Collection<? extends T> c)
Create a modifiable list from the Collection provided. |
static
|
newList(T... arr)
Create a modifiable list from the arguments. |
static java.util.Map<java.lang.String,java.lang.String> |
newMap(java.util.Properties properties)
|
static
|
newMap(T[] k, K[] v)
Builds a map from two arrays. |
static
|
newMap(T k0, K v0)
|
static
|
newMap(T k0, K v0, T k1, K v1)
|
static
|
newMap(T k0, K v0, T k1, K v1, T k2, K v2)
|
static
|
newMap(T k0, K v0, T k1, K v1, T k2, K v2, T k3, K v3)
|
static
|
newMap(T k0, K v0, T k1, K v1, T k2, K v2, T k3, K v3, T k4, K v4)
|
static
|
newMap(T k0, K v0, T k1, K v1, T k2, K v2, T k3, K v3, T k4, K v4, T k5, K v5)
|
static
|
newMapFromLists(java.util.List<T> keys, java.util.List<K> values)
Converts two List to a map. |
static
|
newReadOnlyList(java.util.Collection<? extends T> c)
Creates an unmodifiable List from a collection. |
static
|
newReadOnlyList(java.util.List<? extends T> list)
Create an unmodifiable List based on the List passed in checks for null and returns an empty list if null is passed in. |
static
|
newReadOnlyList(T... obj)
Creates an unmodifiable List from a variable number arguments. |
static
|
newReadOnlyMap(java.util.Map<T,K> map)
|
static
|
newReadOnlyMap(T[][] kv)
|
static
|
newReadOnlySet(java.util.Collection<T> c)
Creates an unmodifiable set from a Collection . |
static
|
newReadOnlySet(T... arr)
Creates an unmodifiable set from a variable number arguments. |
static
|
newSet(java.util.Collection<T> c)
Creates a set that can be modified from the Collection provided. |
static
|
newSet(T... arr)
Creates a set that can be modified from the arguments. |
static
<T extends java.lang.Object & java.lang.Comparable<? super T>>
java.util.List<T> |
|
newSortedList(java.util.Collection<? extends T> col)
Create a modifiable sorted List based on the Collection provided. |
static
<T> java.util.Collection<T> |
|
nullAsEmpty(java.util.Collection<T> c)
Protects from null and returns a new instance of ArrayList if the parameter c is null. |
static
|
nullAsEmpty(java.util.List<T> list)
Protects from null and returns a new instance of ArrayList if the parameter list is null . |
static
|
nullAsEmpty(java.util.Map<T,K> map)
Protects from null and returns a new instance of HashMap if the parameter map is null . |
static
|
nullAsEmpty(java.util.Set<T> set)
Protects from null and returns a new instance of HashSet if the parameter set is null . |
static
|
union(java.util.Collection<T> c1, java.util.Collection<T> c2)
Returns the union of two Collection s as an unmodifiable set. |
static
<T> java.util.Collection<T> |
|
unique(java.util.Collection<T> c)
Use HashSet to create a unique Collection based on the one passed in. |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
newCaseInsensitiveSet
public static java.util.SortedSet<java.lang.String> newCaseInsensitiveSet()
- Creates a case-insensitive set
-
- Returns:
- An empty case-insensitive set
isCaseInsensitiveSet
public static boolean isCaseInsensitiveSet(java.util.Set<?> set)
- Returns true if the given set is a case-insensitive set
-
- Parameters:
set
- The set. May be null.
- Returns:
- true iff the given set is a case-insensitive set
newCaseInsensitiveMap
public static <T> java.util.SortedMap<java.lang.String,T> newCaseInsensitiveMap()
- Creates a case-insenstive map
-
- Type Parameters:
T
- The object type of the map
- Returns:
- An empty case-insensitive map
isCaseInsensitiveMap
public static boolean isCaseInsensitiveMap(java.util.Map<?,?> map)
- Returns true if the given map is a case-insensitive map
-
- Parameters:
map
- The map. May be null.
- Returns:
- true iff the given map is a case-insensitive map
nullAsEmpty
public static <T> java.util.Collection<T> nullAsEmpty(java.util.Collection<T> c)
- Protects from
null
and returns a new instance of ArrayList
if the parameter c is null. Otherwise return the parameter that was passed in.
nullAsEmpty
public static <T,K> java.util.Map<T,K> nullAsEmpty(java.util.Map<T,K> map)
- Protects from
null
and returns a new instance of HashMap
if the parameter map
is null
. Otherwise return the parameter that was passed in.
nullAsEmpty
public static <T> java.util.Set<T> nullAsEmpty(java.util.Set<T> set)
- Protects from
null
and returns a new instance of HashSet
if the parameter set
is null
. Otherwise return the parameter that was passed in.
nullAsEmpty
public static <T> java.util.List<T> nullAsEmpty(java.util.List<T> list)
- Protects from
null
and returns a new instance of ArrayList
if the parameter list
is null
. Otherwise return the parameter that was passed in.
isEmpty
public static <T> boolean isEmpty(java.util.Collection<T> c)
- Determine if
Collection
is empty or not, protects against null being passed in.
unique
public static <T> java.util.Collection<T> unique(java.util.Collection<T> c)
- Use
HashSet
to create a unique Collection
based on the one passed in. The method protects against null. The returned Collection
is unmodifiable.
newReadOnlyMap
public static <T,K> java.util.Map<T,K> newReadOnlyMap(java.util.Map<T,K> map)
asReadOnlyMap
public static <T,K> java.util.Map<T,K> asReadOnlyMap(java.util.Map<T,K> map)
newReadOnlyMap
public static <T> java.util.Map<T,T> newReadOnlyMap(T[][] kv)
newMapFromLists
public static <T,K> java.util.Map<T,K> newMapFromLists(java.util.List<T> keys,
java.util.List<K> values)
- Converts two
List
to a map. The order is important here because each key will map to one value.
newMap
public static java.util.Map<java.lang.String,java.lang.String> newMap(java.util.Properties properties)
newMap
public static <T,K> java.util.Map<T,K> newMap(T k0,
K v0)
newMap
public static <T,K> java.util.Map<T,K> newMap(T k0,
K v0,
T k1,
K v1)
newMap
public static <T,K> java.util.Map<T,K> newMap(T k0,
K v0,
T k1,
K v1,
T k2,
K v2)
newMap
public static <T,K> java.util.Map<T,K> newMap(T k0,
K v0,
T k1,
K v1,
T k2,
K v2,
T k3,
K v3)
newMap
public static <T,K> java.util.Map<T,K> newMap(T k0,
K v0,
T k1,
K v1,
T k2,
K v2,
T k3,
K v3,
T k4,
K v4)
newMap
public static <T,K> java.util.Map<T,K> newMap(T k0,
K v0,
T k1,
K v1,
T k2,
K v2,
T k3,
K v3,
T k4,
K v4,
T k5,
K v5)
newMap
public static <T,K> java.util.Map<T,K> newMap(T[] k,
K[] v)
- Builds a map from two arrays.
-
- Parameters:
k
- Array of keys.
v
- Array of values.
- Returns:
- a map based on the two arrays.
newSet
public static <T> java.util.Set<T> newSet(java.util.Collection<T> c)
- Creates a set that can be modified from the
Collection
provided.
newSet
public static <T> java.util.Set<T> newSet(T... arr)
- Creates a set that can be modified from the arguments.
newReadOnlySet
public static <T> java.util.Set<T> newReadOnlySet(T... arr)
- Creates an unmodifiable set from a variable number arguments.
newReadOnlySet
public static <T> java.util.Set<T> newReadOnlySet(java.util.Collection<T> c)
- Creates an unmodifiable set from a
Collection
.
union
public static <T> java.util.Set<T> union(java.util.Collection<T> c1,
java.util.Collection<T> c2)
- Returns the union of two
Collection
s as an unmodifiable set.
intersection
public static <T> java.util.Set<T> intersection(java.util.Collection<T> c1,
java.util.Collection<T> c2)
- Returns the intersection of two
Collection
s as an unmodifiable set.
newSortedList
public static <T extends java.lang.Object & java.lang.Comparable<? super T>> java.util.List<T> newSortedList(java.util.Collection<? extends T> col)
- Create a modifiable sorted
List
based on the Collection
provided.
newList
public static <T> java.util.List<T> newList(java.util.Collection<? extends T> c)
- Create a modifiable list from the
Collection
provided. The return value is backed by an ArrayList
.
newList
public static <T> java.util.List<T> newList(T... arr)
- Create a modifiable list from the arguments. The return value is backed by an
ArrayList
.
newReadOnlyList
public static <T> java.util.List<T> newReadOnlyList(java.util.List<? extends T> list)
- Create an unmodifiable
List
based on the List
passed in checks for null and returns an empty list if null is passed in. This one insures that the order is maintained between lists.
newReadOnlyList
public static <T> java.util.List<T> newReadOnlyList(T... obj)
- Creates an unmodifiable
List
from a variable number arguments.
newReadOnlyList
public static <T> java.util.List<T> newReadOnlyList(java.util.Collection<? extends T> c)
- Creates an unmodifiable
List
from a collection.
asReadOnlyList
public static <T> java.util.List<T> asReadOnlyList(java.util.List<T> list)
- Returns a read-only list. The list is backed by the original so no copy is made.
-
- Type Parameters:
T
- The type of the list
- Parameters:
list
- The list or null.
- Returns:
- A read-only proxy on the original list.
forceCompare
public static <T> int forceCompare(java.lang.Object o1,
java.lang.Object o2)
- Forces the compare of two comparable objects and removes any warnings generated by the compiler.
-
- Returns:
Comparable
the integer value of o1.compareTo(o2).
hashCode
public static int hashCode(java.lang.Object o)
- hashCode function that properly handles arrays, collections, maps, collections of arrays, and maps of arrays.
-
- Parameters:
o
- The object. May be null.
- Returns:
- the hashCode
equals
public static boolean equals(java.lang.Object o1,
java.lang.Object o2)
- Equality function that properly handles arrays, lists, maps, lists of arrays, and maps of arrays.
NOTE: For Sets, this relies on the equals method of the Set to do the right thing. This is a reasonable assumption since, in order for Sets to behave properly as Sets, their values must already have a proper implementation of equals. (Or they must be specialized Sets that define a custom comparator that knows how to do the right thing). The same holds true for Map keys. Map values, on the other hand, are compared (so Map values can be arrays).
-
- Parameters:
o1
- The first object. May be null.
o2
- The second object. May be null.
- Returns:
- true iff the two objects are equal.
equals
public static boolean equals(java.lang.Object o1,
java.lang.Object o2,
boolean ignoreCase)
Skip navigation links
Copyright © 2013, Oracle and/or its affiliates. All rights reserved.