Class MocksControl

    • Field Detail

      • ONCE

        public static final Range ONCE
        Exactly one call.
      • AT_LEAST_ONCE

        public static final Range AT_LEAST_ONCE
        One or more calls.
      • ZERO_OR_MORE

        public static final Range ZERO_OR_MORE
        Zero or more calls.
    • Constructor Detail

      • MocksControl

        public MocksControl​(MockType type)
    • Method Detail

      • createMock

        public <T,​R> R createMock​(Class<T> toMock)
        Description copied from interface: IMocksControl
        Same as IMocksControl.mock(Class) but using the old naming.
        Specified by:
        createMock in interface IMocksControl
        Type Parameters:
        T - the interface or class that the mock object should implement/extend.
        R - the returned type. In general T == R but when mocking a generic type, it won't so to be nice with the caller, we return a different type
        Parameters:
        toMock - the interface or class that the mock object should implement/extend.
        Returns:
        the mock object.
      • createMock

        public <T,​R> R createMock​(String name,
                                        Class<T> toMock)
        Description copied from interface: IMocksControl
        Same as IMocksControl.mock(String, Class) but using the old naming.
        Specified by:
        createMock in interface IMocksControl
        Type Parameters:
        T - the interface or class that the mock object should implement/extend.
        R - the returned type. In general T == R but when mocking a generic type, it won't so to be nice with the caller, we return a different type
        Parameters:
        name - the name of the mock object.
        toMock - the interface or class that the mock object should implement/extend.
        Returns:
        the mock object.
      • createMock

        public <T,​R> R createMock​(String name,
                                        Class<T> toMock,
                                        ConstructorArgs constructorArgs,
                                        Method... mockedMethods)
        Description copied from interface: IMocksControl
        Specified by:
        createMock in interface IMocksControl
        Type Parameters:
        T - the class that the mock object should extend.
        R - the returned type. In general T == R but when mocking a generic type, it won't so to be nice with the caller, we return a different type
        Parameters:
        name - the name of the mock object.
        toMock - the class that the mock object should extend.
        constructorArgs - constructor and parameters used to instantiate the mock. If null, no constructor will be called
        mockedMethods - methods that will be mocked, other methods will behave normally. If empty, all methods will be mocked
        Returns:
        the mock object.
      • getMockedClass

        public static <T,​R extends T> Class<R> getMockedClass​(T proxy)
        Return the class of interface (depending on the mock type) that was mocked
        Type Parameters:
        T - Mocked class
        R - Mock class
        Parameters:
        proxy - Mock object
        Returns:
        the mocked class or interface
      • reset

        public void reset()
        Description copied from interface: IMocksControl
        Removes all expectations for the mock objects of this control.
        Specified by:
        reset in interface IMocksControl
      • resetToNice

        public void resetToNice()
        Description copied from interface: IMocksControl
        Removes all expectations for the mock objects of this control and turn them to nice mocks.
        Specified by:
        resetToNice in interface IMocksControl
      • resetToDefault

        public void resetToDefault()
        Description copied from interface: IMocksControl
        Removes all expectations for the mock objects of this control and turn them to default mocks.
        Specified by:
        resetToDefault in interface IMocksControl
      • resetToStrict

        public void resetToStrict()
        Description copied from interface: IMocksControl
        Removes all expectations for the mock objects of this control and turn them to strict mocks.
        Specified by:
        resetToStrict in interface IMocksControl
      • replay

        public void replay()
        Description copied from interface: IMocksControl
        Switches the control from record mode to replay mode.
        Specified by:
        replay in interface IMocksControl
      • checkOrder

        public void checkOrder​(boolean value)
        Description copied from interface: IMocksControl
        Switches order checking on and off.
        Specified by:
        checkOrder in interface IMocksControl
        Parameters:
        value - true switches order checking on, false switches it off.
      • makeThreadSafe

        public void makeThreadSafe​(boolean threadSafe)
        Description copied from interface: IMocksControl
        Makes the mock thread safe.
        Specified by:
        makeThreadSafe in interface IMocksControl
        Parameters:
        threadSafe - If the mock should be thread safe or not
      • checkIsUsedInOneThread

        public void checkIsUsedInOneThread​(boolean shouldBeUsedInOneThread)
        Description copied from interface: IMocksControl
        Check that the mock is called from only one thread
        Specified by:
        checkIsUsedInOneThread in interface IMocksControl
        Parameters:
        shouldBeUsedInOneThread - If it should be used in one thread only or not
      • andAnswer

        public IExpectationSetters<Object> andAnswer​(IAnswer<?> answer)
        Description copied from interface: IExpectationSetters
        Sets an object that will be used to calculate the answer for the expected invocation (either return a value, or throw an exception).
        Specified by:
        andAnswer in interface IExpectationSetters<Object>
        Parameters:
        answer - the object used to answer the invocation.
        Returns:
        this object to allow method call chaining.
      • andDelegateTo

        public IExpectationSetters<Object> andDelegateTo​(Object answer)
        Description copied from interface: IExpectationSetters
        Sets an object implementing the same interface as the mock. The expected method call will be delegated to it with the actual arguments. The answer returned by this call will then be the answer returned by the mock (either return a value, or throw an exception).
        Specified by:
        andDelegateTo in interface IExpectationSetters<Object>
        Parameters:
        answer - the object the call is delegated to.
        Returns:
        the value returned by the delegated call.
      • andStubAnswer

        public void andStubAnswer​(IAnswer<?> answer)
        Description copied from interface: IExpectationSetters
        Sets a stub object that will be used to calculate the answer for the expected invocation (either return a value, or throw an exception).
        Specified by:
        andStubAnswer in interface IExpectationSetters<Object>
        Parameters:
        answer - the object used to answer the invocation.
      • andStubDelegateTo

        public void andStubDelegateTo​(Object delegateTo)
        Description copied from interface: IExpectationSetters
        Sets a stub object implementing the same interface as the mock. The expected method call will be delegated to it with the actual arguments. The answer returned by this call will then be the answer returned by the mock (either return a value, or throw an exception).
        Specified by:
        andStubDelegateTo in interface IExpectationSetters<Object>
        Parameters:
        delegateTo - the object the call is delegated to.
      • times

        public IExpectationSetters<Object> times​(int min,
                                                 int max)
        Description copied from interface: IExpectationSetters
        Expect the last invocation between min and max times.
        Specified by:
        times in interface IExpectationSetters<Object>
        Parameters:
        min - the minimum number of invocations expected.
        max - the maximum number of invocations expected.
        Returns:
        this object to allow method call chaining.