Package org.hamcrest.object

Class IsEventFrom

java.lang.Object

org.hamcrest.BaseMatcher<EventObject>

org.hamcrest.TypeSafeDiagnosingMatcher<EventObject>

org.hamcrest.object.IsEventFrom

All Implemented Interfaces:

Matcher<EventObject>, SelfDescribing

public class IsEventFrom
extends TypeSafeDiagnosingMatcher<EventObject>

Tests if the value is an event announced by a specific object.

Constructor Summary

Constructors

Constructor	Description
IsEventFrom(Class<?> eventClass, Object source)	Constructor, best called from eventFrom(Object) or eventFrom(Class, Object).

Method Summary

Modifier and Type	Method	Description
void	describeTo(Description description)	Generates a description of the object.
static Matcher<EventObject>	eventFrom(Class<? extends EventObject> eventClass, Object source)	Creates a matcher of EventObject that matches any object derived from eventClass announced by source.
static Matcher<EventObject>	eventFrom(Object source)	Creates a matcher of EventObject that matches any EventObject announced by source.
boolean	matchesSafely(EventObject item, Description mismatchDescription)	Subclasses should implement this.

Methods inherited from class org.hamcrest.TypeSafeDiagnosingMatcher

describeMismatch, matches

Methods inherited from class org.hamcrest.BaseMatcher

_dont_implement_Matcher___instead_extend_BaseMatcher_, isNotNull, toString

Methods inherited from class java.lang.Object

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

Constructor Details

IsEventFrom

public IsEventFrom(Class<?> eventClass,
 Object source)

Constructor, best called from eventFrom(Object) or eventFrom(Class, Object).

Parameters:

eventClass - the expected class of the event

source - the expected source of the event

Method Details

matchesSafely

public boolean matchesSafely(EventObject item,
 Description mismatchDescription)

Description copied from class: TypeSafeDiagnosingMatcher

Subclasses should implement this. The item will already have been checked for the specific type and will never be null.

Specified by:

matchesSafely in class TypeSafeDiagnosingMatcher<EventObject>

Parameters:

item - the item.

mismatchDescription - the mismatch description.

Returns:

boolean true/false depending if item matches matcher.

describeTo

public void describeTo(Description description)

Description copied from interface: SelfDescribing

Generates a description of the object. The description may be part of 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.

eventFrom

public static Matcher<EventObject> eventFrom(Class<? extends EventObject> eventClass,
 Object source)

Creates a matcher of EventObject that matches any object derived from eventClass announced by source. For example:

assertThat(myEvent, is(eventFrom(PropertyChangeEvent.class, myBean)))

Parameters:

eventClass - the class of the event to match on

source - the source of the event

Returns:

The matcher.

eventFrom

public static Matcher<EventObject> eventFrom(Object source)

Creates a matcher of EventObject that matches any EventObject announced by source. For example:

assertThat(myEvent, is(eventFrom(myBean)))

Parameters:

source - the source of the event

Returns:

The matcher.