Spring Boot

Spring Boot está construido sobre el popular framework Spring, e incluye una amplia gama de mejoras que te permiten construir fácilmente microservicios de nivel de producción, aplicaciones web y proyectos Spring independientes con esfuerzos de desarrollo reducidos. Spring Boot típicamente incluye servidores HTTP embebidos como Jetty o Apache Tomcat, sin las complejas configuraciones XML de Spring.

Spring Boot- JAR

Este ejemplo ilustra los pasos para construir una aplicación Spring Boot de muestra, exportarla como un archivo JAR y desplegarla en AppSail.

1. Abre Spring Initializr para crear un nuevo proyecto.

2. Elige las siguientes configuraciones para tu proyecto:
   
   a. Project - Maven Project
   b. Language - Java
   c. Spring Boot Version - 2.7.10
   d. Package - JAR
   e. Java Version - 8
   f. Haz clic en Add Dependencies y selecciona Spring Web.

3. Haz clic en Generate.

4. Descomprime el proyecto y ábrelo en cualquier IDE de tu elección.

5. Agrega los controladores necesarios al proyecto. Por ejemplo, crea un archivo llamado DemoController.java en el directorio del archivo Java principal de tu proyecto, y agrega el controlador especificado a continuación en el archivo.

package com.example.demo;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class DemoController {
    @GetMapping("/")
    public String index() {
        return "Greetings from Spring Boot!";
    }
}

6. Catalyst verificará el puerto configurado para escucha con la variable de entorno X_ZOHO_CATALYST_LISTEN_PORT y la aplicación debe escuchar en ese puerto en todas las interfaces (host 0.0.0.0). Por lo tanto, necesitarás personalizar el puerto. Puedes hacer esto creando un archivo llamado ServerPortCustomizer.java en el directorio del archivo Java principal de tu proyecto, y agregando el código especificado a continuación:

package com.example.demo;
import org.springframework.boot.web.server.ConfigurableWebServerFactory;
import org.springframework.boot.web.server.WebServerFactoryCustomizer;
import org.springframework.stereotype.Component;
@Component
public class ServerPortCustomizer implements WebServerFactoryCustomizer {
    @Override
    public void customize(ConfigurableWebServerFactory factory) {
        String port = System.getenv("X_ZOHO_CATALYST_LISTEN_PORT");
        int listenPort;
        if(port != null && !port.isEmpty()) {
            listenPort = Integer.parseInt(System.getenv("X_ZOHO_CATALYST_LISTEN_PORT"));
        } else {
            listenPort = 9000;
        }
        factory.setPort(listenPort);
    }
}

Ahora puedes guardar la aplicación y ejecutarla en Catalyst.

7. Puedes ejecutar esta aplicación en tu máquina local ejecutando el siguiente comando desde tu terminal:

./mvnw spring-boot:run

8. Luego puedes compilar el código fuente, ejecutar pruebas y empaquetar el código compilado ejecutando el siguiente comando:

./mvnw clean package

Esto generará el archivo JAR de la aplicación en la carpeta target.

9. Ahora puedes inicializar un servicio de AppSail en el mismo directorio desde el CLI o agregarlo en un directorio de proyecto existente. La fuente de la aplicación debe ser el directorio de tu aplicación. Proporciona los siguientes valores al inicializar el servicio de aplicación:

   Stack: Java 8
   Platform: Java SE

10. Asegúrate de que el archivo JAR se agregue en el directorio de compilación que especificaste durante la inicialización. Catalyst comprimirá automáticamente tu archivo de aplicación durante el despliegue a la consola remota.

11. Despliega el servicio de aplicación en la consola.

12. Luego puedes configurar el comando de inicio que se proporciona a continuación desde la consola:

java -jar demo-0.0.1-SNAPSHOT.jar

También puedes configurar esto en el archivo app-config.json antes de desplegar.

Accede al servicio de aplicación desplegado desde su URL de endpoint.

Spring Boot - WAR

Este ejemplo explica los pasos para construir una aplicación Spring Boot de muestra, exportarla como un archivo WAR y desplegarla en AppSail:

1. Abre Spring Initializr para crear un nuevo proyecto.

2. Elige las siguientes configuraciones para tu proyecto:
   
   a. Project - Maven Project
   b. Language - Java
   c. Spring Boot Version - 2.7.10
   d. Package - WAR
   e. Java Version - 8
   f. Haz clic en Add Dependencies y selecciona Spring Web.

3. Haz clic en Generate.

4. Descomprime el proyecto y ábrelo en cualquier IDE de tu elección.

5. Ahora debes agregar los controladores necesarios al proyecto. Por ejemplo, crea un archivo llamado DemoController.java en el directorio del archivo Java principal de tu proyecto, y agrega el controlador especificado a continuación en el archivo.

package com.example.demo;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class DemoController {
    @GetMapping("/")
    public String index() {
        return "Greetings from Spring Boot WAR!";
    }
}

6. Ahora debes modificar el archivo pom.xml en tu proyecto para excluir el servidor Tomcat embebido al generar el archivo WAR, como se explicó en la descripción general. Puedes hacer esto agregando el fragmento que se proporciona a continuación en el encapsulado spring-boot-maven-plugin en el archivo XML:

<configuration>
<mainClass>${main_class_name}</mainClass>
<classifier>exec</classifier>
</configuration>

7. Puedes ejecutar esta aplicación en tu máquina local ejecutando el siguiente comando desde tu terminal:

./mvnw spring-boot:run

8. Puedes subir la aplicación a Catalyst con este comando:

./mvnw clean package

Esto generará el archivo WAR de la aplicación en la carpeta target.

9. Ahora puedes inicializar un servicio de AppSail en el mismo directorio desde el CLI o agregarlo en un directorio de proyecto existente. La fuente de la aplicación debe ser el directorio de tu aplicación. Proporciona los siguientes valores al inicializar el servicio de aplicación:

   Stack: Java 8
   Platform: Java WAR

10. Asegúrate de que el archivo WAR se agregue en el directorio de compilación que especifiques durante la inicialización. Catalyst comprimirá automáticamente tu archivo de aplicación durante el despliegue a la consola remota.

11. Despliega el servicio de aplicación en la consola.

Accede al servicio de aplicación desplegado desde su URL de endpoint.