Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/javiertuya/samples-test-spring

Ejemplos de automatización de pruebas con Spring Boot
https://github.com/javiertuya/samples-test-spring

bdd ci-cd-pipeline github-actions java jbehave jenkins junit maven spring-boot testing

Last synced: about 2 hours ago
JSON representation

Ejemplos de automatización de pruebas con Spring Boot

Awesome Lists containing this project

README 

        
[![Build Status](https://github.com/javiertuya/samples-test-spring/actions/workflows/build.yml/badge.svg)](https://github.com/javiertuya/samples-test-spring/actions/workflows/build.yml)

[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=my%3Asamples-test-spring&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=my%3Asamples-test-spring)

[![Javadoc](https://img.shields.io/badge/%20-javadoc-blue)](https://javiertuya.github.io/samples-test-spring/)



# samples-test-spring



Este proyecto es utilizado a modo de ejemplo para ilustrar algunos aspectos del desarrollo y automatización de pruebas para

las asignaturas relacionadas con ingenieria del software, sistemas de información y pruebas de softare.



[Descargar la última versión publicada](https://github.com/javiertuya/samples-test-spring/releases) - 

[Ver más detalles en el javadoc](https://javiertuya.github.io/samples-test-spring/)



## Contenido



Este proyecto ilustra:

- Diferentes configuraciones para la automatización de pruebas de aplicaciones Spring Boot (v3):

  - Pruebas unitarias de acceso a la base de datos con JUnit

  - Pruebas parametrizadas con JUnitParams

  - Utilización de mocks

  - Pruebas de servicios rest y controladores (MockMvc)

  - Pruebas de un interfaz de usuario web con Selenium

  - Pruebas del API con Zerocode

  - Uso de lombok para generar automaticamente getters y setters de entidades y DTOs

  - Automatización de pruebas BDD con JBehave (unitarias y de interfaz de usuario)

- Estructura de un proyecto maven y configuración del pom.xml:

  - Pruebas unitarias (ut), de integración (it) y sistema (st)

  - Generación de reports estandar (Surefire)

  - Generación de reports de cobertura de código (JaCoCo)

  - Reports de resultados de test en formato JUnit html

- Integración continua con GitHub Actions (proceso completo CI/CD):

  - Estructuración del worflow con varios jobs que se comunican mediante artefactos

  - Publicación de resultados de test que fallan

  - Configuración de selenoid como servicio de navegadores, incluyendo grabación de video de las sesiones

  - Análisis estático de calidad del código 

  (SonarQube alojado en [sonarcloud.io](https://sonarcloud.io/project/overview?id=my:samples-test-spring))

  - Análisis estático de vulnerabilidad de dependencias (OWASP Dependench Check)

  - Despliegue de la aplicación en Azure:

    - En diferentes entornos:

      - [rama main: producción](https://samples-test-spring-main.azurewebsites.net/) 

      - [otras ramas: preproducción/integración](https://samples-test-spring-develop.azurewebsites.net/)

      - NOTA: el primer acceso a estos despliegues puede tardar bastantes segundos hasta que el container esté listo

    - Prueba Post-deploy de sistema (st) con 

      [selenium](https://github.com/SeleniumHQ/selenium) 

      y [zerocode](https://github.com/authorjapps/zerocode)

  - Ejemplo de despliegue en Heroku (obsoleto)

- Integración continua con Jenkins (para ejecución on-premise):

  - Fichero Jenkinsfile con la configuración de la pipeline

  - Incluye acciones análogas a las usadas en GitHub Actions (excepto despliegue)



## Requisitos e Instalación



- [Descargar la última versión](https://github.com/javiertuya/samples-test-spring/releases) y disponer al menos de Java 17 JDK

- Opción 1: Apache Maven:

	- Asegurarse de que JAVA_HOME apunta a un JDK y no JRE

	- Todas las pruebas y javadoc: `mvn install`

	- Solo javadoc: `mvn package -DskipTests=true`

	- Solo pruebas unitarias (ut): `mvn test -Dtest=**/ut/**`

	- Solo pruebas de integración (it) web con Selenium: `mvn test -Dtest=**/it/**`

	- Solo pruebas de sistema (st) para postdeploy:

	  - Arrancar el servidor en `src/main/java`

	  - `mvn test -Dtest=**/st/**`

- Opción 2: Eclipse con M2Eclipse instalado (distribuciones como Oxigen IDE for Java EE Developers ya lo incluyen).

Desde la raiz del proyecto:

	- Asegurarse de que se tiene instalado Lombok. Ver: https://projectlombok.org/setup/eclipse)

	- Asegurarse de que se tiene configurado un JDK: Desde build path, editar JRE System Library y en Environment

	comprobar que JavaSE-17 apunta a un JDK en vez de un JRE

	- *Maven->Update Project*

	- *Run As->Maven test*

	- Para ejecutar desde el entorno (run as JUnit Test) 



## Reports

La instalacion anterior compilará, ejecutará pruebas y dispondrá de los reports en `target`:



- `site/surefire-report.html`: report estandar de las pruebas unitarias

- `site/junit*`: report consolidado de todas las pruebas con el formato que genera junit

- `site/screenshot`: Imagenes tomadas durante las pruebas web con Selenium

- `site/jacoco`: reports de cobertura de código.

- `target/jbehave`: reports estandar de jbehave

- `target/zerocode-junit*.html`: reports estandar de zerocode

- `reports/testapidocs/index.html`: javadoc del proyecto (generados en la fase `package`)