mockit.Capturing 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 APIs for the creation of the objects to be tested, for mocking dependencies, and for faking external APIs; JUnit (4 & 5) and TestNG test runners are supported. It also contains an advanced code coverage tool.

The newest version!

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

import static java.lang.annotation.ElementType.FIELD;
import static java.lang.annotation.ElementType.PARAMETER;
import static java.lang.annotation.RetentionPolicy.RUNTIME;

import java.lang.annotation.Retention;
import java.lang.annotation.Target;

/**
 * Indicates a mock field or a mock parameter for which all classes extending/implementing the {@linkplain Mocked
 * mocked} type will also get mocked.
 * 
 * Future instances of a capturing mocked type (ie, instances created sometime later during the test) will
 * become associated with the mock field/parameter. When recording or verifying expectations on the mock
 * field/parameter, these associated instances are regarded as equivalent to the original mocked instance created for
 * the mock field/parameter.
 *
 * @see Tutorial
 */
@Retention(RUNTIME)
@Target({ FIELD, PARAMETER })
public @interface Capturing {

    /**
     * Max instances.
     *
     * @return the int
     */
    int maxInstances() default Integer.MAX_VALUE;

}