Tutorial Quarkus con Gradle en Windows

Tutorial Completo de Quarkus con Gradle en Windows

1️⃣ Requisitos previos

• Java 17 o superior (ya tienes OpenJDK 21)
• PowerShell o CMD
• Quarkus CLI (opcional, recomendado)

2️⃣ Instalar Quarkus CLI (opcional)

Descarga desde https://quarkus.io/get-started/ → Command Line Tools

Verifica la instalación:

quarkus --version

Si no quieres instalar la CLI, puedes usar Maven directamente:

mvn io.quarkus:quarkus-maven-plugin:create ...

3️⃣ Crear el proyecto con Gradle

En PowerShell:

quarkus create app org.acme:inicio --extension=resteasy-reactive --gradle
cd inicio

• org.acme → nombre del grupo (groupId)
• inicio → nombre del proyecto / paquete base (artifactId)
• --extension=resteasy-reactive → agrega soporte para REST

Se generan los archivos:

• build.gradle y settings.gradle
• Carpeta src/main/java/org/acme/inicio/
• Carpeta src/main/resources/
• gradlew y gradlew.bat (Gradle Wrapper)

4️⃣ Ejecutar la aplicación en modo desarrollo

gradlew.bat quarkusDev

Servidor corriendo en http://localhost:8080

Endpoint por defecto: /hello → "Hello from RESTEasy Reactive"

Live Coding: los cambios en los archivos Java se reflejan automáticamente.

5️⃣ Crear un endpoint REST de práctica

package org.acme.inicio;

import jakarta.ws.rs.GET;
import jakarta.ws.rs.Path;
import jakarta.ws.rs.Produces;
import jakarta.ws.rs.core.MediaType;

@Path("/saludo")
public class SaludoResource {

    @GET
    @Produces(MediaType.APPLICATION_JSON)
    public Persona saludo() {
        return new Persona("Hugo", "¡Bienvenido a tu primera API en Quarkus con Gradle!");
    }

    public record Persona(String nombre, String mensaje) {}
}

Probar en: http://localhost:8080/saludo

6️⃣ Recibir parámetros en la URL

@Path("/saludo/{nombre}")
public class SaludoResource {

    @GET
    @Produces(MediaType.APPLICATION_JSON)
    public Persona saludo(@PathParam("nombre") String nombre) {
        return new Persona(nombre, "¡Bienvenido a Quarkus!");
    }

    public record Persona(String nombre, String mensaje) {}
}

Probar en: http://localhost:8080/saludo/Hugo

7️⃣ Estructura del proyecto

inicio/
├─ src/
│  ├─ main/java/org/acme/inicio/
│  │   ├─ GreetingResource.java
│  │   └─ SaludoResource.java
│  └─ main/resources/
├─ build.gradle
├─ settings.gradle
├─ gradlew
├─ gradlew.bat
└─ README.md

8️⃣ Comandos Gradle útiles

Comando	Descripción
gradlew.bat quarkusDev	Levanta el servidor en modo desarrollo
gradlew.bat build	Empaqueta la app
gradlew.bat test	Ejecuta tests
gradlew.bat quarkusBuild	Genera JAR o nativo para producción