/*
* Copyright (c) 2001-2007 OFFIS, Tammo Freese.
* This program is made available under the terms of the MIT License.
*/
package org.easymock;
import java.lang.reflect.Proxy;
import java.util.Comparator;
import org.easymock.internal.LastControl;
import org.easymock.internal.MocksControl;
import org.easymock.internal.ObjectMethodsFilter;
import org.easymock.internal.matchers.*;
public class EasyMock {
/**
* Creates a mock object that implements the given interface, order checking
* is enabled by default.
*
* @param <T>
* the interface that the mock object should implement.
* @param toMock
* the class of the interface that the mock object should
* implement.
* @return the mock object.
*/
public static <T> T createStrictMock(Class<T> toMock) {
return createStrictControl().createMock(toMock);
}
/**
* Creates a mock object that implements the given interface, order checking
* is enabled by default.
* @param name the name of the mock object.
* @param toMock
* the class of the interface that the mock object should
* implement.
* @param <T>
* the interface that the mock object should implement.
* @return the mock object.
* @throws IllegalArgumentException if the name is not a valid Java identifier.
*/
public static <T> T createStrictMock(String name, Class<T> toMock) {
return createStrictControl().createMock(name, toMock);
}
/**
* Creates a mock object that implements the given interface, order checking
* is disabled by default.
*
* @param <T>
* the interface that the mock object should implement.
* @param toMock
* the class of the interface that the mock object should
* implement.
* @return the mock object.
*/
public static <T> T createMock(Class<T> toMock) {
return createControl().createMock(toMock);
}
/**
* Creates a mock object that implements the given interface, order checking
* is disabled by default.
* @param name the name of the mock object.
* @param toMock
* the class of the interface that the mock object should
* implement.
*
* @param <T>
* the interface that the mock object should implement.
* @return the mock object.
* @throws IllegalArgumentException if the name is not a valid Java identifier.
*/
public static <T> T createMock(String name, Class<T> toMock) {
return createControl().createMock(name, toMock);
}
/**
* Creates a mock object that implements the given interface, order checking
* is disabled by default, and the mock object will return <code>0</code>,
* <code>null</code> or <code>false</code> for unexpected invocations.
*
* @param <T>
* the interface that the mock object should implement.
* @param toMock
* the class of the interface that the mock object should
* implement.
* @return the mock object.
*/
public static <T> T createNiceMock(Class<T> toMock) {
return createNiceControl().createMock(toMock);
}
/**
* Creates a mock object that implements the given interface, order checking
* is disabled by default, and the mock object will return <code>0</code>,
* <code>null</code> or <code>false</code> for unexpected invocations.
* @param name the name of the mock object.
* @param toMock
* the class of the interface that the mock object should
* implement.
*
* @param <T>
* the interface that the mock object should implement.
* @return the mock object.
* @throws IllegalArgumentException if the name is not a valid Java identifier.
*/
public static <T> T createNiceMock(String name, Class<T> toMock) {
return createNiceControl().createMock(name, toMock);
}
/**
* Creates a control, order checking is enabled by default.
*
* @return the control.
*/
public static IMocksControl createStrictControl() {
return new MocksControl(MocksControl.MockType.STRICT);
}
/**
* Creates a control, order checking is disabled by default.
*
* @return the control.
*/
public static IMocksControl createControl() {
return new MocksControl(MocksControl.MockType.DEFAULT);
}
/**
* Creates a control, order checking is disabled by default, and the mock
* objects created by this control will return <code>0</code>,
* <code>null</code> or <code>false</code> for unexpected invocations.
*
* @return the control.
*/
public static IMocksControl createNiceControl() {
return new MocksControl(MocksControl.MockType.NICE);
}
/**
* Returns the expectation setter for the last expected invocation in the
* current thread.
*
* @param value
* the parameter is used to transport the type to the
* ExpectationSetter. It allows writing the expected call as
* argument, i.e.
* <code>expect(mock.getName()).andReturn("John Doe")<code>.
*
* @return the expectation setter.
*/
@SuppressWarnings("unchecked")
public static <T> IExpectationSetters<T> expect(T value) {
return getControlForLastCall();
}
/**
* Returns the expectation setter for the last expected invocation in the
* current thread. This method is used for expected invocations on void
* methods.
*
* @return the expectation setter.
*/
@SuppressWarnings("unchecked")
public static IExpectationSetters<Object> expectLastCall() {
return getControlForLastCall();
}
private static IExpectationSetters getControlForLastCall() {
MocksControl lastControl = LastControl.lastControl();
if (lastControl == null) {
throw new IllegalStateException("no last call on a mock available");
}
return lastControl;
}
/**
* Expects any boolean argument. For details, see the EasyMock
* documentation.
*
* @return <code>false</code>.
*/
public static boolean anyBoolean() {
reportMatcher(Any.ANY);
return false;
}
/**
* Expects any byte argument. For details, see the EasyMock documentation.
*
* @return <code>0</code>.
*/
public static byte anyByte() {
reportMatcher(Any.ANY);
return 0;
}
/**
* Expects any char argument. For details, see the EasyMock documentation.
*
* @return <code>0</code>.
*/
public static char anyChar() {
reportMatcher(Any.ANY);
return 0;
}
/**
* Expects any int argument. For details, see the EasyMock documentation.
*
* @return <code>0</code>.
*/
public static int anyInt() {
reportMatcher(Any.ANY);
return 0;
}
/**
* Expects any long argument. For details, see the EasyMock documentation.
*
* @return <code>0</code>.
*/
public static long anyLong() {
reportMatcher(Any.ANY);
return 0;
}
/**
* Expects any float argument. For details, see the EasyMock documentation.
*
* @return <code>0</code>.
*/
public static float anyFloat() {
reportMatcher(Any.ANY);
return 0;
}
/**
* Expects any double argument. For details, see the EasyMock documentation.
*
* @return <code>0</code>.
*/
public static double anyDouble() {
reportMatcher(Any.ANY);
return 0;
}
/**
* Expects any short argument. For details, see the EasyMock documentation.
*
* @return <code>0</code>.
*/
public static short anyShort() {
reportMatcher(Any.ANY);
return 0;
}
/**
* Expects any Object argument. For details, see the EasyMock documentation.
*
* @return <code>null</code>.
*/
public static Object anyObject() {
reportMatcher(Any.ANY);
return null;
}
/**
* Expects a comparable argument greater than or equal the given value. For details, see
* the EasyMock documentation.
*
* @param value
* the given value.
* @return <code>null</code>.
*/
public static <T extends Comparable<T>> T geq(Comparable<T> value) {
reportMatcher(new GreaterOrEqual<T>(value));
return null;
}
/**
* Expects a byte argument greater than or equal to the given value. For
* details, see the EasyMock documentation.
*
* @param value
* the given value.
* @return <code>0</code>.
*/
public static byte geq(byte value) {
reportMatcher(new GreaterOrEqual<Byte>(value));
return 0;
}
/**
* Expects a double argument greater than or equal to the given value. For
* details, see the EasyMock documentation.
*
* @param value
* the given value.
* @return <code>0</code>.
*/
public static double geq(double value) {
reportMatcher(new GreaterOrEqual<Double>(value));
return 0;
}
/**
* Expects a float argument greater than or equal to the given value. For
* details, see the EasyMock documentation.
*
* @param value
* the given value.
* @return <code>0</code>.
*/
public static float geq(float value) {
reportMatcher(new GreaterOrEqual<Float>(value));
return 0;
}
/**
* Expects an int argument greater than or equal to the given value. For
* details, see the EasyMock documentation.
*
* @param value
* the given value.
* @return <code>0</code>.
*/
public static int geq(int value) {
reportMatcher(new GreaterOrEqual<Integer>(value));
return 0;
}
/**
* Expects a long argument greater than or equal to the given value. For
* details, see the EasyMock documentation.
*
* @param value
* the given value.
* @return <code>0</code>.
*/
public static long geq(long value) {
reportMatcher(new GreaterOrEqual<Long>(value));
return 0;
}
/**
* Expects a short argument greater than or equal to the given value. For
* details, see the EasyMock documentation.
*
* @param value
* the given value.
* @return <code>0</code>.
*/
public static short geq(short value) {
reportMatcher(new GreaterOrEqual<Short>(value));
return 0;
}
/**
* Expects a comparable argument less than or equal the given value. For details, see
* the EasyMock documentation.
*
* @param value
* the given value.
* @return <code>null</code>.
*/
public static <T extends Comparable<T>> T leq(Comparable<T> value) {
reportMatcher(new LessOrEqual<T>(value));
return null;
}
/**
* Expects a byte argument less than or equal to the given value. For
* details, see the EasyMock documentation.
*
* @param value
* the given value.
* @return <code>0</code>.
*/
public static byte leq(byte value) {
reportMatcher(new LessOrEqual<Byte>(value));
return 0;
}
/**
* Expects a double argument less than or equal to the given value. For
* details, see the EasyMock documentation.
*
* @param value
* the given value.
* @return <code>0</code>.
*/
public static double leq(double value) {
reportMatcher(new LessOrEqual<Double>(value));
return 0;
}
/**
* Expects a float argument less than or equal to the given value. For
* details, see the EasyMock documentation.
*
* @param value
* the given value.
* @return <code>0</code>.
*/
public static float leq(float value) {
reportMatcher(new LessOrEqual<Float>(value));
return 0;
}
/**
* Expects an int argument less than or equal to the given value. For
* details, see the EasyMock documentation.
*
* @param value
* the given value.
* @return <code>0</code>.
*/
public static int leq(int value) {
reportMatcher(new LessOrEqual<Integer>(value));
return 0;
}
/**
* Expects a long argument less than or equal to the given value. For
* details, see the EasyMock documentation.
*
* @param value
* the given value.
* @return <code>0</code>.
*/
public static long leq(long value) {
reportMatcher(new LessOrEqual<Long>(value));
return 0;
}
/**
* Expects a short argument less than or equal to the given value. For
* details, see the EasyMock documentation.
*
* @param value
* the given value.
* @return <code>0</code>.
*/
public static short leq(short value) {
reportMatcher(new LessOrEqual<Short>(value));
return 0;
}
/**
* Expects a comparable argument greater than the given value. For details, see
* the EasyMock documentation.
*
* @param value
* the given value.
* @return <code>null</code>.
*/
public static <T extends Comparable<T>> T gt(Comparable<T> value) {
reportMatcher(new GreaterThan<T>(value));
return null;
}
/**
* Expects a byte argument greater than the given value. For details, see
* the EasyMock documentation.
*
* @param value
* the given value.
* @return <code>0</code>.
*/
public static byte gt(byte value) {
reportMatcher(new GreaterThan<Byte>(value));
return 0;
}
/**
* Expects a double argument greater than the given value. For details, see
* the EasyMock documentation.
*
* @param value
* the given value.
* @return <code>0</code>.
*/
public static double gt(double value) {
reportMatcher(new GreaterThan<Double>(value));
return 0;
}
/**
* Expects a float argument greater than the given value. For details, see
* the EasyMock documentation.
*
* @param value
* the given value.
* @return <code>0</code>.
*/
public static float gt(float value) {
reportMatcher(new GreaterThan<Float>(value));
return 0;
}
/**
* Expects an int argument greater than the given value. For details, see
* the EasyMock documentation.
*
* @param value
* the given value.
* @return <code>0</code>.
*/
public static int gt(int value) {
reportMatcher(new GreaterThan<Integer>(value));
return 0;
}
/**
* Expects a long argument greater than the given value. For details, see
* the EasyMock documentation.
*
* @param value
* the given value.
* @return <code>0</code>.
*/
public static long gt(long value) {
reportMatcher(new GreaterThan<Long>(value));
return 0;
}
/**
* Expects a short argument greater than the given value. For details, see
* the EasyMock documentation.
*
* @param value
* the given value.
* @return <code>0</code>.
*/
public static short gt(short value) {
reportMatcher(new GreaterThan<Short>(value));
return 0;
}
/**
* Expects a comparable argument less than the given value. For details, see
* the EasyMock documentation.
*
* @param value
* the given value.
* @return <code>null</code>.
*/
public static <T extends Comparable<T>> T lt(Comparable<T> value) {
reportMatcher(new LessThan<T>(value));
return null;
}
/**
* Expects a byte argument less than the given value. For details, see the
* EasyMock documentation.
*
* @param value
* the given value.
* @return <code>0</code>.
*/
public static byte lt(byte value) {
reportMatcher(new LessThan<Byte>(value));
return 0;
}
/**
* Expects a double argument less than the given value. For details, see the
* EasyMock documentation.
*
* @param value
* the given value.
* @return <code>0</code>.
*/
public static double lt(double value) {
reportMatcher(new LessThan<Double>(value));
return 0;
}
/**
* Expects a float argument less than the given value. For details, see the
* EasyMock documentation.
*
* @param value
* the given value.
* @return <code>0</code>.
*/
public static float lt(float value) {
reportMatcher(new LessThan<Float>(value));
return 0;
}
/**
* Expects an int argument less than the given value. For details, see the
* EasyMock documentation.
*
* @param value
* the given value.
* @return <code>0</code>.
*/
public static int lt(int value) {
reportMatcher(new LessThan<Integer>(value));
return 0;
}
/**
* Expects a long argument less than the given value. For details, see the
* EasyMock documentation.
*
* @param value
* the given value.
* @return <code>0</code>.
*/
public static long lt(long value) {
reportMatcher(new LessThan<Long>(value));
return 0;
}
/**
* Expects a short argument less than the given value. For details, see the
* EasyMock documentation.
*
* @param value
* the given value.
* @return <code>0</code>.
*/
public static short lt(short value) {
reportMatcher(new LessThan<Short>(value));
return 0;
}
/**
* Expects an object implementing the given class. For details, see the
* EasyMock documentation.
*
* @param <T>
* the accepted type.
* @param clazz
* the class of the accepted type.
* @return <code>null</code>.
*/
public static <T> T isA(Class<T> clazz) {
reportMatcher(new InstanceOf(clazz));
return null;
}
/**
* Expects a string that contains the given substring. For details, see the
* EasyMock documentation.
*
* @param substring
* the substring.
* @return <code>null</code>.
*/
public static String contains(String substring) {
reportMatcher(new Contains(substring));
return null;
}
/**
* Expects a boolean that matches both given expectations.
*
* @param first
* placeholder for the first expectation.
* @param second
* placeholder for the second expectation.
* @return <code>false</code>.
*/
public static boolean and(boolean first, boolean second) {
LastControl.reportAnd(2);
return false;
}
/**
* Expects a byte that matches both given expectations.
*
* @param first
* placeholder for the first expectation.
* @param second
* placeholder for the second expectation.
* @return <code>0</code>.
*/
public static byte and(byte first, byte second) {
LastControl.reportAnd(2);
return 0;
}
/**
* Expects a char that matches both given expectations.
*
* @param first
* placeholder for the first expectation.
* @param second
* placeholder for the second expectation.
* @return <code>0</code>.
*/
public static char and(char first, char second) {
LastControl.reportAnd(2);
return 0;
}
/**
* Expects a double that matches both given expectations.
*
* @param first
* placeholder for the first expectation.
* @param second
* placeholder for the second expectation.
* @return <code>0</code>.
*/
public static double and(double first, double second) {
LastControl.reportAnd(2);
return 0;
}
/**
* Expects a float that matches both given expectations.
*
* @param first
* placeholder for the first expectation.
* @param second
* placeholder for the second expectation.
* @return <code>0</code>.
*/
public static float and(float first, float second) {
LastControl.reportAnd(2);
return 0;
}
/**
* Expects an int that matches both given expectations.
*
* @param first
* placeholder for the first expectation.
* @param second
* placeholder for the second expectation.
* @return <code>0</code>.
*/
public static int and(int first, int second) {
LastControl.reportAnd(2);
return 0;
}
/**
* Expects a long that matches both given expectations.
*
* @param first
* placeholder for the first expectation.
* @param second
* placeholder for the second expectation.
* @return <code>0</code>.
*/
public static long and(long first, long second) {
LastControl.reportAnd(2);
return 0;
}
/**
* Expects a short that matches both given expectations.
*
* @param first
* placeholder for the first expectation.
* @param second
* placeholder for the second expectation.
* @return <code>0</code>.
*/
public static short and(short first, short second) {
LastControl.reportAnd(2);
return 0;
}
/**
* Expects an Object that matches both given expectations.
*
* @param <T>
* the type of the object, it is passed through to prevent casts.
* @param first
* placeholder for the first expectation.
* @param second
* placeholder for the second expectation.
* @return <code>null</code>.
*/
public static <T> T and(T first, T second) {
LastControl.reportAnd(2);
return null;
}
/**
* Expects a boolean that matches one of the given expectations.
*
* @param first
* placeholder for the first expectation.
* @param second
* placeholder for the second expectation.
* @return <code>false</code>.
*/
public static boolean or(boolean first, boolean second) {
LastControl.reportOr(2);
return false;
}
/**
* Expects a byte that matches one of the given expectations.
*
* @param first
* placeholder for the first expectation.
* @param second
* placeholder for the second expectation.
* @return <code>0</code>.
*/
public static byte or(byte first, byte second) {
LastControl.reportOr(2);
return 0;
}
/**
* Expects a char that matches one of the given expectations.
*
* @param first
* placeholder for the first expectation.
* @param second
* placeholder for the second expectation.
* @return <code>0</code>.
*/
public static char or(char first, char second) {
LastControl.reportOr(2);
return 0;
}
/**
* Expects a double that matches one of the given expectations.
*
* @param first
* placeholder for the first expectation.
* @param second
* placeholder for the second expectation.
* @return <code>0</code>.
*/
public static double or(double first, double second) {
LastControl.reportOr(2);
return 0;
}
/**
* Expects a float that matches one of the given expectations.
*
* @param first
* placeholder for the first expectation.
* @param second
* placeholder for the second expectation.
* @return <code>0</code>.
*/
public static float or(float first, float second) {
LastControl.reportOr(2);
return 0;
}
/**
* Expects an int that matches one of the given expectations.
*
* @param first
* placeholder for the first expectation.
* @param second
* placeholder for the second expectation.
* @return <code>0</code>.
*/
public static int or(int first, int second) {
LastControl.reportOr(2);
return first;
}
/**
* Expects a long that matches one of the given expectations.
*
* @param first
* placeholder for the first expectation.
* @param second
* placeholder for the second expectation.
* @return <code>0</code>.
*/
public static long or(long first, long second) {
LastControl.reportOr(2);
return 0;
}
/**
* Expects a short that matches one of the given expectations.
*
* @param first
* placeholder for the first expectation.
* @param second
* placeholder for the second expectation.
* @return <code>0</code>.
*/
public static short or(short first, short second) {
LastControl.reportOr(2);
return 0;
}
/**
* Expects an Object that matches one of the given expectations.
*
* @param <T>
* the type of the object, it is passed through to prevent casts.
* @param first
* placeholder for the first expectation.
* @param second
* placeholder for the second expectation.
* @return <code>null</code>.
*/
public static <T> T or(T first, T second) {
LastControl.reportOr(2);
return null;
}
/**
* Expects a boolean that does not match the given expectation.
*
* @param first
* placeholder for the expectation.
* @return <code>false</code>.
*/
public static boolean not(boolean first) {
LastControl.reportNot();
return false;
}
/**
* Expects a byte that does not match the given expectation.
*
* @param first
* placeholder for the expectation.
* @return <code>0</code>.
*/
public static byte not(byte first) {
LastControl.reportNot();
return 0;
}
/**
* Expects a char that does not match the given expectation.
*
* @param first
* placeholder for the expectation.
* @return <code>0</code>.
*/
public static char not(char first) {
LastControl.reportNot();
return 0;
}
/**
* Expects a double that does not match the given expectation.
*
* @param first
* placeholder for the expectation.
* @return <code>0</code>.
*/
public static double not(double first) {
LastControl.reportNot();
return 0;
}
/**
* Expects a float that does not match the given expectation.
*
* @param first
* placeholder for the expectation.
* @return <code>0</code>.
*/
public static float not(float first) {
LastControl.reportNot();
return first;
}
/**
* Expects an int that does not match the given expectation.
*
* @param first
* placeholder for the expectation.
* @return <code>0</code>.
*/
public static int not(int first) {
LastControl.reportNot();
return 0;
}
/**
* Expects a long that does not match the given expectation.
*
* @param first
* placeholder for the expectation.
* @return <code>0</code>.
*/
public static long not(long first) {
LastControl.reportNot();
return 0;
}
/**
* Expects a short that does not match the given expectation.
*
* @param first
* placeholder for the expectation.
* @return <code>0</code>.
*/
public static short not(short first) {
LastControl.reportNot();
return 0;
}
/**
* Expects an Object that does not match the given expectation.
*
* @param <T>
* the type of the object, it is passed through to prevent casts.
* @param first
* placeholder for the expectation.
* @return <code>null</code>.
*/
public static <T> T not(T first) {
LastControl.reportNot();
return null;
}
/**
* Expects a boolean that is equal to the given value.
*
* @param value
* the given value.
* @return <code>0</code>.
*/
public static boolean eq(boolean value) {
reportMatcher(new Equals(value));
return false;
}
/**
* Expects a byte that is equal to the given value.
*
* @param value
* the given value.
* @return <code>0</code>.
*/
public static byte eq(byte value) {
reportMatcher(new Equals(value));
return 0;
}
/**
* Expects a char that is equal to the given value.
*
* @param value
* the given value.
* @return <code>0</code>.
*/
public static char eq(char value) {
reportMatcher(new Equals(value));
return 0;
}
/**
* Expects a double that is equal to the given value.
*
* @param value
* the given value.
* @return <code>0</code>.
*/
public static double eq(double value) {
reportMatcher(new Equals(value));
return 0;
}
/**
* Expects a float that is equal to the given value.
*
* @param value
* the given value.
* @return <code>0</code>.
*/
public static float eq(float value) {
reportMatcher(new Equals(value));
return 0;
}
/**
* Expects an int that is equal to the given value.
*
* @param value
* the given value.
* @return <code>0</code>.
*/
public static int eq(int value) {
reportMatcher(new Equals(value));
return 0;
}
/**
* Expects a long that is equal to the given value.
*
* @param value
* the given value.
* @return <code>0</code>.
*/
public static long eq(long value) {
reportMatcher(new Equals(value));
return 0;
}
/**
* Expects a short that is equal to the given value.
*
* @param value
* the given value.
* @return <code>0</code>.
*/
public static short eq(short value) {
reportMatcher(new Equals(value));
return 0;
}
/**
* Expects an Object that is equal to the given value.
*
* @param value
* the given value.
* @return <code>null</code>.
*/
public static <T> T eq(T value) {
reportMatcher(new Equals(value));
return null;
}
/**
* Expects a boolean array that is equal to the given array, i.e. it has to
* have the same length, and each element has to be equal.
*
* @param value
* the given arry.
* @return <code>null</code>.
*/
public static boolean[] aryEq(boolean[] value) {
reportMatcher(new ArrayEquals(value));
return null;
}
/**
* Expects a byte array that is equal to the given array, i.e. it has to
* have the same length, and each element has to be equal.
*
* @param value
* the given arry.
* @return <code>null</code>.
*/
public static byte[] aryEq(byte[] value) {
reportMatcher(new ArrayEquals(value));
return null;
}
/**
* Expects a char array that is equal to the given array, i.e. it has to
* have the same length, and each element has to be equal.
*
* @param value
* the given arry.
* @return <code>null</code>.
*/
public static char[] aryEq(char[] value) {
reportMatcher(new ArrayEquals(value));
return null;
}
/**
* Expects a double array that is equal to the given array, i.e. it has to
* have the same length, and each element has to be equal.
*
* @param value
* the given arry.
* @return <code>null</code>.
*/
public static double[] aryEq(double[] value) {
reportMatcher(new ArrayEquals(value));
return null;
}
/**
* Expects a float array that is equal to the given array, i.e. it has to
* have the same length, and each element has to be equal.
*
* @param value
* the given arry.
* @return <code>null</code>.
*/
public static float[] aryEq(float[] value) {
reportMatcher(new ArrayEquals(value));
return null;
}
/**
* Expects an int array that is equal to the given array, i.e. it has to
* have the same length, and each element has to be equal.
*
* @param value
* the given arry.
* @return <code>null</code>.
*/
public static int[] aryEq(int[] value) {
reportMatcher(new ArrayEquals(value));
return null;
}
/**
* Expects a long array that is equal to the given array, i.e. it has to
* have the same length, and each element has to be equal.
*
* @param value
* the given arry.
* @return <code>null</code>.
*/
public static long[] aryEq(long[] value) {
reportMatcher(new ArrayEquals(value));
return null;
}
/**
* Expects a short array that is equal to the given array, i.e. it has to
* have the same length, and each element has to be equal.
*
* @param value
* the given arry.
* @return <code>null</code>.
*/
public static short[] aryEq(short[] value) {
reportMatcher(new ArrayEquals(value));
return null;
}
/**
* Expects an Object array that is equal to the given array, i.e. it has to
* have the same type, length, and each element has to be equal.
*
* @param <T>
* the type of the array, it is passed through to prevent casts.
* @param value
* the given arry.
* @return <code>null</code>.
*/
public static <T> T[] aryEq(T[] value) {
reportMatcher(new ArrayEquals(value));
return null;
}
/**
* Expects null.
*
* @return <code>null</code>.
*/
public static Object isNull() {
reportMatcher(Null.NULL);
return null;
}
/**
* Expects not null.
*
* @return <code>null</code>.
*/
public static Object notNull() {
reportMatcher(NotNull.NOT_NULL);
return null;
}
/**
* Expects a string that contains a substring that matches the given regular
* expression. For details, see the EasyMock documentation.
*
* @param regex
* the regular expression.
* @return <code>null</code>.
*/
public static String find(String regex) {
reportMatcher(new Find(regex));
return null;
}
/**
* Expects a string that matches the given regular expression. For details,
* see the EasyMock documentation.
*
* @param regex
* the regular expression.
* @return <code>null</code>.
*/
public static String matches(String regex) {
reportMatcher(new Matches(regex));
return null;
}
/**
* Expects a string that starts with the given prefix. For details, see the
* EasyMock documentation.
*
* @param prefix
* the prefix.
* @return <code>null</code>.
*/
public static String startsWith(String prefix) {
reportMatcher(new StartsWith(prefix));
return null;
}
/**
* Expects a string that ends with the given suffix. For details, see the
* EasyMock documentation.
*
* @param suffix
* the suffix.
* @return <code>null</code>.
*/
public static String endsWith(String suffix) {
reportMatcher(new EndsWith(suffix));
return null;
}
/**
* Expects a double that has an absolute difference to the given value that
* is less than the given delta. For details, see the EasyMock
* documentation.
*
* @param value
* the given value.
* @param delta
* the given delta.
* @return <code>0</code>.
*/
public static double eq(double value, double delta) {
reportMatcher(new EqualsWithDelta(value, delta));
return 0;
}
/**
* Expects a float that has an absolute difference to the given value that
* is less than the given delta. For details, see the EasyMock
* documentation.
*
* @param value
* the given value.
* @param delta
* the given delta.
* @return <code>0</code>.
*/
public static float eq(float value, float delta) {
reportMatcher(new EqualsWithDelta(value, delta));
return 0;
}
/**
* Expects an Object that is the same as the given value. For details, see
* the EasyMock documentation.
*
* @param <T>
* the type of the object, it is passed through to prevent casts.
* @param value
* the given value.
* @return <code>null</code>.
*/
public static <T> T same(T value) {
reportMatcher(new Same(value));
return null;
}
/**
* Switches the given mock objects (more exactly: the controls of the mock
* objects) to replay mode. For details, see the EasyMock documentation.
*
* @param mocks
* the mock objects.
*/
public static void replay(Object... mocks) {
for (Object mock : mocks) {
getControl(mock).replay();
}
}
/**
* Resets the given mock objects (more exactly: the controls of the mock
* objects). For details, see the EasyMock documentation.
*
* @param mocks
* the mock objects.
*/
public static void reset(Object... mocks) {
for (Object mock : mocks) {
getControl(mock).reset();
}
}
/**
* Verifies the given mock objects (more exactly: the controls of the mock
* objects).
*
* @param mocks
* the mock objects.
*/
public static void verify(Object... mocks) {
for (Object mock : mocks) {
getControl(mock).verify();
}
}
/**
* Switches order checking of the given mock object (more exactly: the
* control of the mock object) the on and off. For details, see the EasyMock
* documentation.
*
* @param mock
* the mock object.
* @param state
* <code>true</code> switches order checking on,
* <code>false</code> switches it off.
*/
public static void checkOrder(Object mock, boolean state) {
getControl(mock).checkOrder(state);
}
/**
* Reports an argument matcher. This method is needed to define own argument
* matchers. For details, see the EasyMock documentation.
*
* @param matcher
*/
public static void reportMatcher(IArgumentMatcher matcher) {
LastControl.reportMatcher(matcher);
}
private static MocksControl getControl(Object mock) {
return ((ObjectMethodsFilter) Proxy
.getInvocationHandler(mock)).getDelegate().getControl();
}
/**
* Returns the arguments of the current mock method call, if inside an
* <code>IAnswer</code> callback - be careful here, reordering parameters of
* method changes the semantics of your tests.
*
* @return the arguments of the current mock method call.
* @throws IllegalStateException
* if called outside of <code>IAnswer</code> callbacks.
*/
public static Object[] getCurrentArguments() {
Object[] result = LastControl.getCurrentArguments();
if (result == null) {
throw new IllegalStateException(
"current arguments are only available when executing callback methods");
}
return result;
}
/**
* Expects a comparable argument equals to the given value according to their
* compareTo method. For details, see the EasyMock documentation.
*
* @param value
* the given value.
* @return <code>null</code>.
*/
public static <T extends Comparable<T>> T cmpEq(Comparable<T> value) {
reportMatcher(new CompareEqual<T>(value));
return null;
}
/**
* Expects an argument that will be compared using the provided comparator.
* The following comparison will take place:
* <p>
* <code>comparator.compare(actual, expected) operator 0</code>
* </p>
* For details, see the EasyMock documentation.
*
* @param value the given value.
* @param comparator Comparator used to compare the actual with expected value.
* @param operator The comparison operator.
* @return <code>null</code>
*/
public static <T> T cmp(T value, Comparator<T> comparator, LogicalOperator operator) {
reportMatcher(new Compare<T>(value, comparator, operator));
return null;
}
}