Das Konvertieren von HTML Berichten in Excel‑Tabellen ist eine häufige Anforderung für Java‑basierte Webanwendungen, die es Benutzern ermöglichen müssen, Analysen oder Rechnungen herunterzuladen. GroupDocs.Conversion Cloud SDK for Java bietet eine robuste API, die die aufwändige Formatumwandlung übernimmt, ohne dass lokale Office‑Installationen erforderlich sind. In diesem Leitfaden sehen Sie, wie Sie das SDK einrichten, den Konvertierungscode schreiben und denselben Dienst auch über eine REST‑Schnittstelle mit cURL aufrufen. Am Ende sind Sie bereit, die HTML‑zu‑XLSX Konvertierung in einen Server, Servlet, Spring Boot‑App oder einen beliebigen multithreaded Java‑Dienst einzubetten.

Exportieren von HTML-Berichten nach XLSX in Java - Anforderungen

Viele Unternehmensportale erzeugen dynamische HTML‑Dashboards, die Benutzer als XLSX‑Arbeitsmappen für die Offline‑Analyse exportieren möchten. Die typischen Anforderungen umfassen:

  • Zugriff auf den HTML‑Quellcode, der im Cloud‑Speicher gespeichert oder on‑the‑fly generiert wird.
  • Erhaltung von Tabellenstrukturen, cell Stilen und numerischen Formaten während der Konvertierung.
  • Möglichkeit, die Konvertierung auf einem Backend‑Server, einem Servlet‑Container oder innerhalb eines Microservice auszuführen, ohne Microsoft Office zu installieren.

Manuelles Kopieren‑Einfügen oder client‑seitige Bibliotheken können keine konsistente Formatierung garantieren, insbesondere bei großen Berichten oder Szenarien mit hoher Parallelität, wie z. B. einem HTML‑zu‑XLSX‑Konvertierungsserver in Java.

Nutzung von GroupDocs.Conversion Cloud SDK for Java, um Exportanforderungen zu erfüllen

Das SDK bietet eine cloudbasierte Konvertierungs‑Engine, die HTML als Eingabe und XLSX als Ausgabe unterstützt und damit die Notwendigkeit lokaler Office‑Komponenten eliminiert. Schlüssel‑Funktionen, die den Anforderungen entsprechen, sind:

  • Cloud-Verarbeitung - die aufwändige Konvertierung läuft auf den GroupDocs-Servern, ideal für einen HTML‑zu‑XLSX‑Konvertierungs‑Servlet in Java oder eine Spring Boot‑Webanwendung.
  • Konfigurierbare Optionen - Sie können die ursprüngliche Formatierung beibehalten, Arbeitsblattnamen festlegen und Zelldatentypen über XlsxConvertOptions steuern.
  • Thread‑sicherer Client - geeignet für HTML‑zu‑XLSX‑Konvertierung in Multithreading‑Umgebungen in Java, wodurch hochdurchsatz‑Batch‑Jobs ermöglicht werden.

Weitere Details finden Sie in der offiziellen Dokumentation und in der API-Referenz.

HTML-zu-XLSX-Konvertierung in Java: Implementierung

Installieren GroupDocs.Conversion Cloud SDK

Fügen Sie das SDK zu Ihrem Maven-Projekt hinzu:

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-conversion-cloud</artifactId>
    <version>23.12</version>
</dependency>

Oder führen Sie den Installationsbefehl aus:

mvn install com.groupdocs:groupdocs-conversion-cloud

API-Client initialisieren

Erstellen Sie einen ApiClient mit Ihren Anmeldeinformationen und instanziieren Sie ConversionApi.

import com.groupdocs.conversion.cloud.ApiClient;
import com.groupdocs.conversion.cloud.api.ConversionApi;

ApiClient apiClient = new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
ConversionApi conversionApi = new ConversionApi(apiClient);

Quelldateiinformationen festlegen

Geben Sie die HTML-Datei an, die im Standard‑Cloud‑Speicher gespeichert ist.

import com.groupdocs.conversion.cloud.model.FileInfo;

FileInfo sourceFile = new FileInfo();
sourceFile.setFilePath("input.html");          // path in the cloud storage
sourceFile.setStorageName("DefaultStorage");   // optional

XLSX-Konvertierungsoptionen konfigurieren

Passen Sie Optionen an, z. B. das Beibehalten der ursprünglichen Formatierung.

import com.groupdocs.conversion.cloud.model.XlsxConvertOptions;

XlsxConvertOptions xlsxOptions = new XlsxConvertOptions();
xlsxOptions.setPreserveOriginalFormatting(true);

Durchführung der Konvertierung und Abrufen des Ergebnisses

Erstellen Sie die Anforderung, führen Sie sie aus und erhalten Sie den Ausgabepfad.

import com.groupdocs.conversion.cloud.model.ConvertDocumentRequest;
import com.groupdocs.conversion.cloud.model.ConvertDocumentResponse;

ConvertDocumentRequest request = new ConvertDocumentRequest();
request.setFileInfo(sourceFile);
request.setFormat("xlsx");                     // target format
request.setConvertOptions(xlsxOptions);
request.setOutputPath("output.xlsx");          // desired output path

try {
    ConvertDocumentResponse response = conversionApi.convertDocument(request);
    System.out.println("Conversion successful. Output file: " + response.getPath());
} catch (Exception e) {
    System.err.println("Error during conversion: " + e.getMessage());
    e.printStackTrace();
}

Umwandeln von HTML-Dokumenten in XLSX mit Java – Vollständiges Codebeispiel

Das folgende Beispiel fügt alle Teile in einer einzigen ausführbaren Klasse zusammen.

import com.groupdocs.conversion.cloud.ApiClient;
import com.groupdocs.conversion.cloud.api.ConversionApi;
import com.groupdocs.conversion.cloud.model.ConvertDocumentRequest;
import com.groupdocs.conversion.cloud.model.ConvertDocumentResponse;
import com.groupdocs.conversion.cloud.model.FileInfo;
import com.groupdocs.conversion.cloud.model.XlsxConvertOptions;

public class HtmlToXlsxConversionExample {
    public static void main(String[] args) {
        // Initialize API client (replace with your actual credentials)
        ApiClient apiClient = new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
        ConversionApi conversionApi = new ConversionApi(apiClient);

// Define source HTML file information
        FileInfo sourceFile = new FileInfo();
        sourceFile.setFilePath("input.html");          // path in the cloud storage
        sourceFile.setStorageName("DefaultStorage");   // optional, use default if omitted

// Set conversion options specific to XLSX output
        XlsxConvertOptions xlsxOptions = new XlsxConvertOptions();
        // Example option: preserve original formatting (if needed)
        xlsxOptions.setPreserveOriginalFormatting(true);

// Build conversion request
        ConvertDocumentRequest request = new ConvertDocumentRequest();
        request.setFileInfo(sourceFile);
        request.setFormat("xlsx");                     // target format
        request.setConvertOptions(xlsxOptions);
        request.setOutputPath("output.xlsx");          // desired output path in cloud storage

try {
            // Perform conversion
            ConvertDocumentResponse response = conversionApi.convertDocument(request);
            System.out.println("Conversion successful. Output file: " + response.getPath());
        } catch (Exception e) {
            System.err.println("Error during conversion: " + e.getMessage());
            e.printStackTrace();
        }
    }
}

Hinweis: Dieses Codebeispiel demonstriert die Kernfunktionalität. Bevor Sie es in Ihrem Projekt verwenden, stellen Sie sicher, dass Sie die Dateipfade (input.html, output.xlsx) an Ihre tatsächlichen Speicherorte anpassen, 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.

Ausführen des XLSX-Exports von HTML mit REST und cURL

Sie können dieselbe Konvertierung erreichen, ohne Java‑Code zu schreiben, indem Sie die REST‑API direkt aufrufen. Der Ablauf spiegelt die SDK‑Schritte wider: ein Token erhalten, die HTML‑Datei hochladen, die Konvertierung anfordern und das XLSX‑Ergebnis herunterladen.

Zugriffstoken abrufen

curl -X POST "https://api.groupdocs.cloud/v2.0/connect/token" \
     -H "Content-Type: application/x-www-form-urlencoded" \
     -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"

Quell‑HTML hochladen

curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/input.html" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: text/html" \
     --data-binary @input.html

Anfrage zur Konvertierung

curl -X POST "https://api.groupdocs.cloud/v2.0/conversion/convert" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": {
               "filePath": "input.html",
               "storageName": "DefaultStorage"
           },
           "outputPath": "output.xlsx",
           "format": "xlsx",
           "convertOptions": {
               "preserveOriginalFormatting": true
           }
         }'

XLSX-Ergebnis herunterladen

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/output.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.xlsx

Für eine vollständige Liste der Parameter und zusätzliche Beispiele, siehe die offizielle API‑Dokumentation.

Fazit

HTML‑zu‑XLSX‑Konvertierung in Java wird unkompliziert, wenn Sie die cloudbasierte Verarbeitung des GroupDocs.Conversion Cloud SDK for Java nutzen. Das SDK abstrahiert die Komplexität beim Parsen von HTML‑Tabellen, beim Umgang mit Styles und beim Erzeugen einer standardkonformen XLSX‑Datei, wodurch es sich ideal für serverseitige, servletbasierte oder Spring Boot‑Webanwendungen eignet. Egal, ob Sie einen dedizierten Konvertierungsserver, einen Microservice oder einen mehrthreadigen Batch‑Prozessor erstellen, dieselbe API skaliert, um die Last zu bewältigen. Denken Sie daran, eine temporäre Lizenz von der temporäre Lizenzseite für die Evaluierung zu erhalten und die Preisdetails für den Produktionseinsatz zu prüfen. Mit dem Code und den cURL‑Beispielen in diesem Leitfaden können Sie nun den HTML‑zu‑XLSX‑Export in jede Java‑Lösung integrieren.

FAQs

Wie kann ich die HTML-zu-XLSX-Konvertierung in einem Java-Servlet durchführen?
Erstellen Sie ein Servlet, das die hochgeladene HTML-Datei empfängt, das GroupDocs.Conversion Cloud SDK for Java verwendet, um convertDocument aufzurufen, und den resultierenden XLSX‑Stream zurück in die HTTP‑Antwort schreibt. Der thread‑sichere Client des SDK funktioniert gut in Servlet‑Containern.

Ist es möglich, die HTML‑zu‑XLSX‑Konvertierung als Microservice in Java auszuführen?
Ja. Verpacken Sie die Konvertierungslogik in einer leichten Spring Boot‑Anwendung, stellen Sie einen REST‑Endpunkt bereit und lassen Sie das SDK die eigentliche Formatumwandlung übernehmen. Dieser Ansatz passt zum Muster eines HTML‑zu‑XLSX‑Microservice in Java.

Kann ich HTML zu XLSX in einer multithreaded Java-Anwendung konvertieren?
Das SDK ist thread‑sicher konzipiert, sodass Sie mehrere Konvertierungsaufgaben parallel starten können, was für einen hochvolumigen HTML‑zu‑XLSX‑Konvertierungsserver in Java‑Szenarien nützlich ist.

Wo finde ich weitere Details zur Lizenzierung für GroupDocs.Conversion Cloud SDK for Java?
Besuchen Sie die temporäre Lizenzseite, um einen Testschlüssel zu erhalten, und prüfen Sie die Preiseseite für Volllizenzoptionen. Beide Links werden auf der Hauptseite des Produkts bereitgestellt.

Weiterlesen