er.extensions.foundation

Class ERXSetUtilities

java.lang.Object

er.extensions.foundation.ERXSetUtilities

public class ERXSetUtilities
extends Object

Collection of NSSet utilities.

Constructor Summary

Constructors

Constructor and Description
ERXSetUtilities()

Method Summary

Modifier and Type	Method and Description
static <T> NSSet<T>	deepClone(NSSet<T> set, boolean onlyCollections) Returns a deep clone of the given set.
static <T> NSSet<T>	filteredSetWithQualifier(NSSet<T> set, com.webobjects.eocontrol.EOQualifier qualifier) Like EOQualifier.filteredArrayWithQualifier but for an NSSet.
static <T> void	filterSetWithQualifier(NSMutableSet<T> set, com.webobjects.eocontrol.EOQualifier qualifier) Like EOQualifier.filterArrayWithQualifier but for an NSMutableSet.
static <T> NSSet<T>	setFromArray(Collection<T> array) Simple utility method to create a concrete set object from an array.
static <T> NSArray<T>	sortedArrayFromSet(NSSet<T> set, com.webobjects.eocontrol.EOSortOrdering... orderings) Takes an unordered set and creates a sorted array from its elements.
static <T> NSArray<T>	sortedArrayFromSet(NSSet<T> set, NSArray<com.webobjects.eocontrol.EOSortOrdering> orderings) Takes an unordered set and creates a sorted array from its elements.
static <T> NSArray<T>	sortedArrayFromSet(NSSet<T> set, com.webobjects.foundation.NSComparator comparator) Takes an unordered set and creates a sorted array from its elements.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ERXSetUtilities

public ERXSetUtilities()

Method Detail

filteredSetWithQualifier

public static <T> NSSet<T> filteredSetWithQualifier(NSSet<T> set,
                                                    com.webobjects.eocontrol.EOQualifier qualifier)

Like EOQualifier.filteredArrayWithQualifier but for an NSSet.

Type Parameters:

T - type of set contents

Parameters:

set - the set to filter

qualifier - the qualifier to apply

Returns:

the filtered set

filterSetWithQualifier

public static <T> void filterSetWithQualifier(NSMutableSet<T> set,
                                              com.webobjects.eocontrol.EOQualifier qualifier)

Like EOQualifier.filterArrayWithQualifier but for an NSMutableSet.

Type Parameters:

T - type of set contents

Parameters:

set - the set to filter in-place

qualifier - the qualifier to apply

sortedArrayFromSet

public static <T> NSArray<T> sortedArrayFromSet(NSSet<T> set,
                                                NSArray<com.webobjects.eocontrol.EOSortOrdering> orderings)

Takes an unordered set and creates a sorted array from its elements.

Type Parameters:

T - type of set contents

Parameters:

set - the set containing the elements to sort

orderings - the sort orderings

Returns:

an array with sorted elements

sortedArrayFromSet

public static <T> NSArray<T> sortedArrayFromSet(NSSet<T> set,
                                                com.webobjects.eocontrol.EOSortOrdering... orderings)

Takes an unordered set and creates a sorted array from its elements.

Type Parameters:

T - type of set contents

Parameters:

set - the set containing the elements to sort

orderings - list of sort orderings

Returns:

an array with sorted elements

sortedArrayFromSet

public static <T> NSArray<T> sortedArrayFromSet(NSSet<T> set,
                                                com.webobjects.foundation.NSComparator comparator)
                                         throws com.webobjects.foundation.NSComparator.ComparisonException

Takes an unordered set and creates a sorted array from its elements.

Type Parameters:

T - type of set contents

Parameters:

set - the set containing the elements to sort

comparator - a comparator

Returns:

an array with sorted elements

Throws:

NSComparator.ComparisonException - if comparator cannot sort these elements

IllegalArgumentException - if comparator is null

setFromArray

public static <T> NSSet<T> setFromArray(Collection<T> array)

Simple utility method to create a concrete set object from an array.

Parameters:

array - of elements

Returns:

set created from given array

deepClone

public static <T> NSSet<T> deepClone(NSSet<T> set,
                                     boolean onlyCollections)

Returns a deep clone of the given set. A deep clone will attempt to clone the values of this set as well as the set itself.

Type Parameters:

T - class of set elements

Parameters:

set - the set to clone

onlyCollections - if true, only collections in this array will be cloned, not individual values

Returns:

a deep clone of set