uk.org.lidalia.test

Class Assert

java.lang.Object

uk.org.lidalia.test.Assert

public final class Assert
extends Object

Utility Hamcrest matchers for unit test assertions.

Method Summary

Methods

Modifier and Type	Method and Description
static <U,T extends U> uk.org.lidalia.test.FeatureMatcher<Class<? extends T>,Class<? extends U>>	aClassWhoseSuperClass(org.hamcrest.Matcher<? extends Class<? extends U>> classMatcher) Facilitates making an assertion about the superclass of a Class.
static <T extends Collection<?>> org.hamcrest.Matcher<T>	aCollectionWhoseSize(org.hamcrest.Matcher<Integer> sizeMatcher) Facilitates making an assertion about the size of a Collection.
static <T extends List<? extends E>,E> org.hamcrest.Matcher<T>	aListWhoseElementAtIndex(Integer index, org.hamcrest.Matcher<E> matcher) Facilitates making an assertion about the element at a given index of a List.
static <T extends Member> org.hamcrest.Matcher<T>	isAMemberWithModifier(uk.org.lidalia.lang.Modifier modifier) Asserts that a given Member has a given Modifier.
static org.hamcrest.Matcher<Class<?>>	isNotInstantiable() Asserts that a class is not instantiable - it exists only for its static members.

Methods inherited from class java.lang.Object

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

Method Detail

isNotInstantiable

public static org.hamcrest.Matcher<Class<?>> isNotInstantiable()

Asserts that a class is not instantiable - it exists only for its static members.

More precisely, asserts that the class:

• Has Object as its immediate superclass
• Has only one constructor
• That constructor is private
• That constructor takes no arguments
• That constructor will throw an UnsupportedOperationException with message "Not Instantiable" if it is invoked via reflection.

Usage: assertThat(Values.class, isNotInstantiable());

Returns:

a matcher that asserts that a class is not instantiable

aClassWhoseSuperClass

public static <U,T extends U> uk.org.lidalia.test.FeatureMatcher<Class<? extends T>,Class<? extends U>> aClassWhoseSuperClass(org.hamcrest.Matcher<? extends Class<? extends U>> classMatcher)

Facilitates making an assertion about the superclass of a Class.

Usage: assertThat(String.class, is(aClassWhoseSuperClass(is(Object.class))));

Type Parameters:

U - the type of the superclass of the class being matched

T - the type of the class being matched

Parameters:

classMatcher - the matcher that will be applied to the class's superclass

Returns:

a matcher that will assert something about the superclass of a class

aCollectionWhoseSize

public static <T extends Collection<?>> org.hamcrest.Matcher<T> aCollectionWhoseSize(org.hamcrest.Matcher<Integer> sizeMatcher)

Facilitates making an assertion about the size of a Collection.

Usage: assertThat(asList(1, 2, 3), is(aCollectionWhoseSize(is(3))));

Type Parameters:

T - the type of the collection whose size will be matched

Parameters:

sizeMatcher - the matcher that will be applied to the collection's size

Returns:

a matcher that will assert something about a collection's size

aListWhoseElementAtIndex

public static <T extends List<? extends E>,E> org.hamcrest.Matcher<T> aListWhoseElementAtIndex(Integer index,
                                                                               org.hamcrest.Matcher<E> matcher)

Facilitates making an assertion about the element at a given index of a List.

Usage: assertThat(asList("a", "b", "c"), is(aListWhoseElementAtIndex(2, is("c"))));

Type Parameters:

T - the type of the List

E - the type of the elements in the List

Parameters:

index - the index of the element in the list the matcher will be applied to

matcher - the matcher that will be applied to the element

Returns:

a matcher that will assert something about the element at the given index of a collection

isAMemberWithModifier

public static <T extends Member> org.hamcrest.Matcher<T> isAMemberWithModifier(uk.org.lidalia.lang.Modifier modifier)

Asserts that a given Member has a given Modifier.

Usage: assertThat(Object.class.getMethod("toString"), isAMemberWithModifier(Modifier.PUBLIC));

Type Parameters:

T - the type of the Member

Parameters:

modifier - the modifier the member is expected to have

Returns:

a matcher that will assert a member has a modifier