Konwertowanie raportów w formacie HTML do arkuszy Excel jest częstym wymaganiem dla aplikacji internetowych opartych na Javie, które muszą umożliwić użytkownikom pobieranie analiz lub faktur. GroupDocs.Conversion Cloud SDK for Java zapewnia solidne API, które zajmuje się ciężką pracą transformacji formatów bez konieczności instalacji lokalnego Office. W tym przewodniku zobaczysz, jak skonfigurować SDK, napisać kod konwersji oraz wywołać tę samą usługę przez interfejs REST przy użyciu cURL. Po zakończeniu będziesz gotowy, aby osadzić konwersję HTML‑do‑XLSX w serwerze, servletcie, aplikacji Spring Boot lub dowolnej wielowątkowej usłudze Java.
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.
