Das Konvertieren von Excel‑Tabellen in JSON ist eine häufige Anforderung beim Aufbau von Datenaustausch‑Pipelines oder beim Befüllen von APIs. Conholdate.Total for Java ist ein leistungsstarkes SDK, das diese Aufgabe für Java‑Entwickler vereinfacht. In diesem Leitfaden erfahren Sie, wie Sie die Bibliothek einrichten, eine vollständige Implementierung durchgehen und die Konvertierungsoptionen feinabstimmen, um den Anforderungen Ihres Projekts zu entsprechen.

Voraussetzungen und Einrichtung für Conholdate.Total for Java

Bevor Sie beginnen, stellen Sie sicher, dass Sie Folgendes haben:

  • Java 17 oder neuer installiert.
  • Maven 3.6+ für die Abhängigkeitsverwaltung.
  • Eine Excel‑Datei (.xlsx), die Sie konvertieren möchten.

Fügen Sie das Conholdate.Total Maven-Repository und die Abhängigkeit zu Ihrer pom.xml hinzu:

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

Sie können die neuesten JARs auch direkt von der Download‑Seite herunterladen. Mit dem SDK sind Sie bereit, die Excel‑zu‑JSON‑Konvertierung in Java zu starten.

Excel zu JSON-Konvertierung in Java: Schritt‑für‑Schritt‑Anleitung

Schritt 1: Laden Sie das Quell‑Excel‑Dokument

Zuerst geben Sie den Pfad zur Quell‑XLSX‑Datei an und erstellen eine Conversion‑Instanz. Der try‑with‑resources‑Block stellt sicher, dass das Konversionsobjekt ordnungsgemäß freigegeben wird.

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

Schritt 2: JSON‑Konvertierungsoptionen konfigurieren

Erstellen Sie ein JsonConvertOptions‑Objekt und passen Sie Einstellungen wie Pretty‑Print, Header‑Einbindung, benutzerdefinierte Datums‑ und Zahlenformate sowie die Batch‑Größe an. Diese Optionen steuern, wie die Excel‑zu‑JSON‑Konvertierung in Java die endgültige Ausgabe gestaltet.

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

Schritt 3: Konvertierung ausführen

Geben Sie den Ziel‑JSON‑Dateinamen an und rufen Sie die convert‑Methode auf. Das SDK führt die Transformation intern durch.

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

Schritt 4: Ergebnis verarbeiten und Aufräumen

Nach der Konvertierung wird eine Bestätigungsnachricht ausgegeben. Alle Ausnahmen werden abgefangen und in der Konsole ausgegeben.

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

Mit diesen Schritten ist die Excel‑zu‑JSON‑Konvertierung in Java abgeschlossen, und Sie können das erzeugte JSON in Ihre API oder Ihren Datenverarbeitungs‑Workflow integrieren.

Vollständige Implementierung: Java Excel zu JSON-Konvertierung

Das folgende Beispiel zeigt, wie man in Java eine Excel‑zu‑JSON‑Konvertierung mit Conholdate.Total for Java durchführt.

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

Hinweis: Dieses Codebeispiel demonstriert die Kernfunktionalität. Bevor Sie es in Ihrem Projekt verwenden, stellen Sie sicher, dass Sie alle Dateipfade und Konfigurationswerte an Ihre tatsächliche Umgebung anpassen, überprüfen Sie, dass alle erforderlichen Abhängigkeiten ordnungsgemäß installiert sind, und testen Sie gründlich in Ihrer Entwicklungsumgebung. Wenn Sie auf Probleme stoßen, lesen Sie bitte die offizielle Dokumentation oder wenden Sie sich an das Support-Team für Unterstützung.

Konvertierungsoptionen und Einstellungen

Das SDK bietet mehrere Optionen, um die JSON‑Ausgabe anzupassen:

  • Pretty Print – Verbessert die Lesbarkeit, indem Einrückungen hinzugefügt werden.
    jsonOptions.setPrettyPrint(true);
  • Include Headers – Verwendet die erste Zeile des Arbeitsblatts als Eigenschaftsnamen.
    setIncludeHeaders(true) (siehe die API‑Referenz).
  • Custom Date Format – Definieren Sie ein Datumsformat, z. B. "yyyy-MM-dd".
    setCustomDateFormat("yyyy-MM-dd").
  • Custom Number Format – Steuern Sie die numerische Präzision, z. B. "#.##".
    setCustomNumberFormat("#.##").

Durch Anpassen dieser Einstellungen können Sie das erzeugte JSON an die Erwartungen nachgelagerter Dienste oder Datenbanken anpassen.

Fazit

Sie haben jetzt eine funktionierende Excel‑zu‑JSON‑Konvertierung in Java, die von Conholdate.Total for Java unterstützt wird. Das SDK übernimmt die schwere Arbeit, während die konfigurierbaren Optionen Ihnen Kontrolle über Formatierung und Leistung geben. Denken Sie daran, eine gültige Lizenz für den Produktionseinsatz zu erhalten; Sie können eine temporäre Lizenzseite anfordern, um die Bibliothek zu evaluieren, oder die vollständige Preisübersichtsseite für kommerzielle Bedingungen einsehen. Viel Spaß beim Programmieren!

FAQs

  • Wie führe ich eine Excel‑zu‑JSON‑Konvertierung in Java mit Conholdate.Total durch?
    Verwenden Sie die Klasse Conversion zusammen mit JsonConvertOptions, wie im Codebeispiel gezeigt. Das SDK abstrahiert die Dateiverwaltung und stellt einen einzelnen convert‑Aufruf bereit.

  • Kann ich Datums- und Zahlenformate während der Excel-zu-JSON-Konvertierung in Java anpassen?
    Ja. Die Methoden setCustomDateFormat und setCustomNumberFormat ermöglichen es Ihnen, Muster zu definieren, die den Erwartungen Ihres Zielsystems entsprechen.

  • Welche Lizenzierungsoptionen stehen für Conholdate.Total für Java zur Verfügung?
    Sie können eine temporäre Evaluierungslizenz von der temporären Lizenzseite erhalten oder eine Volllizenz über die Preisübersichtsseite erwerben.

  • Wird die Stapelverarbeitung für große Excel-Dateien unterstützt?
    Die setRowsPerBatch-Option ermöglicht es Ihnen, Arbeitsblätter in Teilen zu verarbeiten, was ideal für Szenarien der Stapelkonvertierung ist.

Mehr lesen