net.obvj.junit.utils.matchers

Class InstantiationNotAllowedMatcher

java.lang.Object

org.hamcrest.BaseMatcher<T>

org.hamcrest.TypeSafeDiagnosingMatcher<Class<?>>

net.obvj.junit.utils.matchers.InstantiationNotAllowedMatcher

All Implemented Interfaces:

org.hamcrest.Matcher<Class<?>>, org.hamcrest.SelfDescribing

public class InstantiationNotAllowedMatcher
extends org.hamcrest.TypeSafeDiagnosingMatcher<Class<?>>

A Matcher that checks that instantiation is not allowed for a given class, which is particularly useful for utility classes, for example.

First, the matcher verifies that all declared constructors are private, then it tries to produce a new instance using the default constructor, via Reflection.

A matching class should have all constructors declared as private and throw an exception, so the class will never be instantiated.

For example:

 private MyClass()
 {
     throw new UnsupportedOperationException("Instantiation not allowed");
 }
 

Since:

1.1.0

Author:

oswaldo.bapvic.jr

Constructor Summary

Constructors

Constructor and Description
InstantiationNotAllowedMatcher()

Method Summary

Modifier and Type	Method and Description
void	describeTo(org.hamcrest.Description description) Describes the "expected" pat of the test description.
static org.hamcrest.Matcher<Class<?>>	instantiationNotAllowed() Creates a matcher that matches if the examined class cannot be instantiated, which is particularly useful for utility classes.

Methods inherited from class org.hamcrest.TypeSafeDiagnosingMatcher

describeMismatch, matches

Methods inherited from class org.hamcrest.BaseMatcher

_dont_implement_Matcher___instead_extend_BaseMatcher_, toString

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

InstantiationNotAllowedMatcher

public InstantiationNotAllowedMatcher()

Method Detail

instantiationNotAllowed

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

Creates a matcher that matches if the examined class cannot be instantiated, which is particularly useful for utility classes.

For example:

 assertThat(TestUtils.class, instantiationNotAllowed())
 

Returns:

the matcher

describeTo

public void describeTo(org.hamcrest.Description description)

Describes the "expected" pat of the test description.

See Also:

SelfDescribing.describeTo(Description)