Ejemplo completo y funcional para generar archivos HTML en Java

Este ejemplo muestra cómo convertir un DOCX, PDF, PPTX, o cualquier documento compatible en un único archivo HTML con recursos externos.

import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.HtmlConvertOptions;
import java.io.File;

public class HtmlConversionDemo {
    public static void main(String[] args) {
        // Input document (any supported format: .docx, .pdf, .pptx, etc.)
        String inputPath = "input.docx";

        // Output HTML file
        String outputPath = "output.html";

        // Folder where images and other resources will be stored
        String resourcesFolder = "output_resources";

        // Ensure the resources folder exists
        File resFolder = new File(resourcesFolder);
        if (!resFolder.exists()) {
            resFolder.mkdirs();
        }

        Converter converter = null;
        try {
            // Initialize the converter with the source document
            converter = new Converter(inputPath);

            // Configure HTML conversion options
            HtmlConvertOptions htmlOptions = new HtmlConvertOptions();

            // Store images and CSS in a separate folder
            htmlOptions.setResourcesFolder(resourcesFolder);
            htmlOptions.setResourcesFolderName("resources");

            // Do not embed images directly into HTML (keeps file size lower)
            htmlOptions.setEmbedImages(false);

            // Convert the whole document (0 means all pages)
            htmlOptions.setPageNumber(0);

            // Produce a single HTML file (all pages merged)
            htmlOptions.setRenderToSinglePage(true);

            // Image quality for extracted pictures (0‑100)
            htmlOptions.setQuality(90);

            // Performance tweaks for large documents
            htmlOptions.setMaxPages(0); // 0 = no limit
            htmlOptions.setUsePdfRender(true); // use PDF renderer when possible

            // Perform the conversion
            converter.convert(outputPath, htmlOptions);

            System.out.println("HTML file created successfully at: " + outputPath);
        } catch (Exception ex) {
            System.err.println("Conversion failed: " + ex.getMessage());
            ex.printStackTrace();
        } finally {
            // Release native resources
            if (converter != null) {
                try {
                    converter.close();
                } catch (Exception ignored) {
                }
            }
        }
    }
}

Nota: Este ejemplo de código demuestra la funcionalidad principal. Antes de usarlo en su proyecto, asegúrese de actualizar cualquier ruta de archivo y valores de configuración para que coincidan con su entorno real, verifique que todas las dependencias requeridas estén correctamente instaladas y pruebe exhaustivamente en su entorno de desarrollo. Si encuentra algún problema, consulte la documentación oficial o póngase en contacto con el equipo de soporte para obtener ayuda.

Cómo funciona la creación de archivos HTML en Java

El proceso de conversión está impulsado por tres componentes principales: el Converter, el HtmlConvertOptions y la lógica de manejo de recursos. A continuación se muestra un desglose paso a paso del código presentado arriba.

1. Inicializar el Convertidor - La clase Converter carga el documento de origen.

converter = new Converter(inputPath);

Esta clase está documentada en la referencia de API.

2. Configurar opciones HTML - HtmlConvertOptions le permite controlar dónde se almacenan las imágenes y el CSS, si las imágenes se incrustan y si la salida debe ser una sola página.

HtmlConvertOptions htmlOptions = new HtmlConvertOptions();
htmlOptions.setResourcesFolder(resourcesFolder);
htmlOptions.setResourcesFolderName("resources");
htmlOptions.setEmbedImages(false);
htmlOptions.setRenderToSinglePage(true);

3. Ajustar mejoras de rendimiento - Para documentos grandes puedes ajustar los límites de páginas y elegir el renderizador PDF para mayor velocidad.

   htmlOptions.setMaxPages(0);
   htmlOptions.setUsePdfRender(true);
   

4. Ejecutar la conversión - El método convert escribe el archivo HTML y crea la carpeta de recursos.

converter.convert(outputPath, htmlOptions);

5. Limpieza - Siempre cierre el Converter para liberar los recursos nativos.

if (converter != null) {
    converter.close();
}

Combinar archivos HTML en Java

Configurar htmlOptions.setRenderToSinglePage(true) combina todas las páginas del documento de origen en un solo archivo HTML, lo que es útil cuando necesitas combinar varias secciones en una salida cohesiva.

Generar archivos HTML en Java

Si prefieres páginas separadas, establece htmlOptions.setRenderToSinglePage(false). El SDK generará entonces un archivo HTML por cada página de origen, manejando aún las imágenes y CSS en la carpeta de recursos designada.

Preparando el Entorno

Antes de poder ejecutar el código, agregue el repositorio Maven de Conholdate.Total y la dependencia a pom.xml de su proyecto.

<repositories>
    <repository>
        <id>conholdate-repo</id>
        <name>Conholdate Maven Repository</name>
        <url>https://repository.conholdate.com/repo/</url>
    </repository>
</repositories>

<dependency>
    <groupId>com.conholdate</groupId>
    <artifactId>conholdate-total</artifactId>
    <version>24.9</version>
    <type>pom</type>
</dependency>

También puedes descargar los últimos archivos JAR directamente desde la página de descarga. El SDK requiere Java 8 o superior y se ejecuta en cualquier JVM estándar.

Conclusión

Crear archivos HTML en Java se vuelve sencillo con Conholdate.Total for Java. La biblioteca maneja la detección de formato, la extracción de recursos y la combinación de páginas, por lo que puedes centrarte en la lógica de negocio en lugar de la manipulación de cadenas de bajo nivel. Recuerda obtener una licencia válida para uso en producción; una página de licencia temporal está disponible para evaluación, y la información detallada de precios se puede encontrar en la página de precios. Con los pasos descritos arriba, estás listo para generar informes HTML, correos electrónicos o cualquier contenido web directamente desde tus aplicaciones Java.

Preguntas frecuentes

• ¿Cómo crear archivos HTML en Java usando Conholdate.Total?
  Utilice la clase Converter junto con HtmlConvertOptions como se muestra en el ejemplo de código completo. El SDK se encarga de extraer imágenes, CSS y combinar páginas.

• ¿Puedo combinar archivos HTML en Java con este SDK?
  Sí. Habilite htmlOptions.setRenderToSinglePage(true) para combinar todas las páginas en una única salida HTML.

• ¿Qué formatos de origen son compatibles para la conversión a HTML?
  El SDK admite DOCX, PDF, PPTX, XLSX, y muchos otros formatos. Consulte la documentación oficial para obtener la lista completa.

• ¿Dónde puedo obtener información sobre licencias y precios?
  Visite la página de licencia temporal para una licencia de prueba y la página de precios para opciones comerciales.

Leer más

• Crear gráficos en documentos Word usando Java
• Convertir HTML a XPS en Java
• Convertir HTML a BMP en Java