Eksportowanie raportów HTML do XLSX w Javie – Wymagania

Wiele portalów korporacyjnych generuje dynamiczne pulpity HTML, które użytkownicy chcą eksportować jako skoroszyty XLSX do analizy offline. Typowe wymagania obejmują:

• Dostęp do źródła HTML przechowywanego w chmurze lub generowanego w locie.
• Zachowanie struktury tabel, stylów komórki i formatów liczbowych podczas konwersji.
• Możliwość uruchomienia konwersji na serwerze backendowym, w kontenerze serwletów lub wewnątrz mikrousługi bez instalacji Microsoft Office.

Ręczne kopiowanie‑wklejanie lub biblioteki po stronie klienta nie mogą zagwarantować spójnego formatowania, szczególnie przy obsłudze dużych raportów lub scenariuszy o wysokiej współbieżności, takich jak serwer konwertujący HTML na XLSX w Javie.

Wykorzystanie GroupDocs.Conversion Cloud SDK for Java do spełnienia potrzeb eksportu

SDK oferuje oparty na chmurze silnik konwersji, który obsługuje HTML jako wejście i XLSX jako wyjście, eliminując potrzebę lokalnych komponentów Office. Kluczowe możliwości, które odpowiadają wymaganiom, to:

• Przetwarzanie w chmurze - ciężka konwersja odbywa się na serwerach GroupDocs, idealna dla serwletu konwersji HTML do XLSX w Javie lub aplikacji webowej Spring Boot.
• Konfigurowalne opcje - możesz zachować oryginalne formatowanie, ustawić nazwy arkuszy oraz kontrolować typy danych komórek za pomocą XlsxConvertOptions.
• Klient bezpieczny wątkowo - odpowiedni do wielowątkowej konwersji HTML do XLSX w Javie, umożliwiając przetwarzanie wsadowe o wysokiej przepustowości.

Aby uzyskać więcej szczegółów, zobacz oficjalną dokumentację oraz referencję API.

Konwersja HTML do XLSX w Javie: Implementacja

Zainstaluj GroupDocs.Conversion Cloud SDK

Dodaj SDK do swojego projektu Maven:

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

Lub uruchom polecenie instalacji:

mvn install com.groupdocs:groupdocs-conversion-cloud

Zainicjalizuj klienta API

Utwórz ApiClient przy użyciu swoich danych uwierzytelniających i zainicjuj 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);

Ustaw informacje o pliku źródłowym

Określ plik HTML, który znajduje się w domyślnym magazynie w chmurze.

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

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

Konfiguracja opcji konwersji XLSX

Dostosuj opcje, takie jak zachowanie oryginalnego formatowania.

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

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

Wykonaj konwersję i pobierz wynik

Zbuduj żądanie, wykonaj je i uzyskaj ścieżkę wyjściową.

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

Konwertowanie dokumentów HTML do XLSX przy użyciu Javy - Pełny przykład kodu

Poniższy przykład łączy wszystkie elementy w jednej uruchamialnej klasie.

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

Uwaga: Ten przykład kodu demonstruje podstawową funkcjonalność. Przed użyciem w swoim projekcie upewnij się, że zaktualizowałeś ścieżki do plików (input.html, output.xlsx), aby odpowiadały rzeczywistym lokalizacjom, sprawdź, czy wszystkie wymagane zależności są poprawnie zainstalowane, i dokładnie przetestuj w środowisku programistycznym. Jeśli napotkasz jakiekolwiek problemy, odwołaj się do oficjalnej dokumentacji lub skontaktuj się z zespołem wsparcia w celu uzyskania pomocy.

Wykonywanie eksportu XLSX z HTML przy użyciu REST i cURL

Możesz uzyskać tę samą konwersję bez pisania kodu w Javie, wywołując bezpośrednio interfejs REST API. Przebieg odzwierciedla kroki SDK: uzyskaj token, prześlij plik HTML, zażądaj konwersji i pobierz wynik w formacie XLSX.

Uzyskaj token dostępu

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"

Prześlij źródłowy HTML

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

Żądanie konwersji

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

Pobierz wynik XLSX

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

Aby uzyskać pełną listę parametrów i dodatkowe przykłady, zobacz oficjalną dokumentację API.

Wnioski

Konwersja HTML do XLSX w Javie staje się prosta, gdy wykorzystujesz przetwarzanie w chmurze za pomocą GroupDocs.Conversion Cloud SDK for Java. SDK ukrywa złożoność parsowania tabel HTML, obsługi stylów i generowania pliku XLSX zgodnego ze standardami, co czyni go idealnym dla aplikacji webowych po stronie serwera, opartych na servletach lub Spring Boot. Niezależnie od tego, czy tworzysz dedykowany serwer konwersji, mikrousługę, czy wielowątkowy procesor wsadowy, to samo API skaluje się, aby sprostać obciążeniu. Pamiętaj, aby uzyskać tymczasową licencję z strony tymczasowej licencji w celu oceny oraz zapoznać się ze szczegółami cenowymi dla produkcyjnego użycia. Dzięki kodowi i przykładom cURL w tym przewodniku możesz teraz zintegrować eksport HTML do XLSX w dowolnym rozwiązaniu Java.

FAQs

Jak mogę wykonać konwersję HTML do XLSX w servletcie Java?
Utwórz servlet, który odbiera przesłany plik HTML, używa GroupDocs.Conversion Cloud SDK for Java do wywołania convertDocument i zapisuje otrzymany strumień XLSX z powrotem w odpowiedzi HTTP. Wątkowo‑bezpieczny klient SDK dobrze działa w kontenerach servletów.

Czy można uruchomić konwersję HTML do XLSX jako mikroserwis w Javie?
Tak. Zapakuj logikę konwersji w lekką aplikację Spring Boot, udostępnij endpoint REST i pozwól SDK obsłużyć rzeczywistą transformację formatu. To podejście pasuje do wzorca mikroserwisu konwersji HTML do XLSX w Javie.

Czy mogę konwertować HTML do XLSX w wielowątkowej aplikacji Java?
SDK jest zaprojektowany jako wątkowo‑bezpieczny, więc możesz uruchamiać wiele zadań konwersji równocześnie, co jest przydatne przy serwerze konwersji HTML do XLSX o dużej wydajności w scenariuszach Java.

Gdzie mogę znaleźć więcej szczegółów na temat licencjonowania GroupDocs.Conversion Cloud SDK for Java?
Odwiedź tymczasową stronę licencji, aby uzyskać klucz próbny, i sprawdź stronę cenową pod kątem opcji pełnej licencji. Oba linki są podane na głównej stronie produktu.

Czytaj więcej

• Konwertuj PDF do HTML przy użyciu Java - konwersja PDF do sieci
• Samouczek konwersji XLSX do JPG w Java
• Samouczek konwersji HTML do XLSX krok po kroku w PHP