org.leialearns.common

Class Static

java.lang.Object

org.leialearns.common.Static

public class Static
extends Object

Provides static convenience methods.

Method Summary

Modifier and Type	Method and Description
static <T> List<T>	asList(Iterable<T> iterable) Converts the given iterable to a List.
static <T extends Comparable<T>> int	compare(T left, T right) Compares the two given objects, handling null values predictably.
static boolean	equal(Object thisObject, Object thatObject) Compares two objects.
static long	gcd(long a, long b)
static Class<?>	getLoggingClass(Object object) Returns the class that can be used to derive the logger name from.
static String	join(String separator, String[] parts) Joins an array of strings together using a given separator
static <T> T[]	newArrayInstance(Class<T> baseClass, int length) Creates a new array instance in a type safe way.
static <T> T[]	newArrayInstance(T[] template, int length) Creates a new array instance in a type safe way.
static <T> Iterable<T>	notNull(Iterable<T> iterable) Returns the given iterable, or an empty iterable if null is given.
static <T> T[]	offer(T head, T[] tail) Creates a copy of an array with a single item prepended to it.
static <T> T[]	offerArray(T[] prepend, T[] tail) Creates a copy of an array with another array prepended to it.
static <T> List<T>	toList(TypedIterable<T> iterable) Converts the given iterable to a List.

Methods inherited from class java.lang.Object

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

Method Detail

notNull

public static <T> Iterable<T> notNull(Iterable<T> iterable)

Returns the given iterable, or an empty iterable if null is given.

Type Parameters:

T - The base type of the iterable

Parameters:

iterable - The iterable

Returns:

The given iterable, or an empty iterable if null is given

asList

public static <T> List<T> asList(Iterable<T> iterable)

Converts the given iterable to a List. Note: traversing the iterable may destroy the original.

Type Parameters:

T - The base type of the iterable

Parameters:

iterable - The iterable

Returns:

A list that contains the elements of the given iterable

compare

public static <T extends Comparable<T>> int compare(T left,
                                                    T right)

Compares the two given objects, handling null values predictably. A null value is compared smaller than a non-null value. See Comparable.compareTo(Object) for the definition of the return value.

Type Parameters:

T - The type of both objects, extends Comparable

Parameters:

left - The left object

right - The right object

Returns:

an indication of whether left is smaller than, greater than or equal to right

offer

public static <T> T[] offer(T head,
                            @NotNull
                            T[] tail)

Creates a copy of an array with a single item prepended to it.

Type Parameters:

T - The base type of the array

Parameters:

head - The item to prepend

tail - The original array

Returns:

The extended array

offerArray

public static <T> T[] offerArray(T[] prepend,
                                 T[] tail)

Creates a copy of an array with another array prepended to it.

Type Parameters:

T - The base type of the array

Parameters:

prepend - The array to prepend

tail - The original array

Returns:

The extended array

newArrayInstance

public static <T> T[] newArrayInstance(T[] template,
                                       int length)

Creates a new array instance in a type safe way.

Type Parameters:

T - The base type of the new array

Parameters:

template - The original array

length - The length of the new array

Returns:

The new array

newArrayInstance

public static <T> T[] newArrayInstance(Class<T> baseClass,
                                       int length)

Creates a new array instance in a type safe way.

Type Parameters:

T - The base type of the new array

Parameters:

baseClass - The type of the elements of the array

length - The length of the new array

Returns:

The new array

equal

public static boolean equal(Object thisObject,
                            Object thatObject)

Compares two objects. This method is careful about null values.

Parameters:

thisObject - One object

thatObject - Other object

Returns:

true if the one object equals the other object; false otherwise

getLoggingClass

public static Class<?> getLoggingClass(Object object)

Returns the class that can be used to derive the logger name from. For CGLIB advised classes this is the super class of the object class.

Parameters:

object - The object to query

Returns:

The logging class of the object

join

public static String join(String separator,
                          String[] parts)

Joins an array of strings together using a given separator

Parameters:

separator - The separator to use

parts - An array of strings

Returns:

The concatenation of the parts with separators in between

toList

public static <T> List<T> toList(TypedIterable<T> iterable)

Converts the given iterable to a List. Note: traversing the iterable may destroy the original.

Type Parameters:

T - The base type of the iterable

Parameters:

iterable - The iterable

Returns:

A list that contains the elements of the given iterable

gcd

public static long gcd(long a,
                       long b)