Перетворення звітів у форматі HTML у електронні таблиці Excel є поширеною вимогою для веб‑додатків на Java, які повинні дозволяти користувачам завантажувати аналітику або рахунки. GroupDocs.Conversion Cloud SDK for Java надає потужний API, який виконує важку роботу з трансформації форматів без необхідності встановлення локального Office. У цьому посібнику ви побачите, як налаштувати SDK, написати код конвертації та також викликати той самий сервіс через REST‑інтерфейс за допомогою cURL. Після завершення ви будете готові вбудувати конвертацію HTML‑у‑XLSX у сервер, сервлет, додаток Spring Boot або будь‑який багатопотоковий Java‑сервіс.

Експортування HTML-звітів у XLSX у Java - Вимоги

Багато корпоративних порталів генерують динамічні HTML‑дашборди, які користувачі хочуть експортувати у вигляді робочих книг XLSX для офлайн‑аналізу. Типові вимоги включають:

  • Доступ до HTML‑джерела, збереженого в хмарному сховищі, або згенерованого «на льоту».
  • Збереження структури таблиць, стилів cell та числових форматів під час конвертації.
  • Можливість запускати конвертацію на бекенд‑сервері, у контейнері сервлетів або всередині мікросервісу без встановлення Microsoft Office.

Ручне копіювання‑вставка або бібліотеки на стороні клієнта не можуть гарантувати послідовне форматування, особливо при роботі з великими звітами або сценаріями з високою конкурентністю, такими як сервер конвертації HTML у XLSX на Java.

Використання GroupDocs.Conversion Cloud SDK for Java для задоволення потреб у експорті

SDK пропонує хмарний движок конвертації, який підтримує HTML як вхідний формат і XLSX як вихідний, усуваючи необхідність у локальних компонентах Office. Ключові можливості, які відповідають вимогам, наступні:

  • Cloud processing - важке перетворення виконується на серверах GroupDocs, ідеально підходить для сервлета перетворення HTML у XLSX на Java або веб‑додатку Spring Boot.
  • Configurable options - ви можете зберігати оригінальне форматування, встановлювати імена листів і контролювати типи даних клітинок за допомогою XlsxConvertOptions.
  • Thread‑safe client - підходить для багатопотокового перетворення HTML у XLSX на Java, забезпечуючи високопродуктивні пакетні завдання.

Для отримання докладнішої інформації перегляньте офіційну документацію та довідник API.

Конвертація HTML у XLSX у Java: Реалізація

Встановити GroupDocs.Conversion Cloud SDK

Додайте SDK до вашого Maven‑проекту:

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

Або запустіть команду встановлення:

mvn install com.groupdocs:groupdocs-conversion-cloud

Ініціалізація API-клієнта

Створіть ApiClient з вашими обліковими даними та створіть екземпляр 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);

Встановити інформацію про вихідний файл

Вкажіть HTML-файл, який знаходиться у сховищі за замовчуванням у хмарі.

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

Налаштуйте параметри, наприклад збереження оригінального форматування.

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

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

Виконайте конвертацію та отримайте результат

Створіть запит, виконайте його та отримайте шлях до вихідного файлу.

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

Перетворення HTML-документів у XLSX за допомогою Java — повний приклад коду

Нижче наведений приклад збирає всі частини разом в один виконуваний клас.

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

Примітка: Цей приклад коду демонструє основну функціональність. Перш ніж використовувати його у вашому проєкті, переконайтеся, що оновили шляхи до файлів (input.html, output.xlsx) відповідно до фактичних розташувань, перевірте, що всі необхідні залежності встановлені правильно, і ретельно протестуйте у вашому середовищі розробки. Якщо ви зіткнетеся з будь‑якими проблемами, будь ласка, зверніться до офіційної документації або до команди підтримки за допомогою.

Виконання експорту XLSX з HTML за допомогою REST і cURL

Ви можете досягти того ж перетворення без написання коду Java, викликавши REST API безпосередньо. Потік відповідає крокам SDK: отримати токен, завантажити HTML‑файл, запросити перетворення та завантажити результат у форматі XLSX.

Отримати токен доступу

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"

Завантажити вихідний 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

Запит конвертації

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

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

Для повного списку параметрів та додаткових прикладів перегляньте офіційну документацію API.

Висновок

Конвертація HTML у XLSX у Java стає простою, коли ви використовуєте хмарну обробку GroupDocs.Conversion Cloud SDK for Java. SDK абстрагує складність парсингу HTML‑таблиць, обробки стилів та створення файлу XLSX, що відповідає стандартам, що робить його ідеальним для серверних, сервлет‑базованих або Spring Boot веб‑додатків. Незалежно від того, чи створюєте ви спеціальний сервер конвертації, мікросервіс або багатопотоковий пакетний процесор, той самий API масштабуються під навантаження. Не забудьте отримати тимчасову ліцензію зі сторінки тимчасової ліцензії для оцінки та переглянути деталі ціноутворення для використання у продакшн. З кодом та прикладами cURL у цьому посібнику ви тепер можете інтегрувати експорт HTML у XLSX у будь‑яке Java‑рішення.

FAQs

Як можна виконати конвертацію HTML у XLSX у Java сервлеті?
Створіть сервлет, який приймає завантажений HTML‑файл, використовує GroupDocs.Conversion Cloud SDK for Java для виклику convertDocument і записує отриманий потік XLSX у HTTP‑відповідь. Потокобезпечний клієнт SDK добре працює в контейнерах сервлетів.

Чи можливо запустити конвертацію HTML у XLSX як мікросервіс на Java?
Так. Пакуйте логіку конвертації в легку Spring Boot програму, відкрийте REST‑endpoint і дозвольте SDK обробляти фактичне перетворення формату. Такий підхід відповідає шаблону мікросервісу конвертації HTML у XLSX на Java.

Чи можу я конвертувати HTML у XLSX у багатопотоковому Java-додатку?
SDK розроблений як потокобезпечний, тому ви можете запускати кілька завдань конвертації паралельно, що корисно для серверу конвертації HTML у XLSX з великим обсягом у сценаріях Java.

Де я можу знайти докладнішу інформацію про ліцензування GroupDocs.Conversion Cloud SDK for Java?
Відвідайте тимчасову сторінку ліцензії, щоб отримати пробний ключ, і перевірте сторінку цін, щоб дізнатися про варіанти повної ліцензії. Обидва посилання розміщені на головній сторінці продукту.

Читати далі