org.hamcrest.core
Class IsInstanceOf

java.lang.Object
  extended by org.hamcrest.BaseMatcher<T>
      extended by org.hamcrest.DiagnosingMatcher<java.lang.Object>
          extended by org.hamcrest.core.IsInstanceOf
All Implemented Interfaces:
Matcher<java.lang.Object>, SelfDescribing

public class IsInstanceOf
extends DiagnosingMatcher<java.lang.Object>

Tests whether the value is an instance of a class. Classes of basic types will be converted to the relevant "Object" classes


Constructor Summary
IsInstanceOf(java.lang.Class<?> expectedClass)
          Creates a new instance of IsInstanceOf
 
Method Summary
static
<T> Matcher<T>
any(java.lang.Class<T> type)
          Creates a matcher that matches when the examined object is an instance of the specified type, as determined by calling the Class.isInstance(Object) method on that type, passing the the examined object.
 void describeTo(Description description)
          Generates a description of the object.
static
<T> Matcher<T>
instanceOf(java.lang.Class<?> type)
          Creates a matcher that matches when the examined object is an instance of the specified type, as determined by calling the Class.isInstance(Object) method on that type, passing the the examined object.
protected  boolean matches(java.lang.Object item, Description mismatch)
           
 
Methods inherited from class org.hamcrest.DiagnosingMatcher
describeMismatch, matches
 
Methods inherited from class org.hamcrest.BaseMatcher
_dont_implement_Matcher___instead_extend_BaseMatcher_, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

IsInstanceOf

public IsInstanceOf(java.lang.Class<?> expectedClass)
Creates a new instance of IsInstanceOf

Parameters:
expectedClass - The predicate evaluates to true for instances of this class or one of its subclasses.
Method Detail

matches

protected boolean matches(java.lang.Object item,
                          Description mismatch)
Specified by:
matches in class DiagnosingMatcher<java.lang.Object>

describeTo

public void describeTo(Description description)
Description copied from interface: SelfDescribing
Generates a description of the object. The description may be part of a a description of a larger object of which this is just a component, so it should be worded appropriately.

Parameters:
description - The description to be built or appended to.

instanceOf

public static <T> Matcher<T> instanceOf(java.lang.Class<?> type)
Creates a matcher that matches when the examined object is an instance of the specified type, as determined by calling the Class.isInstance(Object) method on that type, passing the the examined object.

The created matcher assumes no relationship between specified type and the examined object.

For example:

assertThat(new Canoe(), instanceOf(Paddlable.class));


any

public static <T> Matcher<T> any(java.lang.Class<T> type)
Creates a matcher that matches when the examined object is an instance of the specified type, as determined by calling the Class.isInstance(Object) method on that type, passing the the examined object.

The created matcher forces a relationship between specified type and the examined object, and should be used when it is necessary to make generics conform, for example in the JMock clause with(any(Thing.class))

For example:

assertThat(new Canoe(), instanceOf(Canoe.class));