mockit.FullVerifications Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of jmockit Show documentation

JMockit is a Java toolkit for automated developer testing. It contains mocking/faking APIs and a code coverage tool, supporting both JUnit and TestNG. The mocking APIs allow all kinds of Java code, without testability restrictions, to be tested in isolation from selected dependencies.

There is a newer version: 1.49

Show newest version

/*
 * Copyright (c) 2006 JMockit developers
 * This file is subject to the terms of the MIT license (see LICENSE.txt).
 */
package mockit;

import javax.annotation.*;

/**
 * Same as {@link Verifications}, but checking that all invocations from code under test are explicitly verified, except for those
 * already verified through other means.
 *  * // Exercise tested code.
 * codeUnderTest.doSomething();
 *
 * // Now verify that expected invocations occurred in any order, with no invocations left unverified.
 * new FullVerifications() {{
 *    mock1.expectedMethod(anyInt);
 *    mock2.anotherExpectedMethod(1, "test"); times = 2;
 * }};
 * 
 * Any invocation from code under test that is not covered by an explicit verification, or by an invocation count constraint when recorded,
 * will cause an assertion error to be thrown.
 *
 * @see #FullVerifications()
 * @see #FullVerifications(Object...)
 * @see Tutorial
 */
public abstract class FullVerifications extends Verifications
{
   /**
    * Begins full verification on the mocked types/instances that can potentially be invoked from code under test.
    *
    * @see #FullVerifications(Object...)
    */
   protected FullVerifications() { verificationPhase.setAllInvocationsMustBeVerified(); }

   /**
    * Same as {@link #FullVerifications()}, but restricting the verification to the specified mocked types and/or mocked instances.
    *
    * @param mockedTypesAndInstancesToVerify one or more of the mocked types (ie, Class objects) and/or mocked instances that are
    * in scope for the test; for a given mocked instance, all classes up to (but not including) java.lang.Object are
    * considered
    */
   protected FullVerifications(@Nonnull Object... mockedTypesAndInstancesToVerify) {
      this();
      verificationPhase.setMockedTypesToFullyVerify(mockedTypesAndInstancesToVerify);
   }
}