Instalación

Configura tu entorno de desarrollo en minutos y ejecuta tu primer test.

Requisitos previos

Herramienta	Versión mínima	Descargar
Java	21 LTS	OpenJDK
Maven	3.9+	Maven
Git	2.x	Git

Verifica tus instalaciones:

java -version
# openjdk version "21.0.x" 2024-XX-XX

mvn -version
# Apache Maven 3.9.x

git --version
# git version 2.x.x

Clonar el repositorio

git clone https://github.com/cazucito/java-collections.git
cd java-collections

Compilar el proyecto

# Compilar sin tests (rápido)
mvn clean compile

# Compilar con tests (recomendado)
mvn clean test

# Verificación completa (calidad de código incluida)
mvn clean verify

Éxito

Si ves BUILD SUCCESS, ¡todo está configurado correctamente!

Ejecutar tests específicos

# Todos los tests
mvn test

# Solo tests de ArrayList
mvn test -Dcucumber.filter.tags="@arraylist"

# Solo tests de un archivo feature específico
mvn test -Dcucumber.features="src/test/resources/features/list/arraylist_operations.feature"

Ver reportes

Después de ejecutar mvn verify, encuentra los reportes en:

target/
├── cucumber-report.html      # Reporte BDD con Cucumber
├── site/jacoco/index.html    # Cobertura de código
├── checkstyle-result.xml     # Análisis de estilo
└── spotbugsXml.xml           # Bugs encontrados

Abre target/cucumber-report.html en tu navegador para ver los resultados.

Comandos útiles

Formatear código

mvn spotless:apply

Solo verificar calidad (sin tests)

mvn clean verify -DskipTests

Ver ayuda de Maven

mvn help:describe -Dplugin=org.apache.maven.plugins:maven-compiler-plugin

Configuración IDE (VS Code)

1. Instala extensiones:
2. Extension Pack for Java
3. Cucumber (Gherkin) Full Support

4. Maven for Java

5. Abre el proyecto:

   code .
   

6. Configura Java 21 en .vscode/settings.json:

   {
     "java.configuration.runtimes": [
       {
         "name": "JavaSE-21",
         "path": "/path/to/jdk-21",
         "default": true
       }
     ]
   }
   

Solución de problemas

❌ "java.lang.UnsupportedClassVersionError"

Tu Java es anterior a la versión 21. Actualiza o configura JAVA_HOME correctamente.

export JAVA_HOME=/path/to/jdk-21
export PATH=$JAVA_HOME/bin:$PATH

❌ "Could not find artifact"

Limpia el caché de Maven:

rm -rf ~/.m2/repository
mvn clean install

❌ Tests fallan por codificación

Configura UTF-8 en tu terminal:

export MAVEN_OPTS="-Dfile.encoding=UTF-8"

Próximos pasos

➡️ Tu primer escenario BDD