Convertir hojas de cálculo de Excel a JSON es un requisito frecuente al crear pipelines de intercambio de datos o alimentar APIs. Conholdate.Total for Java es un SDK potente que simplifica esta tarea para desarrolladores Java. En esta guía aprenderá a configurar la biblioteca, recorrer una implementación completa y afinar las opciones de conversión para que coincidan con las necesidades de su proyecto.

Requisitos previos y configuración para Conholdate.Total for Java

Antes de comenzar, asegúrate de tener:

  • Java 17 o posterior instalado.
  • Maven 3.6+ para la gestión de dependencias.
  • Un archivo Excel (.xlsx) que deseas convertir.

Agrega el repositorio Maven de Conholdate.Total y la dependencia a tu pom.xml:

<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 JARs directamente desde la página de descarga. Con el SDK listo, estás listo para iniciar la conversión de Excel a JSON en Java.

Conversión de Excel a JSON en Java: Guía paso a paso

Paso 1: Cargar el documento Excel de origen

Primero, especifique la ruta al archivo XLSX de origen y cree una instancia de Conversion. El bloque try‑with‑resources garantiza que el objeto de conversión se elimine correctamente.

String inputFile = "sample.xlsx";
try (Conversion conversion = new Conversion(inputFile)) {
    // conversion object ready
}

Paso 2: Configurar opciones de conversión JSON

Cree un objeto JsonConvertOptions y ajuste configuraciones como pretty‑print, inclusión de encabezados, formatos personalizados de fecha y número, y tamaño de lote. Estas opciones controlan cómo la conversión de Excel a JSON en Java da forma a la salida final.

JsonConvertOptions jsonOptions = new JsonConvertOptions();
jsonOptions.setPrettyPrint(true);
jsonOptions.setIncludeHeaders(true);
jsonOptions.setDateFormat(JsonConvertOptions.DateFormat.CUSTOM);
jsonOptions.setCustomDateFormat("yyyy-MM-dd");
jsonOptions.setNumberFormat(JsonConvertOptions.NumberFormat.CUSTOM);
jsonOptions.setCustomNumberFormat("#.##");
jsonOptions.setRowsPerBatch(5000);

Paso 3: Ejecutar la conversión

Proporcione el nombre del archivo JSON de destino e invoque el método convert. El SDK maneja la transformación internamente.

String outputFile = "sample.json";
conversion.convert(outputFile, jsonOptions);

Paso 4: Manejar el resultado y limpiar

Después de la conversión, muestra un mensaje de confirmación. Cualquier excepción se captura y se imprime en la consola.

System.out.println("Conversion completed successfully. JSON saved to: " + outputFile);
} catch (Exception e) {
    System.err.println("Error during Excel to JSON conversion:");
    e.printStackTrace();
}

Con estos pasos, la conversión de Excel a JSON en Java está completa, y puedes integrar el JSON generado en tu API o flujo de trabajo de procesamiento de datos.

Implementación completa: Conversión de Excel a JSON en Java

El siguiente ejemplo muestra cómo realizar la conversión de Excel a JSON en Java usando Conholdate.Total for Java.

import com.groupdocs.conversion.Conversion;
import com.groupdocs.conversion.options.convert.JsonConvertOptions;
import com.groupdocs.conversion.options.convert.JsonConvertOptions.DateFormat;
import com.groupdocs.conversion.options.convert.JsonConvertOptions.NumberFormat;

public class ExcelToJsonDemo {
    public static void main(String[] args) {
        // Input Excel file (generic path)
        String inputFile = "sample.xlsx";
        // Desired JSON output file
        String outputFile = "sample.json";

// Perform conversion inside try‑with‑resources to ensure proper cleanup
        try (Conversion conversion = new Conversion(inputFile)) {

// Configure JSON conversion options
            JsonConvertOptions jsonOptions = new JsonConvertOptions();

// Pretty‑print the JSON for readability
            jsonOptions.setPrettyPrint(true);

// Include column headers as JSON property names
            jsonOptions.setIncludeHeaders(true);

// Define how dates and numbers should be formatted in the JSON output
            jsonOptions.setDateFormat(DateFormat.CUSTOM);
            jsonOptions.setCustomDateFormat("yyyy-MM-dd");
            jsonOptions.setNumberFormat(NumberFormat.CUSTOM);
            jsonOptions.setCustomNumberFormat("#.##");

// Optional performance tweak: limit rows processed per batch (useful for very large sheets)
            jsonOptions.setRowsPerBatch(5000);

// Execute the conversion
            conversion.convert(outputFile, jsonOptions);

System.out.println("Conversion completed successfully. JSON saved to: " + outputFile);
        } catch (Exception e) {
            // Basic error handling – in production code you might want more sophisticated logging
            System.err.println("Error during Excel to JSON conversion:");
            e.printStackTrace();
        }
    }
}

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 realice pruebas exhaustivas 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.

Opciones de conversión y configuración

El SDK ofrece varias opciones para personalizar la salida JSON:

  • Pretty Print - Mejora la legibilidad añadiendo sangría.
jsonOptions.setPrettyPrint(true);
  • Include Headers - Usa la primera fila de la hoja de cálculo como nombres de propiedades.
    setIncludeHeaders(true) (see the API reference).
  • Custom Date Format - Define un patrón de fecha, p.ej., "yyyy-MM-dd".
    setCustomDateFormat("yyyy-MM-dd").
  • Custom Number Format - Controla la precisión numérica, p.ej., "#.##".
    setCustomNumberFormat("#.##").

Ajustar estas configuraciones le permite alinear el JSON generado con las expectativas de los servicios o bases de datos posteriores.

Conclusión

Ahora tienes una conversión de Excel a JSON funcional en Java impulsada por Conholdate.Total for Java. El SDK se encarga del trabajo pesado, mientras que las opciones configurables te dan control sobre el formato y el rendimiento. Recuerda obtener una licencia adecuada para uso en producción; puedes solicitar una página de licencia temporal para evaluar la biblioteca o revisar la página completa de precios para los términos comerciales. ¡Feliz codificación!

Preguntas frecuentes

  • ¿Cómo realizo la conversión de Excel a JSON en Java con Conholdate.Total?
    Utilice la clase Conversion junto con JsonConvertOptions como se muestra en el ejemplo de código. El SDK abstrae el manejo de archivos y proporciona una única llamada convert.

  • ¿Puedo personalizar los formatos de fecha y número durante la conversión de Excel a JSON en Java?
    Sí. Los métodos setCustomDateFormat y setCustomNumberFormat le permiten definir patrones que coincidan con las expectativas de su sistema de destino.

  • ¿Qué opciones de licencia están disponibles para Conholdate.Total for Java?
    Puede obtener una licencia de evaluación temporal desde la página de licencia temporal o comprar una licencia completa a través de la página de precios.

  • ¿Se admite el procesamiento por lotes para archivos Excel grandes?
    La opción setRowsPerBatch permite procesar hojas de cálculo en fragmentos, lo que es ideal para escenarios de conversión por lotes.

Leer más