La conversione di fogli di calcolo Excel in JSON è una necessità frequente quando si costruiscono pipeline di scambio dati o si alimentano API. Conholdate.Total for Java è un SDK potente che semplifica questo compito per gli sviluppatori Java. In questa guida imparerai come configurare la libreria, eseguire un’implementazione completa e perfezionare le opzioni di conversione per soddisfare le esigenze del tuo progetto.

Prerequisiti e Configurazione per Conholdate.Total for Java

Prima di iniziare, assicurati di avere:

  • Java 17 o versioni successive installate.
  • Maven 3.6+ per la gestione delle dipendenze.
  • Un file Excel (.xlsx) che desideri convertire.

Aggiungi il repository Maven di Conholdate.Total e la dipendenza al tuo 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>

Puoi anche scaricare gli ultimi JAR direttamente dalla pagina di download. Con l’SDK installato, sei pronto per avviare la conversione da Excel a JSON in Java.

Conversione da Excel a JSON in Java: Guida passo passo

Passo 1: Carica il documento Excel di origine

Innanzitutto, specifica il percorso del file XLSX di origine e crea un’istanza Conversion. Il blocco try‑with‑resources garantisce che l’oggetto di conversione venga eliminato correttamente.

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

Passo 2: Configura le opzioni di conversione JSON

Crea un oggetto JsonConvertOptions e regola le impostazioni come la stampa formattata (pretty‑print), l’inclusione dell’intestazione, i formati personalizzati per data e numero e la dimensione del batch. Queste opzioni controllano come la conversione da Excel a JSON in Java influisce sull’output finale.

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);

Passo 3: Esegui la conversione

Fornisci il nome del file JSON di destinazione e invoca il metodo convert. L’SDK gestisce la trasformazione internamente.

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

Passaggio 4: Gestire il risultato e la pulizia

Dopo la conversione, visualizza un messaggio di conferma. Eventuali eccezioni vengono catturate e stampate nella console.

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 questi passaggi, la conversione da Excel a JSON in Java è completa e puoi integrare il JSON generato nella tua API o nel flusso di lavoro di elaborazione dei dati.

Implementazione completa: conversione da Excel a JSON in Java

Il seguente esempio dimostra come eseguire la conversione da Excel a JSON in Java utilizzando 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: Questo esempio di codice dimostra la funzionalità principale. Prima di usarlo nel tuo progetto, assicurati di aggiornare tutti i percorsi dei file e i valori di configurazione per corrispondere al tuo ambiente reale, verifica che tutte le dipendenze richieste siano correttamente installate e testa accuratamente nel tuo ambiente di sviluppo. Se riscontri problemi, consulta la documentazione ufficiale o contatta il team di supporto per assistenza.

Opzioni di conversione e impostazioni

L’SDK offre diverse opzioni per personalizzare l’output JSON:

  • Pretty Print - Migliora la leggibilità aggiungendo l’indentazione.
    jsonOptions.setPrettyPrint(true);
  • Include Headers - Usa la prima riga del foglio di lavoro come nomi delle proprietà.
    setIncludeHeaders(true) (vedi il riferimento API).
  • Custom Date Format - Definisci un modello di data, ad es., "yyyy-MM-dd".
    setCustomDateFormat("yyyy-MM-dd").
  • Custom Number Format - Controlla la precisione numerica, ad es., "#.##".
    setCustomNumberFormat("#.##").

Regolare queste impostazioni consente di allineare il JSON generato alle aspettative dei servizi o database a valle.

Conclusione

Adesso hai una conversione da Excel a JSON funzionante in Java, alimentata da Conholdate.Total for Java. L’SDK si occupa del lavoro pesante, mentre le opzioni configurabili ti danno il controllo su formattazione e prestazioni. Ricorda di ottenere una licenza adeguata per l’uso in produzione; puoi richiedere una pagina di licenza temporanea per valutare la libreria o consultare la pagina completa dei prezzi per i termini commerciali. Buon coding!

FAQs

  • Come eseguire la conversione da Excel a JSON in Java con Conholdate.Total?
    Utilizzare la classe Conversion insieme a JsonConvertOptions come mostrato nell’esempio di codice. L’SDK astrae la gestione dei file e fornisce una singola chiamata convert.

  • Posso personalizzare i formati di data e numero durante la conversione da Excel a JSON in Java?
    Sì. I metodi setCustomDateFormat e setCustomNumberFormat consentono di definire i pattern che corrispondono alle aspettative del sistema di destinazione.

  • Quali opzioni di licenza sono disponibili per Conholdate.Total per Java?
    È possibile ottenere una licenza di valutazione temporanea dalla pagina della licenza temporanea o acquistare una licenza completa tramite la pagina dei prezzi.

  • È supportata l’elaborazione batch per file Excel di grandi dimensioni?
    L’opzione setRowsPerBatch consente di elaborare i fogli di lavoro a blocchi, il che è ideale per scenari di conversione batch.

Leggi di più