Package org.jmock.api

Interface Expectation

  • All Superinterfaces:
    org.hamcrest.SelfDescribing
    All Known Implementing Classes:
    InvocationExpectation

    public interface Expectation
    extends org.hamcrest.SelfDescribing
    An object that matches, checks and fakes an Invocation
    Author:
    npryce, smgf
    • Method Detail

      • isSatisfied

        boolean isSatisfied()
        Have enough Invocations expected by this Expectation occurred?
        Returns:
        true if the expectation has received enough of its expected invocations, false otherwise.
      • allowsMoreInvocations

        boolean allowsMoreInvocations()
        Can more Invocations expected by this Expectation still occur?
        Returns:
        true if invocations expected by this expectation can still occur, false otherwise.
      • matches

        boolean matches​(Invocation invocation)
        Can the Expectation be invoked with invocation?
        Parameters:
        invocation - to be matched
        Returns:
        true if the expectation can be invoked with invocation, false otherwise.
      • describeMismatch

        void describeMismatch​(Invocation invocation,
                              org.hamcrest.Description description)
      • invoke

        java.lang.Object invoke​(Invocation invocation)
                         throws java.lang.Throwable
        Invokes the expectation: records that the invocation has occurred and fakes some behaviour in response.
        Parameters:
        invocation - The invocation to record and fake.
        Returns:
        A result that is eventually returned from the method call that caused the invocation.
        Throws:
        java.lang.Throwable - An exception that is eventually thrown from the method call that caused the invocation.
        java.lang.IllegalStateException - The expectation has been invoked with a method that it doesn't match or the faked behaviour has been set up incorrectly. For example, IllegalStateException is thrown when trying to return a value or throw a checked exception that is incompatible with the return type of the method being mocked