Search code examples
javajunithamcrestjunit-rule

How to apply a Hamcrest matcher to the property of a class under test?


Is there a way to build a combined Hamcrest matcher which tests an object and the property of this object? - pseudo code:

both(
  instanceof(MultipleFailureException.class)
).and(
  // pseudo code starts
  adapt(
    new Adapter<MultipleFailureException, Iterable<Throwable>()
    {
      public Iterable<Throwable> getAdapter(MultipleFailureException item)
      {
        return item.getFailures();
      }
    }, 
    // pseudo code ends
    everyItem(instanceOf(IllegalArgumentException.class))
  )
)

Background: I have a JUnit test, which iterates over a collection of dynamic objects. Each object is expected to throw an exception when processed. The exceptions are collected. The test is expected to end with a MultipleFailureException containing a collection of these thrown exceptions:

protected final ExpectedException expectation = ExpectedException.none();
protected final ErrorCollector collector = new ErrorCollector();

@Rule
public RuleChain exceptionRules = RuleChain.outerRule(expectation).around(collector);

@Test
public void testIllegalEnumConstant()
{
  expectation.expect(/* pseudo code from above */);
  for (Object object : ILLEGAL_OBJECTS)
  {
    try
    {
      object.processWithThrow();
    }
    catch (Throwable T)
    {
      collector.addError(T);
    }
  }
}

Solution

  • I think you might be looking for hasProperty or hasPropertyWithValue

    See here for an example: https://theholyjava.wordpress.com/2011/10/15/hasproperty-the-hidden-gem-of-hamcrest-and-assertthat/

    Another example of something I worked with previously; here we check if we have a Quote method getModels() returns a collection of PhoneModel and one of the items in the collection has a property makeId that is equal to LG_ID and modelId that is equal to NEXUS_4_ID.

                assertThat(quote.getModels(),
                                hasItem(Matchers.<PhoneModel> hasProperty("makeId",
                                                equalTo(LG_ID))));
                assertThat(quote.getModels(),
                                hasItem(Matchers.<PhoneModel> hasProperty("modelId",
                                                equalTo(NEXUS_4_ID))));
        }
    

    For this to work, hamcrest relies on you adopting JavaBean conventions.