Mengonversi HTML laporan menjadi spreadsheet Excel adalah kebutuhan yang sering muncul untuk aplikasi web berbasis Java yang perlu memungkinkan pengguna mengunduh analitik atau faktur. GroupDocs.Conversion Cloud SDK for Java menyediakan API yang kuat yang menangani pekerjaan berat transformasi format tanpa memerlukan instalasi Office lokal. Dalam panduan ini Anda akan melihat cara menyiapkan SDK, menulis kode konversi, dan juga memanggil layanan yang sama melalui antarmuka REST dengan cURL. Pada akhir panduan Anda akan siap menyematkan konversi HTML‑ke‑XLSX ke dalam server, servlet, aplikasi Spring Boot, atau layanan Java multithreaded apa pun.
Mengekspor Laporan HTML ke XLSX dalam Java - Persyaratan
Banyak portal perusahaan menghasilkan dasbor HTML dinamis yang ingin diekspor pengguna sebagai buku kerja XLSX untuk analisis offline. Persyaratan umum meliputi:
- Akses ke sumber HTML yang disimpan di penyimpanan cloud atau dihasilkan secara langsung.
- Pemeliharaan struktur tabel, gaya cell, dan format numerik selama konversi.
- Kemampuan menjalankan konversi pada server backend, kontainer servlet, atau di dalam microservice tanpa menginstal Microsoft Office.
Penyalinan manual atau perpustakaan sisi klien tidak dapat menjamin format yang konsisten, terutama saat menangani laporan besar atau skenario dengan tingkat konkruensi tinggi seperti server konversi HTML ke XLSX di Java.
Memanfaatkan GroupDocs.Conversion Cloud SDK for Java untuk Memenuhi Kebutuhan Ekspor
SDK menawarkan mesin konversi berbasis cloud yang mendukung HTML sebagai input dan XLSX sebagai output, menghilangkan kebutuhan akan komponen Office lokal. Kemampuan utama yang sesuai dengan persyaratan adalah:
- Pemrosesan cloud - konversi berat dijalankan di server GroupDocs, ideal untuk servlet konversi HTML ke XLSX di Java atau aplikasi web Spring Boot.
- Opsi yang dapat dikonfigurasi - Anda dapat mempertahankan format asli, mengatur nama lembar kerja, dan mengontrol tipe data sel melalui
XlsxConvertOptions. - Klien aman‑thread - cocok untuk multithreading konversi HTML ke XLSX di Java, memungkinkan pekerjaan batch dengan throughput tinggi.
Untuk detail lebih lanjut, lihat dokumentasi resmi dan referensi API.
Konversi HTML ke XLSX di Java: Implementasi
Instal GroupDocs.Conversion Cloud SDK
Tambahkan SDK ke proyek Maven Anda:
<dependency>
<groupId>com.groupdocs</groupId>
<artifactId>groupdocs-conversion-cloud</artifactId>
<version>23.12</version>
</dependency>
Atau jalankan perintah instalasi:
mvn install com.groupdocs:groupdocs-conversion-cloud
Inisialisasi Klien API
Buat ApiClient dengan kredensial Anda dan instansiasi 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);
Atur Informasi File Sumber
Tentukan file HTML yang berada di penyimpanan cloud default.
import com.groupdocs.conversion.cloud.model.FileInfo;
FileInfo sourceFile = new FileInfo();
sourceFile.setFilePath("input.html"); // path in the cloud storage
sourceFile.setStorageName("DefaultStorage"); // optional
Konfigurasikan Opsi Konversi XLSX
Sesuaikan opsi seperti mempertahankan format asli.
import com.groupdocs.conversion.cloud.model.XlsxConvertOptions;
XlsxConvertOptions xlsxOptions = new XlsxConvertOptions();
xlsxOptions.setPreserveOriginalFormatting(true);
Lakukan Konversi dan Dapatkan Hasil
Bangun permintaan, jalankan, dan dapatkan jalur output.
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();
}
Transformasi Dokumen HTML ke XLSX Menggunakan Java - Contoh Kode Lengkap
Contoh di bawah ini menggabungkan semua bagian menjadi satu kelas yang dapat dijalankan.
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();
}
}
}
Catatan: Contoh kode ini menunjukkan fungsi inti. Sebelum menggunakannya dalam proyek Anda, pastikan untuk memperbarui jalur file (
input.html,output.xlsx) agar sesuai dengan lokasi file Anda yang sebenarnya, verifikasi bahwa semua dependensi yang diperlukan telah terpasang dengan benar, dan uji secara menyeluruh di lingkungan pengembangan Anda. Jika Anda menemukan masalah, silakan merujuk ke dokumentasi resmi atau hubungi tim dukungan untuk bantuan.
Executing XLSX Export from HTML with REST and cURL
Anda dapat mencapai konversi yang sama tanpa menulis kode Java dengan memanggil REST API secara langsung. Alur ini mencerminkan langkah‑langkah SDK: mendapatkan token, mengunggah file HTML, meminta konversi, dan mengunduh hasil XLSX.
Dapatkan Token Akses
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"
Unggah HTML Sumber
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
Permintaan Konversi
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
}
}'
Unduh Hasil XLSX
curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/output.xlsx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o output.xlsx
Untuk daftar lengkap parameter dan contoh tambahan, lihat dokumentasi API resmi.
Kesimpulan
Konversi HTML ke XLSX dalam Java menjadi sederhana ketika Anda memanfaatkan pemrosesan berbasis cloud dari GroupDocs.Conversion Cloud SDK for Java. SDK mengabstraksi kompleksitas parsing tabel HTML, penanganan gaya, dan pembuatan file XLSX yang mematuhi standar, menjadikannya ideal untuk aplikasi web sisi‑server, berbasis servlet, atau Spring Boot. Baik Anda membangun server konversi khusus, layanan mikro, atau pemroses batch multithread, API yang sama dapat diskalakan untuk menangani beban. Ingatlah untuk memperoleh lisensi sementara dari temporary license page untuk evaluasi dan tinjau detail harga untuk penggunaan produksi. Dengan contoh kode dan cURL dalam panduan ini, Anda kini dapat mengintegrasikan ekspor HTML ke XLSX ke dalam solusi Java apa pun.
FAQs
Bagaimana saya dapat melakukan konversi HTML ke XLSX dalam servlet Java?
Buat servlet yang menerima file HTML yang diunggah, gunakan GroupDocs.Conversion Cloud SDK for Java untuk memanggil convertDocument, dan tulis aliran XLSX yang dihasilkan kembali ke respons HTTP. Klien yang aman untuk thread pada SDK bekerja dengan baik di dalam kontainer servlet.
Apakah memungkinkan menjalankan konversi HTML ke XLSX sebagai microservice di Java?
Ya. Paketkan logika konversi dalam aplikasi Spring Boot yang ringan, expose endpoint REST, dan biarkan SDK menangani transformasi format sebenarnya. Pendekatan ini cocok dengan pola microservice konversi HTML ke XLSX di Java.
Bisakah saya mengonversi HTML ke XLSX dalam aplikasi Java multithread?
SDK dirancang untuk aman terhadap thread, sehingga Anda dapat meluncurkan beberapa tugas konversi secara paralel, yang berguna untuk server konversi HTML ke XLSX dengan volume tinggi dalam skenario Java.
Di mana saya dapat menemukan detail lebih lanjut tentang lisensi untuk GroupDocs.Conversion Cloud SDK for Java?
Kunjungi halaman lisensi sementara untuk mendapatkan kunci percobaan dan periksa halaman harga untuk opsi lisensi penuh. Kedua tautan disediakan di halaman utama produk.
