Chuyển đổi các báo cáo HTML sang bảng tính Excel là một yêu cầu thường gặp cho các ứng dụng web dựa trên Java cần cho phép người dùng tải xuống phân tích hoặc hoá đơn. GroupDocs.Conversion Cloud SDK for Java cung cấp một API mạnh mẽ xử lý việc chuyển đổi định dạng mà không yêu cầu cài đặt Office cục bộ. Trong hướng dẫn này, bạn sẽ thấy cách thiết lập SDK, viết mã chuyển đổi, và cũng gọi cùng dịch vụ qua giao diện REST bằng cURL. Khi hoàn thành, bạn sẽ sẵn sàng nhúng chuyển đổi HTML‑to‑XLSX vào máy chủ, servlet, ứng dụng Spring Boot, hoặc bất kỳ dịch vụ Java đa luồng nào.

Xuất báo cáo HTML sang XLSX trong Java - Yêu cầu

Nhiều cổng thông tin doanh nghiệp tạo ra các bảng điều khiển HTML động mà người dùng muốn xuất ra dưới dạng sổ làm việc XLSX để phân tích ngoại tuyến. Các yêu cầu điển hình bao gồm:

  • Truy cập vào nguồn HTML được lưu trữ trong đám mây hoặc được tạo ngay lập tức.
  • Bảo tồn cấu trúc bảng, kiểu cell và định dạng số trong quá trình chuyển đổi.
  • Khả năng thực hiện chuyển đổi trên máy chủ backend, container servlet, hoặc bên trong microservice mà không cần cài đặt Microsoft Office.

Sao chép‑dán thủ công hoặc các thư viện phía máy khách không thể đảm bảo định dạng nhất quán, đặc biệt khi xử lý các báo cáo lớn hoặc các kịch bản đồng thời cao như một máy chủ chuyển đổi HTML sang XLSX trong Java.

Tận dụng GroupDocs.Conversion Cloud SDK for Java để đáp ứng nhu cầu xuất

SDK cung cấp một công cụ chuyển đổi dựa trên đám mây hỗ trợ HTML làm đầu vào và XLSX làm đầu ra, loại bỏ nhu cầu sử dụng các thành phần Office cục bộ. Các khả năng chính phù hợp với các yêu cầu là:

  • Xử lý đám mây - việc chuyển đổi nặng được thực hiện trên máy chủ GroupDocs, lý tưởng cho servlet chuyển đổi HTML sang XLSX trong Java hoặc ứng dụng web Spring Boot.
  • Tùy chọn có thể cấu hình - bạn có thể giữ nguyên định dạng gốc, đặt tên worksheet, và kiểm soát kiểu dữ liệu ô qua XlsxConvertOptions.
  • Khách hàng an toàn đa luồng - phù hợp cho việc chuyển đổi HTML sang XLSX đa luồng trong Java, cho phép các công việc batch có thông lượng cao.

Để biết thêm chi tiết, xem tài liệu chính thức và tham chiếu API.

Chuyển đổi HTML sang XLSX trong Java: Triển khai

Cài đặt GroupDocs.Conversion Cloud SDK

Thêm SDK vào dự án Maven của bạn:

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

Hoặc chạy lệnh cài đặt:

mvn install com.groupdocs:groupdocs-conversion-cloud

Khởi tạo API Client

Tạo một ApiClient với thông tin xác thực của bạn và khởi tạo 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);

Đặt Thông Tin Tệp Nguồn

Chỉ định tệp HTML nằm trong bộ nhớ đám mây mặc định.

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

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

Cấu hình tùy chọn chuyển đổi XLSX

Điều chỉnh các tùy chọn như giữ nguyên định dạng gốc.

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

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

Thực hiện chuyển đổi và lấy kết quả

Xây dựng yêu cầu, thực thi nó và lấy đường dẫn đầu ra.

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

Chuyển đổi tài liệu HTML sang XLSX bằng Java - Ví dụ mã hoàn chỉnh

Ví dụ dưới đây kết hợp tất cả các phần lại trong một lớp có thể chạy được.

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

Lưu ý: Ví dụ mã này minh họa chức năng cốt lõi. Trước khi sử dụng trong dự án của bạn, hãy chắc chắn cập nhật các đường dẫn tệp (input.html, output.xlsx) để phù hợp với vị trí tệp thực tế của bạn, xác minh rằng tất cả các phụ thuộc cần thiết đã được cài đặt đúng cách, và kiểm tra kỹ lưỡng trong môi trường phát triển của bạn. Nếu gặp bất kỳ vấn đề nào, vui lòng tham khảo tài liệu chính thức hoặc liên hệ với đội hỗ trợ để được trợ giúp.

Thực hiện xuất XLSX từ HTML bằng REST và cURL

Bạn có thể thực hiện cùng một quá trình chuyển đổi mà không cần viết mã Java bằng cách gọi trực tiếp REST API. Quy trình phản chiếu các bước của SDK: lấy token, tải lên tệp HTML, yêu cầu chuyển đổi và tải xuống kết quả XLSX.

Lấy Token Truy cập

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"

Tải lên HTML nguồn

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

Yêu cầu chuyển đổi

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

Tải xuống kết quả XLSX

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

Để xem danh sách đầy đủ các tham số và các ví dụ bổ sung, hãy tham khảo tài liệu API chính thức.

Kết luận

Việc chuyển đổi HTML sang XLSX trong Java trở nên đơn giản khi bạn tận dụng xử lý dựa trên đám mây của GroupDocs.Conversion Cloud SDK for Java. SDK trừu tượng hoá các phức tạp của việc phân tích bảng HTML, xử lý kiểu dáng và tạo ra tệp XLSX tuân thủ tiêu chuẩn, làm cho nó lý tưởng cho các ứng dụng web phía máy chủ, dựa trên servlet hoặc Spring Boot. Dù bạn đang xây dựng một máy chủ chuyển đổi chuyên dụng, một microservice, hay một bộ xử lý batch đa luồng, cùng một API vẫn mở rộng để đáp ứng tải trọng. Hãy nhớ lấy giấy phép tạm thời từ trang giấy phép tạm thời để đánh giá và xem xét chi tiết giá cho việc sử dụng trong môi trường sản xuất. Với mã nguồn và các ví dụ cURL trong hướng dẫn này, bạn có thể tích hợp xuất HTML sang XLSX vào bất kỳ giải pháp Java nào.

Câu hỏi thường gặp

Làm thế nào tôi có thể thực hiện chuyển đổi HTML sang XLSX trong một servlet Java?
Tạo một servlet nhận tệp HTML được tải lên, sử dụng GroupDocs.Conversion Cloud SDK for Java để gọi convertDocument, và ghi luồng XLSX kết quả trở lại phản hồi HTTP. Client thread‑safe của SDK hoạt động tốt trong các container servlet.

Có thể chạy chuyển đổi HTML sang XLSX dưới dạng microservice trong Java không?
Có. Đóng gói logic chuyển đổi trong một ứng dụng Spring Boot nhẹ, mở một endpoint REST, và để SDK xử lý việc chuyển đổi định dạng thực tế. Cách tiếp cận này phù hợp với mẫu microservice chuyển đổi HTML sang XLSX trong Java.

Có thể chuyển đổi HTML sang XLSX trong một ứng dụng Java đa luồng không?
SDK được thiết kế để an toàn với đa luồng, vì vậy bạn có thể khởi chạy nhiều tác vụ chuyển đổi đồng thời, điều này hữu ích cho máy chủ chuyển đổi HTML sang XLSX với khối lượng lớn trong các kịch bản Java.

Tôi có thể tìm thêm chi tiết về giấy phép cho GroupDocs.Conversion Cloud SDK for Java ở đâu?
Truy cập trang giấy phép tạm thời để nhận khóa dùng thử và kiểm tra trang giá để biết các tùy chọn giấy phép đầy đủ. Cả hai liên kết đều được cung cấp trên trang chính của sản phẩm.

Read More