|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| IArgumentMatcher | Line # 10 | 0 | 0 | - |
-1.0
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| No Tests | |||
| 1 | /* | |
| 2 | * Copyright (c) 2001-2006 OFFIS, Tammo Freese. | |
| 3 | * This program is made available under the terms of the MIT License. | |
| 4 | */ | |
| 5 | package org.easymock; | |
| 6 | ||
| 7 | /** | |
| 8 | * Decides whether an actual argument is accepted. | |
| 9 | */ | |
| 10 | public interface IArgumentMatcher { | |
| 11 | ||
| 12 | /** | |
| 13 | * Returns whether this matcher accepts the given argument. | |
| 14 | * <p> | |
| 15 | * Like Object.equals(), it should be aware that the argument passed might | |
| 16 | * be null and of any type. So you will usually start the method with an | |
| 17 | * instanceof and/or null check. | |
| 18 | * <p> | |
| 19 | * The method should <b>never</b> assert if the argument doesn't match. It | |
| 20 | * should only return false. EasyMock will take care of asserting if the | |
| 21 | * call is really unexpected. | |
| 22 | * | |
| 23 | * @param argument the argument | |
| 24 | * @return whether this matcher accepts the given argument. | |
| 25 | */ | |
| 26 | boolean matches(Object argument); | |
| 27 | ||
| 28 | /** | |
| 29 | * Appends a string representation of this matcher to the given buffer. In case | |
| 30 | * of failure, the printed message will show this string to allow to know which | |
| 31 | * matcher was used for the failing call. | |
| 32 | * | |
| 33 | * @param buffer the buffer to which the string representation is appended. | |
| 34 | */ | |
| 35 | void appendTo(StringBuffer buffer); | |
| 36 | } | |
|
||||||||||