| /* |
| * Copyright (c) 2007 Mockito contributors |
| * This program is made available under the terms of the MIT License. |
| */ |
| |
| package org.mockito.verification; |
| |
| import org.mockito.Mockito; |
| import org.mockito.internal.verification.api.VerificationData; |
| |
| /** |
| * Allows verifying that certain behavior happened at least once / exact number |
| * of times / never. E.g: |
| * |
| * <pre class="code"><code class="java"> |
| * verify(mock, times(5)).someMethod("was called five times"); |
| * |
| * verify(mock, never()).someMethod("was never called"); |
| * |
| * verify(mock, atLeastOnce()).someMethod("was called at least once"); |
| * |
| * verify(mock, atLeast(2)).someMethod("was called at least twice"); |
| * |
| * verify(mock, atMost(3)).someMethod("was called at most 3 times"); |
| * |
| * </code></pre> |
| * |
| * <b>times(1) is the default</b> and can be omitted |
| * <p> |
| * See examples in javadoc for {@link Mockito#verify(Object, VerificationMode)} |
| */ |
| public interface VerificationMode { |
| |
| /** |
| * Performs the verification |
| */ |
| void verify(VerificationData data); |
| |
| /** |
| * Description will be prepended to the assertion error if verification fails. |
| * @param description The custom failure message |
| * @return VerificationMode |
| * @since 2.1.0 |
| */ |
| VerificationMode description(String description); |
| } |