Convertir JSPX a PDF

Una aplicación web Java puede necesitar entregar un informe generado por JSPX como un archivo fijo para imprimirlo, compartirlo o archivarlo. La página debe ser procesada primero por su servidor Java; cambiar el nombre del archivo de origen a .pdf no lo convierte.

Qué es el formato JSPX

JSPX es la sintaxis basada en XML para un documento JavaServer Pages (JSP). Puede contener marcado XML, elementos JSP, lenguaje de expresiones, elementos de bibliotecas de etiquetas personalizadas y referencias a CSS, JavaScript, imágenes y datos de la aplicación. Las aplicaciones web Java utilizan archivos .jspx para páginas generadas por el servidor, incluidos los proyectos creados con Java EE, Jakarta EE y herramientas como Oracle JDeveloper.

Normalmente, un contenedor de servlets como Apache Tomcat o Jetty, o un servidor Jakarta EE completo, procesa el archivo. El servidor evalúa los elementos JSP, accede a los datos de la aplicación y devuelve HTML al navegador. Abrir directamente un archivo de origen JSPX normalmente muestra XML o descarga el código fuente en lugar de mostrar la página terminada.

Qué es el formato PDF

PDF almacena texto, gráficos, fuentes y diseño de página procesados en un formato de documento portátil que es, en gran medida, independiente del sistema operativo y de la aplicación de creación. Es adecuado para distribuir un informe cuando los destinatarios necesitan un archivo estable para imprimirlo, revisarlo, conservarlo o acceder a él sin conexión.

El PDF resultante contiene la página tal como se procesó en el momento de la conversión; no conserva la lógica JSP del servidor, las conexiones a bases de datos, las sesiones, el procesamiento de solicitudes ni el comportamiento interactivo original de la aplicación. Los formularios HTML, los controles JavaScript y los enlaces que requieren un inicio de sesión activo pueden volverse estáticos o dejar de funcionar.

Cómo convertir una página JSPX a PDF

Imprimir la página procesada desde un navegador

1. Implemente la aplicación que contiene el archivo JSPX en su servidor previsto, como Tomcat, Jetty o un servidor Jakarta EE, e inicie ese servidor.
2. Abra la URL completa de la página, por ejemplo http://localhost:8080/app/report.jspx. Inicie sesión y seleccione los parámetros o filtros del informe antes de imprimir.
3. En Chrome u otro navegador basado en Chromium, seleccione Menu → Print, elija Save to PDF, establezca el tamaño del papel, la orientación, los márgenes y la escala, active Background graphics cuando sea necesario y guarde el archivo.

Firefox ofrece un flujo de trabajo similar mediante Print → Print to File. La impresión desde el navegador suele ser el método de escritorio más práctico porque el navegador ejecuta el JavaScript de la página y aplica su CSS antes de generar el PDF.

Procesarla con Chromium sin interfaz gráfica

Para una página accesible públicamente o sin autenticación, un navegador basado en Chromium puede generar un PDF sin abrir una ventana:

chromium --headless --print-to-pdf=report.pdf http://localhost:8080/app/report.jspx

Utilice una URL de la aplicación que ya se cargue correctamente en un navegador normal. Las páginas que requieren inicio de sesión, cookies de sesión, datos POST o interacción del usuario necesitan automatización del navegador, como Playwright o Selenium, para autenticarse, navegar, esperar a que se cargue la página e invocar la función de PDF del navegador. No exponga credenciales ni datos privados de la aplicación en una línea de comandos o URL.

Utilizar un servicio en línea de URL a PDF

Un servicio confiable de procesamiento de URL, como PDFCrowd o PDFShift, puede procesar una página JSPX únicamente cuando la página es accesible desde los servidores del servicio, normalmente mediante una URL pública. Por lo general, estos servicios no pueden acceder a una implementación local de localhost ni a un servidor interno, a menos que se exponga deliberadamente. Además, es posible que no admitan flujos de autenticación, estado de sesión, informes disponibles únicamente mediante POST ni páginas que requieran interacción del usuario.

Para informes confidenciales, páginas protegidas o URL privadas de aplicaciones, utilice la impresión local del navegador o Chromium local sin interfaz gráfica. No cargue el código fuente JSPX, las credenciales, las cookies de sesión ni las URL confidenciales de informes en un convertidor de terceros.

Limitaciones de calidad y compatibilidad

El PDF refleja lo que el servidor y el navegador de procesamiento producen en el momento de la conversión. La ausencia de fuentes web, las imágenes bloqueadas, las rutas relativas incorrectas, el CSS no compatible, las solicitudes de red fallidas y el contenido asíncrono incompleto pueden cambiar el resultado. Espere a que se carguen los gráficos, las imágenes y los datos cargados mediante AJAX antes de imprimir; los flujos de trabajo automatizados deben esperar a un selector específico o a un estado adecuado de inactividad de la red.

Añada CSS específico para impresión, como @media print, break-before, break-after y break-inside, para controlar la paginación. Active los gráficos de fondo cuando los paneles o fondos de color formen parte del diseño. Los PDF generados por el navegador pueden sustituir fuentes propietarias, dividir tablas o contenido entre páginas y omitir comportamientos que dependan de una sesión activa en el servidor.