Tutorial: Instalación Java Helidon

Tutorial: Instalación y uso seguro del Helidon CLI

Helidon es un framework Java liviano y moderno, desarrollado por Oracle, para construir microservicios eficientes y fáciles de mantener. Está disponible en dos estilos:

• SE: versión ligera y funcional, con servidor web embebido y API minimalista.
• MP: implementación de Eclipse MicroProfile, con soporte para JAX-RS, CDI, JSON-B, JWT, métricas y más.

Más información y documentación oficial en https://helidon.io/.

En este tutorial aprenderás a instalar el Helidon CLI, generar un proyecto con Helidon MP y ejecutar un servicio de ejemplo Hola Mundo. El objetivo es que tengas un flujo de trabajo seguro y autónomo: compilar y ejecutar desde consola con Maven, mientras usas tu IDE (por ejemplo IntelliJ IDEA) solo para editar y navegar el código, sin depender de plugins adicionales.

Al final del tutorial sabrás cómo:

• Instalar y mantener el CLI de forma local y segura.
• Generar proyectos Helidon MP listos para producción.
• Configurar y probar un endpoint REST básico.
• Trabajar con Maven o Gradle sin depender del IDE ni del soporte del CLI.

1. Prerrequisitos

Asegúrate de tener instaladas las siguientes herramientas:

Java 21+

java -version

Debe mostrar OpenJDK 21 o superior.

Maven 3.8+

mvn --version

Si falta alguna, instálala y agrégala a tu PATH.

2. Instalación del Helidon CLI

macOS

curl -L -O https://helidon.io/cli/latest/darwin/helidon
chmod +x ./helidon
sudo mv ./helidon /usr/local/bin/

Si aparece un warning de verificación:

xattr -d com.apple.quarantine helidon

Linux

curl -L -O https://helidon.io/cli/latest/linux/helidon
chmod +x ./helidon
sudo mv ./helidon /usr/local/bin/

Si prefieres no instalarlo globalmente, podés guardarlo en /opt/helidon:

sudo mkdir -p /opt/helidon
sudo mv ./helidon /opt/helidon/
export PATH=/opt/helidon:$PATH

(Agrega esa última línea a tu ~/.bashrc o ~/.zshrc).

Windows (PowerShell como administrador)

Invoke-WebRequest -Uri "https://helidon.io/cli/latest/windows/helidon.exe" -OutFile "C:\tools\helidon\helidon.exe"
setx PATH "$($Env:PATH);C:\tools\helidon"

⚠️ Necesitas instalar Visual C++ Redistributable Runtime para que el binario funcione.

3. Verificar instalación

helidon version

Deberías ver la versión instalada.

4. Crear un nuevo proyecto Helidon MP

Genera la estructura base con:

helidon init

Responde las preguntas del CLI para generar tu proyecto Helidon MP:

• Tipo de proyecto: selecciona MP (MicroProfile) para usar Helidon MicroProfile.
• Tipo de aplicación: elige uno de los siguientes:
  • quickstart: proyecto básico “Hola Mundo”, ideal para comenzar.
  • database: incluye configuración inicial para conectarse a una base de datos.
  • custom: configuración manual de dependencias y módulos.
  • oci: preparado para desplegar en Oracle Cloud Infrastructure.
• Lenguaje: selecciona Java.
• Nombre del proyecto: por ejemplo myproject.
• Paquete base: por ejemplo com.example.hello.

Una vez completadas estas opciones, el CLI generará automáticamente la estructura del proyecto, incluyendo:

• Archivos de código base con un endpoint REST de ejemplo.
• Configuración de Maven en pom.xml.
• Estructura de carpetas lista para compilar y ejecutar.

5. Agregar un endpoint Hola Mundo

Crea el archivo:

src/main/java/com/example/hello/helidon/HelloController.java

package com.example.hello.helidon;

import javax.inject.Singleton;
import javax.ws.rs.GET;
import javax.ws.rs.Path;

@Path("/hello")
@Singleton
public class HelloController {

    @GET
    public String sayHello() {
        return "Hello World";
    }
}

(Opcional) Definir ruta raíz /api

El prefijo de la aplicación REST define la ruta base de todos los endpoints. Algunos arquetipos incluyen una clase con @ApplicationPath("/data") como ejemplo. Si querés usar /api como ruta raíz, podés crear la clase así:

src/main/java/com/example/hello/helidon/HellohelidonRestApplication.java

package com.example.hello.helidon;

import javax.ws.rs.ApplicationPath;
import javax.ws.rs.core.Application;

@ApplicationPath("/api")
public class HellohelidonRestApplication extends Application {
    // vacío: solo define el contexto raíz
}

6. Compilar y ejecutar desde consola

Con Maven

mvn clean package
java -jar target/myproject.jar

El servidor se inicia en http://localhost:8080.

7. Probar el endpoint

Si usaste @ApplicationPath("/api"):

curl http://localhost:8080/api/hello

Si no definiste ApplicationPath:

curl http://localhost:8080/hello

Salida:

Hello World

8. Developer Loop (opcional)

Si quieres autorecarga de código:

cd myproject
helidon dev

Cada cambio recompila y reinicia la app automáticamente.

Es útil en desarrollo, pero no obligatorio.