net.zer0bandwidth.android.lib.util

Class CollectionsZ<I>

java.lang.Object

net.zer0bandwidth.android.lib.util.CollectionsZ<I>

Type Parameters:

I - the class of item contained in the collection, if any

public final class CollectionsZ<I>
extends java.lang.Object

Provides additional utility methods for working with collections, beyond the stock Arrays and Collections classes. The class is meant to look like the Collections class in use. For methods that can be written statically, the class may be used as such. However, certain operations that need tighter links to particular class specifications require explicit type definition in the method prototypes. To support this, the class provides the of(java.lang.Class<T>) method, which creates a type-bound instance of the utility class, whose instance methods may then operate under this more controlled context. arrayConcat(I[]...) is an illustrative example of a method that needs this context:

     String[] asFoo = { "foo", "Foo", "FOO" } ;
     String[] asBar = { "bar", "Bar", "BAR" } ;
     String[] asFoobar = CollectionsZ.of( String.class )
             .arrayConcat( asFoo, asBar ) ;
     assertEquals( 6, asFoobar.length ) ;
 

Since:

zer0bandwidth-net/android 0.1.7 (#50)

Method Summary

Modifier and Type	Method and Description
I[]	arrayConcat(I[]... aArrays) Concatenates an arbitrary number of arrays of the same object type
protected I[]	newArray(int nSize) Creates a new empty array of the specified size.
static <T> CollectionsZ<T>	of(java.lang.Class<T> cls) This method provides a static way to obtain a parameterized instance of the CollectionsZ class so that its other nifty methods may be invoked under these conditions.
I[]	toArray(java.util.Collection<I> a) Provides a sane implementation of toArray() for collections which returns an array of the object's type.

Methods inherited from class java.lang.Object

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

Method Detail

of

public static <T> CollectionsZ<T> of(java.lang.Class<T> cls)

This method provides a static way to obtain a parameterized instance of the CollectionsZ class so that its other nifty methods may be invoked under these conditions.

Type Parameters:

T - the class of item contained in the collection

Parameters:

cls - the class of item contained in the collection

Returns:

a parameterized instance, for more finely-tuned operations

newArray

protected I[] newArray(int nSize)

Creates a new empty array of the specified size.

Parameters:

nSize - the initial capacity

Returns:

an array of objects of the templatized type

toArray

public I[] toArray(java.util.Collection<I> a)

Provides a sane implementation of toArray() for collections which returns an array of the object's type.

Parameters:

a - the collection to be converted to an array

Returns:

an array of elements in the collection, or null if the input was also null

arrayConcat

public I[] arrayConcat(I[]... aArrays)

Concatenates an arbitrary number of arrays of the same object type

Parameters:

aArrays - the arrays to be concatenated

Returns:

all arrays concatenated in the order they were specified