com.teketik.test.mockinbean.SpyInBean Maven / Gradle / Ivy

Go to download
package com.teketik.test.mockinbean;

import org.mockito.Spy;
import org.springframework.boot.test.mock.mockito.SpyBean;

import java.lang.annotation.ElementType;
import java.lang.annotation.Repeatable;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

/**
 * Annotation used to inject a {@link Spy} of a Spring Bean in another Spring Bean for the duration of a test.
 * 
This is a convenient alternative to {@link SpyBean @SpyBean} that provides surgical spy injection without dirtying or polluting the Spring context:

 * Spys are injected for every test method and the original Spring Beans(s) are re-injected after the test class is done.
 * 

 * Example:

 * Assuming you have the following service:

 * 
 * @Service
 * public class MyService {
 *
 *     @Autowired
 *     private ThirdPartyApi thirdPartyApi;
 *
 *     public void doSomethingWithThirdPartyApi() {
 *         thirdPartyApi.doSomething(new Object());
 *     }
 * }
 * 
 * You can create a test for your service with a spied {@code ThirdPartyApi} like:
 *  * @SpringBootTest
 * public class MyServiceTest {
 *
 *     @SpyInBean(MyService.class)
 *     private ThirdPartyApi thirdPartyApi;
 *
 *     @Autowired
 *     private MyService myService;
 *
 *     @Test
 *     public void test() {
 *         myService.doSomethingWithThirdPartyApi();
 *         Mockito.verify(thirdPartyApi).doSomething(Mockito.any(Object.class));
 *     }
 * }
 * 
 * {@code thirdPartyApi} will be a {@link Spy} of the actual {@code ThirdPartyApi} Spring Bean that is recreated for every test method in {@code MyServiceTest} and {@code MyService}.

 * The original {@code ThirdPartyApi} Spring bean will be re-injected in {@code MyService} after all the tests of {@code MyServiceTest}.
 * 
 * In case the bean in which you are trying to inject a spy has multiple instances registered in the context, you can specify the {@link #name() name} of the bean:
 * 
 * @SpyInBean(value = MyService.class, name = "nameOfMyService")
 * private ThirdPartyApi thirdPartyApi;
 * 
 * 
 * You can also inject your spy in multiple beans by repeating the annotation:
 * 
 * @SpyInBean(MyFirstService.class),
 * @SpyInBean(MySecondService.class)
 * private ThirdPartyApi thirdPartyApi;
 * 
 * @author Antoine Meyer
 * @see MockInBean
 */
@Target({ElementType.FIELD})
@Retention(RetentionPolicy.RUNTIME)
@Repeatable(SpyInBeans.class)
public @interface SpyInBean {

    /**
     * @return the {@code class} of the Spring Bean in which you want your {@link Spy} to be injected for the duration of the test.
     */
    Class value();

    /**
     * @return the {@code name} of the Spring Bean in which you want your {@link Spy} to be injected for the duration of the test.

     * This is not necessary and is only useful if your context contains multiple Beans of the same type with different names.
     */
    String name() default "";

}