Saltar al contenido

Desplegando Servlets Adicionales 25.02

Abrir en ChatGPT

webforJ enruta todas las solicitudes a través de WebforjServlet, que está mapeado a /* en web.xml por defecto. Este servlet gestiona el ciclo de vida del componente, la enrutación y las actualizaciones de la interfaz de usuario que impulsan tu aplicación webforJ.

En algunos escenarios, es posible que necesites desplegar servlets adicionales junto a tu aplicación webforJ:

  • Integrar bibliotecas de terceros que proporcionan sus propios servlets
  • Implementar APIs REST o webhooks
  • Manejar cargas de archivos con procesamiento personalizado
  • Soportar código basado en servlets heredado

webforJ proporciona dos enfoques para desplegar servlets personalizados junto a tu aplicación:

Enfoque 1: Remapeo de WebforjServlet​

Este enfoque remapea el WebforjServlet de /* a una ruta específica como /ui/*, liberando el espacio de nombres de URL para servlets personalizados. Aunque esto requiere modificar web.xml, le da a los servlets personalizados acceso directo a sus patrones de URL sin ningún costo adicional por proxy.

<web-app>
  <!-- WebforjServlet remapeado para manejar solo /ui/* -->
  <servlet>
    <servlet-name>WebforjServlet</servlet-name>
    <servlet-class>com.webforj.servlet.WebforjServlet</servlet-class>
    <load-on-startup>1</load-on-startup>
  </servlet>
  <servlet-mapping>
    <servlet-name>WebforjServlet</servlet-name>
    <url-pattern>/ui/*</url-pattern>
  </servlet-mapping>
  
  <!-- Servlet personalizado con su propio patrón de URL -->
  <servlet>
    <servlet-name>HelloWorldServlet</servlet-name>
    <servlet-class>com.example.HelloWorldServlet</servlet-class>
  </servlet>
  <servlet-mapping>
    <servlet-name>HelloWorldServlet</servlet-name>
    <url-pattern>/hello-world</url-pattern>
  </servlet-mapping>
</web-app>

Con esta configuración:

  • Los componentes de webforJ son accesibles bajo /ui/
  • El servlet personalizado maneja solicitudes a /hello-world
  • No hay mecanismo de proxy involucrado - enrutamiento directo del contenedor de servlets
Configuración de Spring Boot

Al usar webforJ con Spring Boot, no hay un archivo web.xml. En su lugar, configura el mapeo del servlet en application.properties:

webforj.servlet-mapping=/ui/*

Esta propiedad remapea WebforjServlet del /* por defecto a /ui/*, liberando el espacio de nombres de URL para tus servlets personalizados. No incluyas comillas alrededor del valor; serán interpretadas como parte del patrón de URL.

Enfoque 2: Configuración de proxy de WebforjServlet​

Este enfoque mantiene WebforjServlet en /* y configura servlets personalizados en webforJ.conf. El WebforjServlet intercepta todas las solicitudes y las envía a los servlets personalizados que coincidan con los patrones.

Configuración estándar de web.xml​

<servlet>
  <servlet-name>WebforjServlet</servlet-name>
  <servlet-class>com.webforj.servlet.WebforjServlet</servlet-class>
  <load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
  <servlet-name>WebforjServlet</servlet-name>
  <url-pattern>/*</url-pattern>
</servlet-mapping>

<!-- Servlet personalizado con su propio patrón de URL -->
<servlet>
  <servlet-name>HelloWorldServlet</servlet-name>
  <servlet-class>com.example.HelloWorldServlet</servlet-class>
</servlet>
<servlet-mapping>
  <servlet-name>HelloWorldServlet</servlet-name>
  <url-pattern>/hello-world</url-pattern>
</servlet-mapping>
</web-app>

Configuración de webforJ.conf​

servlets = [
  {
    name = "hello-world"
    class = "com.example.HelloWorldServlet"
  }
]

Con esta configuración:

  • WebforjServlet maneja todas las solicitudes
  • Las solicitudes a /hello-world son enviadas al HelloWorldServlet