تبدیل گزارش‌های 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 ذخیره‌شده در فضای ذخیره‌سازی ابری یا تولید شده به‌صورت لحظه‌ای.
  • حفظ ساختارهای جدول، سبک‌های سلول و قالب‌های عددی در طول تبدیل.
  • قابلیت اجرای تبدیل بر روی یک سرور بک‌اند، یک کانتینر سرولت یا داخل یک میکروسرویس بدون نصب Microsoft Office.

کپی‑پیست دستی یا کتابخانه‌های سمت‑کلاینت نمی‌توانند قالب‌بندی سازگار را تضمین کنند، به‌ویژه هنگام کار با گزارش‌های بزرگ یا سناریوهای همزمانی بالا مانند یک سرور تبدیل HTML به XLSX در جاوا.

به کارگیری GroupDocs.Conversion Cloud SDK for Java برای برآورده کردن نیازهای صادرات

SDK یک موتور تبدیل مبتنی بر ابر ارائه می‌دهد که از HTML به عنوان ورودی و XLSX به عنوان خروجی پشتیبانی می‌کند و نیاز به مؤلفه‌های محلی Office را از بین می‌برد. قابلیت‌های کلیدی که با نیازها هم‌راستا هستند عبارتند از:

  • پردازش ابری - تبدیل سنگین بر روی سرورهای GroupDocs اجرا می‌شود و برای سروولت تبدیل HTML به XLSX در جاوا یا برنامه وب Spring Boot ایده‌آل است.
  • گزینه‌های قابل تنظیم - می‌توانید قالب‌بندی اصلی را حفظ کنید، نام شیت‌ها را تنظیم کنید و انواع داده‌های سلول را از طریق XlsxConvertOptions کنترل کنید.
  • کلاینت ایمن در برابر نخ‌ها - مناسب برای تبدیل HTML به XLSX به صورت چندنخی در جاوا، که امکان اجرای کارهای دسته‌ای با توان پردازشی بالا را فراهم می‌کند.

برای جزئیات بیشتر به مستندات رسمی و مرجع API مراجعه کنید.

تبدیل HTML به XLSX در جاوا: پیاده‌سازی

نصب 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 با فراخوانی مستقیم API REST انجام دهید. این جریان گام‌های 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 در جاوا زمانی که از پردازش مبتنی بر ابر GroupDocs.Conversion Cloud SDK for Java استفاده می‌کنید، ساده می‌شود. SDK پیچیدگی‌های تجزیه جداول HTML، مدیریت استایل‌ها و تولید فایل XLSX مطابق با استانداردها را پنهان می‌کند و آن را برای برنامه‌های وب سمت سرور، مبتنی بر سرولت یا Spring Boot ایده‌آل می‌سازد. چه در حال ساخت یک سرور تبدیل اختصاصی، یک میکروسرویس یا یک پردازشگر دسته‌ای چندنخی باشید، همان API برای بار مورد نیاز مقیاس‌پذیر است. به یاد داشته باشید برای ارزیابی یک مجوز موقت از صفحه مجوز موقت دریافت کنید و جزئیات قیمت‌گذاری برای استفاده در تولید را بررسی کنید. با کدها و مثال‌های cURL در این راهنما، اکنون می‌توانید خروجی HTML به XLSX را در هر راه‌حل جاوا یکپارچه کنید.

سوالات متداول

چگونه می‌توانم تبدیل HTML به XLSX را در یک سرولت جاوا انجام دهم؟
یک سرولت ایجاد کنید که فایل HTML بارگذاری‌شده را دریافت کند، از GroupDocs.Conversion Cloud SDK for Java برای فراخوانی convertDocument استفاده کند و جریان XLSX حاصل را به پاسخ HTTP برگرداند. کلاینت ایمن نسبت به رشته‌های این SDK به‌خوبی در داخل کانتینرهای سرولت کار می‌کند.

آیا امکان اجرای تبدیل HTML به XLSX به‌عنوان میکروسرویس در جاوا وجود دارد؟
بله. منطق تبدیل را در یک برنامه سبک Spring Boot بسته‌بندی کنید، یک نقطه انتهایی REST را در دسترس قرار دهید و بگذارید SDK تبدیل واقعی فرمت را انجام دهد. این رویکرد با الگوی میکروسرویس تبدیل HTML به XLSX در جاوا سازگار است.

آیا می‌توانم HTML را به XLSX در یک برنامه Java چندنخی تبدیل کنم؟
SDK به‌گونه‌ای طراحی شده است که ایمن برای استفاده در چندنخی باشد، بنابراین می‌توانید چندین کار تبدیل را به‌صورت موازی اجرا کنید، که برای سرور تبدیل HTML به XLSX با حجم بالا در سناریوهای Java مفید است.

کجا می‌توانم جزئیات بیشتری درباره مجوزدهی برای GroupDocs.Conversion Cloud SDK for Java پیدا کنم؟
صفحه مجوز موقت را برای دریافت کلید آزمایشی بازدید کنید و صفحه قیمت‌گذاری را برای گزینه‌های مجوز کامل بررسی کنید. هر دو لینک در صفحه اصلی محصول ارائه شده‌اند.

بیشتر بخوانید