Documentación en proceso


Vamos a ver cómo realizar tests en nuestros proyectos Spring Boot, con ejemplos de algunas acciones básicas.

Clases de tests

Las clases en las que situemos nuestros tests tendrás que ir precedidas de la anotación @SpringBootTest:

@SpringBootTest
public class RestExpedientesTest {
	...
}

Y cada test individual, será un método con la anotación @Test:

@Test
void getExpedienteTest() {

}

Before: ejecutar código antes de los tests

Disponemos de las anotaciones @BeforeEach y @BeforeAll para indicar código que queremos que se ejecute antes de cada test, o antes de todos los tests, respectivamente. Por ejemplo, para indicar que queremos hacer un mock (los mocks se explican más adelante) de la propiedad que contiene el secret antes de los tests, podemos hacerlo así:

@BeforeEach
void mocksecret() {
	ReflectionTestUtils.setField( jwtTokenUtil, "secret", "secreto" );
}

Comprobar valores

En nuestros tests, disponemos de diferentes formas de hacer aserciones. La primera de ellas, para comprobar valores, sería utilizando assertThat, que proporciona diferentes métodos para comprobar los valores (isNull, isEmpty, isEqualTo, etc.): 

import static org.assertj.core.api.Assertions.assertThat;


assertThat( titulaciones ).isNotNull();
assertThat( titulaciones ).isNotEmpty();
assertThat( precio ).isEqualTo( 27 );

Si queremos simular testear errores en nuestras aplicaciónes podemos utilizar assertThrows para comprobar que se lanza una excepción, especificando la clase de la excepción que se espera, y las instrucciones a ejecutar a ejecutar en un bloque de código del tipo () → { ... }:

import static org.junit.jupiter.api.Assertions.assertThrows;

assertThrows( TokenExpiredException.class, () -> jwtTokenUtil.getClaim( "Bearer " + tokenCaducado ) );
assertThrows( UnauthorizedException.class, () -> jwtTokenUtil.getClaim( "asdf" ) );

Mock

Un mock es una simulación de un objeto real; nos permite simular su comportamiento de forma aislada, eliminando dependencias. A efectos prácticos, un objeto mock será un objeto de la clase que indiquemos, cuyos métodos devolverán null por defecto. Para crear estos mocks y definir el comportamiento de los métodos que nos interesen, utilizamos Mockito. Vamos a ver cada uno de estos pasos, primero cómo crear un mock, y después cómo personalizar el comportamiento de los métodos.

Crear mocks

Mockito.mock() - Mock de un objeto

Con el método Mockito.mock() podemos crear un mock de un objeto de una clase o interfaz. Esto es, el mock se aplicará únicamente a ese objeto. Si es un bean que por ejemplo utilice otra clase, este mock no se aplicará a ese bean, únicamente al objeto que hemos indicado. Lo haremos así, dentro de un test:

UserRepository localMockRepository = Mockito.mock(UserRepository.class);

@Mock - Mock de un objeto (propiedad de la clase de test)

Podemos indicar en las propiedades de nuestra clase que contiene los tests, que estas sean mocks. Esto es, al igual que en el caso anterior, que sólo se apliquen a estos objetos. Lo haremos con la anotación @Mock:

@Mock
UserRepository mockRepository;

@MockBean - Mock de un bean a nivel global

Por último, podemos añadir la anotación @MockBean  las propiedades de la clase, que creará el mock a nivel global, de contexto. Esto quiere decir que todas las instancias de ese bean serán ese mock, en lugar de únicamente el objeto que definimos en la clase de los tests. Esto se aplicará a todos los tests que tengamos en la clase.

@MockBean
UserRepository mockRepository;

Mockear una propiedad de un objeto

Podemos mockear una propiedad de un objeto como hemos visto en un ejemplo anterior, utilizando ReflectionTestUtils.setField, indicando el objeto, el nombre de la propiedad, y el valor a asignarle:

@Autowired
JwtTokenUtil jwtTokenUtil;

@BeforeEach
void mocksecret() {
	ReflectionTestUtils.setField( jwtTokenUtil, "secret", "secreto" );
}

Mockear un método

Para hacer un mock de un método, disponemos de Mockito.when(...), al que le indicamos el método, con sus argumentos, y que posteriormente nos ofrece varios métodos para la respuesta, como .thenReturn( ... ) para indicar el valor a devolver o .thenThrow( ... ) para indicar una excepción a lanzar. En el siguiente ejemplo podemos ver dos ejemplos de esto para hacer un mock de getClaims, creando un token previamente, pasando un valor concreto como argumento o indicando que cualquier String:

import static org.mockito.ArgumentMatchers.any;

...

Map<String, Object> infoUser = new HashMap<>();
infoUser.put( "roleName", "G_OTROS" );
final Instant now = Instant.now();
// Creamos token con el usuario "guillermo.castillo@ticarum.es", codificado con el secret "secreto"
String token = Jwts.builder().setClaims( infoUser ).setSubject( "guillermo.castillo@ticarum.es" )
		.setIssuedAt( Date.from( now ) ).setExpiration( Date.from( now.plus( Duration.ofDays( 123 ) ) ) )
		.signWith( SignatureAlgorithm.HS256, TextCodec.BASE64.encode( "secreto" ) ).compact();

final Claims claims = Jwts.parser().setSigningKey( TextCodec.BASE64.encode( "secreto" ) ).parseClaimsJws( token ).getBody();

// Mock getClaims
Mockito.when( jwtTokenUtil.getClaim( "asdf" ) ).thenReturn(claims);

// Mock getClaims con cualquier argumento String
Mockito.when( jwtTokenUtil.getClaim( any(String.class) ).thenReturn(claims);

Aquí vemos que en el último when, el argumento que se le pasa a getClaim es any(String.class), indicando que cuando se ejecute ese método con cualquier argumento que sea de tipo String, se devolverá lo que se indica. Al igual que any, podemos utilizar nullable, para indicar que puede ser o de la clase que indiquemos, o null. Para esto tendremos que añadir sus imports, que al ser static no nos los autocompletará Eclipse:

import static org.mockito.ArgumentMatchers.any;
import static org.mockito.ArgumentMatchers.nullable;

Spy

A parte de hacer mocks, tenemos la opción de utilizar Spy, que en vez de crear un objeto falso, lo que nos permite es interceptar partes del objeto original. Se puede ver como un mock parcial, para por ejemplo simular el comportamiento de algunos métodos, pero manteniendo el comportamiento por defecto del resto. La forma de hacer esto es muy similar a los mocks, pero para simular el comportamiento de las llamadas a los métodos cambia un poco la sintaxis. Vamos a verlo.

Crear spies

Mockito.spy() - Spy de un objeto

Con el método Mockito.spy() podemos crear un spy de un objeto de una clase o interfaz. Esto es, el spy se aplicará únicamente a ese objeto. Si es un bean que por ejemplo utilice otra clase, este spy no se aplicará a ese bean, únicamente al objeto que hemos indicado. Lo haremos así, dentro de un test:

UserRepository localMockRepository = Mockito.spy(UserRepository.class);

@Spy - Spy de un objeto (propiedad de la clase de test)

Podemos indicar en las propiedades de nuestra clase que contiene los tests, que estas sean spies. Esto es, al igual que en el caso anterior, que sólo se apliquen a estos objetos. Lo haremos con la anotación @Spy:

@Spy
UserRepository mockRepository;

@SpyBean - Spy de un bean a nivel global

Por último, podemos añadir la anotación @SpyBean las propiedades de la clase, que creará el spy a nivel global, de contexto. Esto quiere decir que todas las instancias de ese bean serán ese spy, en lugar de únicamente el objeto que definimos en la clase de los tests. Esto se aplicará a todos los tests que tengamos en la clase.

@SpyBean
UserRepository mockRepository;

Simular un método con spy

En este caso, el concepto es igual que en los mocks, pero la sintaxis cambia ligeramente. En vez de Mockito.when( ... ).thenReturn( ... ), lo haremos con Mockito.doReturn( ... ).when( objeto ).metodo( ... ):

Mockito.doReturn( "asdf" ).when( expedientesService ).getExpediente( nullable( String.class ) );

Simular peticiones a servicio REST

Para simular peticiones http a nuestros servicios REST podemos hacer uso de mockMvc, de este modo:

import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;

import org.springframework.boot.test.autoconfigure.web.servlet.AutoConfigureMockMvc;
import org.springframework.test.web.servlet.MockMvc;

@SpringBootTest
@AutoConfigureMockMvc
public class RestTest {

	@Autowired
	MockMvc mockMvc;

	@Test
    void testHealth() {
        mockMvc.perform( get( "/public/healthz" ) ).andExpect( status().isOk() );
    }
}

Este es un ejemplo muy simple, pero podemos ver que se realiza una llamada get (habiendo añadido el import static), y se espera que la respuesta sea un 200 OK.

Documentación