Het converteren van Excel‑spreadsheets naar JSON is een veelvoorkomende eis bij het bouwen van data‑uitwisselingspijplijnen of het voeden van API’s. Conholdate.Total for Java is een krachtige SDK die deze taak voor Java‑ontwikkelaars vereenvoudigt. In deze gids leer je hoe je de bibliotheek instelt, een volledige implementatie doorloopt en de conversie‑opties fijn afstemt om aan de behoeften van je project te voldoen.

Vereisten en installatie voor Conholdate.Total for Java

Voordat u begint, zorg ervoor dat u het volgende heeft:

  • Java 17 of nieuwer geïnstalleerd.
  • Maven 3.6+ voor afhankelijkheidsbeheer.
  • Een Excel‑bestand (.xlsx) dat u wilt converteren.

Voeg de Conholdate.Total Maven-repository en afhankelijkheid toe aan uw 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>

U kunt de nieuwste JAR‑bestanden ook rechtstreeks downloaden van de downloadpagina. Met de SDK geïnstalleerd, bent u klaar om de excel‑naar‑JSON-conversie in Java te starten.

Excel naar JSON-conversie in Java: Stapsgewijze walkthrough

Stap 1: Laad het bron-Excel-document

Geef eerst het pad op naar het bron‑XLSX‑bestand en maak een Conversion‑instantie aan. Het try‑with‑resources‑blok zorgt ervoor dat het conversie‑object correct wordt vrijgegeven.

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

Stap 2: Configureer JSON-conversieopties

Maak een JsonConvertOptions-object aan en pas instellingen aan, zoals pretty‑print, het opnemen van kopteksten, aangepaste datum‑ en getalformaten, en batchgrootte. Deze opties bepalen hoe de excel‑naar‑JSON-conversie in Java de uiteindelijke output vormgeeft.

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

Stap 3: Voer de conversie uit

Geef de doel‑JSON‑bestandsnaam op en roep de convert‑methode aan. De SDK verwerkt de transformatie intern.

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

Stap 4: Resultaat verwerken en opruimen

Na de conversie wordt een bevestigingsbericht weergegeven. Eventuele uitzonderingen worden opgevangen en naar de console geprint.

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

Met deze stappen is de excel‑naar‑JSON-conversie in Java voltooid, en kun je de gegenereerde JSON integreren in je API of gegevensverwerkings‑workflow.

Volledige implementatie: Java Excel naar JSON-conversie

Het volgende voorbeeld laat zien hoe u een Excel‑naar‑JSON‑conversie in Java kunt uitvoeren met 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();
        }
    }
}

Opmerking: Dit codevoorbeeld toont de kernfunctionaliteit. Voordat u het in uw project gebruikt, moet u ervoor zorgen dat u alle bestandspaden en configuratiewaarden bijwerkt zodat ze overeenkomen met uw daadwerkelijke omgeving, verifiëren dat alle vereiste afhankelijkheden correct zijn geïnstalleerd, en grondig testen in uw ontwikkelomgeving. Als u problemen ondervindt, raadpleeg dan de officiële documentatie of neem contact op met het ondersteuningsteam voor hulp.

Conversie‑opties en instellingen

De SDK biedt verschillende opties om de JSON‑output aan te passen:

  • Pretty Print - Verbetert de leesbaarheid door inspringing toe te voegen.
    jsonOptions.setPrettyPrint(true);
  • Include Headers - Gebruikt de eerste rij van het werkblad als eigenschapsnamen.
    setIncludeHeaders(true) (zie de API-referentie).
  • Custom Date Format - Definieer een datumpatroon, bijv. "yyyy-MM-dd".
    setCustomDateFormat("yyyy-MM-dd").
  • Custom Number Format - Beheer de numerieke precisie, bijv. "#.##".
    setCustomNumberFormat("#.##").

Het aanpassen van deze instellingen stelt u in staat om de gegenereerde JSON af te stemmen op de verwachtingen van downstream‑services of databases.

Conclusie

U heeft nu een werkende Excel‑naar‑JSON‑conversie in Java‑implementatie, aangedreven door Conholdate.Total for Java. De SDK doet het zware werk, terwijl de configureerbare opties u controle geven over opmaak en prestaties. Vergeet niet een juiste licentie te verkrijgen voor productiegebruik; u kunt een tijdelijke licentiepagina aanvragen om de bibliotheek te evalueren of de volledige prijspagina bekijken voor commerciële voorwaarden. Veel programmeerplezier!

FAQs

  • Hoe voer ik een Excel-naar-JSON-conversie uit in Java met Conholdate.Total?
    Gebruik de Conversion-klasse samen met JsonConvertOptions zoals weergegeven in het code‑voorbeeld. De SDK abstraheert bestandsafhandeling en biedt een enkele convert‑aanroep.

  • Kan ik datum- en getalformaten aanpassen tijdens excel naar JSON conversie in Java?
    Ja. De setCustomDateFormat en setCustomNumberFormat methoden laten u patronen definiëren die overeenkomen met de verwachtingen van uw doelsysteem.

  • Welke licentieopties zijn beschikbaar voor Conholdate.Total for Java?
    U kunt een tijdelijke evaluatielicentie verkrijgen via de tijdelijke licentiepagina of een volledige licentie aanschaffen via de prijspagina.

  • Wordt batchverwerking ondersteund voor grote Excel‑bestanden?
    De setRowsPerBatch‑optie stelt u in staat om werkbladen in delen te verwerken, wat ideaal is voor batchconversiescenario’s.

Lees meer