net.java.dev.webdav.util

Class Utilities

java.lang.Object

net.java.dev.webdav.util.Utilities

public final class Utilities
extends Object

Common purpose utilities.

Author:

Markus KARG (mkarg@java.net)

Constructor Summary

Constructors

Constructor and Description
Utilities()

Method Summary

Methods

Modifier and Type	Method and Description
static <T> T[]	append(T[] firstArray, T[] secondArray) Expands an array by appending a second array.
static <T> List<T>	append(T t, T... ts) Combines t and ts into one single list of size 1 + ts.length.
static <T> T[]	array(T... ts) Builds an array from varargs.
static <T> T	buildInstanceOf(Class<T> cls) Supplies an instance of the specified class.
static <T> T	notNull(T t, String name) Ensures that t is not null.
static String	toString(Object object, Object... members) Default implementation for Object.toString().

Methods inherited from class java.lang.Object

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

Constructor Detail

Utilities

public Utilities()

Method Detail

buildInstanceOf

public static final <T> T buildInstanceOf(Class<T> cls)

Supplies an instance of the specified class.

Type Parameters:

T - The class provided to cls.

Parameters:

cls - The class of which an instance is to be supplied, or null.

Returns:

An instance of the specified class, or null if it is impossible to obtain it (e. g. the class does not exist or cls is null:

append

public static final <T> T[] append(T[] firstArray,
             T[] secondArray)

Expands an array by appending a second array.

Parameters:

firstArray - The array to expand by appending the second array.

secondArray - The array to append to the first array.

Returns:

An array holding all elements of the first and second array, in the provided order.

notNull

public static final <T> T notNull(T t,
            String name)
                       throws NullArgumentException

Ensures that t is not null.

Parameters:

t - The argument to check.

name - The name of the argument.

Returns:

t

Throws:

NullArgumentException - in case t is null.

append

public static final <T> List<T> append(T t,
                 T... ts)

Combines t and ts into one single list of size 1 + ts.length.

Parameters:

t - Set into the first position of the new list. Must not be null.

ts - Appended starting at position 1 into the new list. Must not be null.

Returns:

A new list containing first t then content of ts.

array

public static final <T> T[] array(T... ts)

Builds an array from varargs.

Parameters:

ts - Will become the content of the array.

Returns:

An array holding the complete content provided as varargs.

toString

public static final String toString(Object object,
              Object... members)

Default implementation for Object.toString().

Parameters:

object - The object for which to produce the string.

members - The object's members for which to produce the string.

Returns:

A string of the form "Classname[memberValue, memberValue, ..., memberValue]";