تحويل تقارير HTML إلى جداول بيانات Excel هو طلب شائع لتطبيقات الويب القائمة على Java‑based التي تحتاج إلى السماح للمستخدمين بتنزيل التحليلات أو الفواتير. يوفر GroupDocs.Conversion Cloud SDK for Java واجهة برمجة تطبيقات قوية تتعامل مع التحويل الثقيل للملفات دون الحاجة إلى تثبيت Office محليًا. في هذا الدليل ستتعرف على كيفية إعداد SDK، كتابة كود التحويل، وكذلك استدعاء نفس الخدمة عبر واجهة REST باستخدام cURL. في النهاية ستكون جاهزًا لدمج تحويل HTML‑to‑XLSX في خادم، servlet، تطبيق Spring Boot، أو أي خدمة Java متعددة الخيوط.

تصدير تقارير HTML إلى XLSX في Java - المتطلبات

العديد من بوابات المؤسسات تُنشئ لوحات تحكم HTML ديناميكية يرغب المستخدمون في تصديرها كدفاتر عمل XLSX للتحليل دون اتصال. تشمل المتطلبات النموذجية ما يلي:

  • الوصول إلى مصدر HTML المخزن في التخزين السحابي أو المُولَّد في الوقت الفعلي.
  • الحفاظ على هياكل الجداول، أنماط خلية وتنسيقات الأرقام أثناء التحويل.
  • القدرة على تشغيل التحويل على خادم خلفي، أو حاوية servlet، أو داخل خدمة مصغرة دون تثبيت Microsoft Office.

لا يمكن للنسخ واللصق اليدوي أو المكتبات على جانب العميل ضمان تنسيق ثابت، خاصةً عند التعامل مع تقارير كبيرة أو سيناريوهات ذات تزامن عالي مثل خادم تحويل HTML إلى XLSX في Java.

الاستفادة من GroupDocs.Conversion Cloud SDK for Java لتلبية احتياجات التصدير

يوفر SDK محرك تحويل سحابي يدعم HTML كمدخل و XLSX كمخرج، مما يلغي الحاجة إلى مكونات Office المحلية. القدرات الرئيسية التي تتوافق مع المتطلبات هي:

  • معالجة سحابية - تتم عملية التحويل الثقيلة على خوادم GroupDocs، وهو مثالي لخادم تحويل HTML إلى XLSX في Java أو لتطبيق ويب Spring Boot.
  • خيارات قابلة للتكوين - يمكنك الحفاظ على التنسيق الأصلي، وتعيين أسماء أوراق العمل، والتحكم في أنواع بيانات الخلايا عبر XlsxConvertOptions.
  • عميل آمن للمتعدد الخيوط - مناسب لتحويل 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 متوافق مع المعايير، مما يجعله مثاليًا لتطبيقات الويب على الخادم، أو المستندة إلى servlet، أو Spring Boot. سواء كنت تبني خادم تحويل مخصص، أو خدمة مصغرة، أو معالج دفعات متعدد الخيوط، فإن نفس API يتوسع لتلبية الحمل. تذكر الحصول على ترخيص مؤقت من صفحة الترخيص المؤقت للتقييم ومراجعة تفاصيل التسعير للاستخدام في الإنتاج. مع الأمثلة البرمجية وcURL في هذا الدليل، يمكنك الآن دمج تصدير HTML إلى XLSX في أي حل Java.

الأسئلة الشائعة

كيف يمكنني إجراء تحويل HTML إلى XLSX في servlet جافا؟
أنشئ servlet يستقبل ملف HTML المرفوع، ويستخدم GroupDocs.Conversion Cloud SDK for Java لاستدعاء convertDocument، ويكتب تدفق XLSX الناتج مرة أخرى إلى استجابة HTTP. عميل SDK الآمن من حيث الخيوط يعمل بشكل جيد داخل حاويات servlet.

هل من الممكن تشغيل تحويل HTML إلى XLSX كخدمة مصغرة في Java؟
نعم. قم بحزم منطق التحويل في تطبيق Spring Boot خفيف الوزن، عرّف نقطة نهاية REST، ودع SDK يتعامل مع تحويل الصيغة الفعلي. هذا النهج يتناسب مع نمط خدمة مصغرة لتحويل HTML إلى XLSX في Java.

هل يمكنني تحويل HTML إلى XLSX في تطبيق Java متعدد الخيوط؟
تم تصميم SDK ليكون آمنًا للخطوط المتعددة، لذا يمكنك تشغيل مهام تحويل متعددة بالتوازي، وهو مفيد لخادم تحويل HTML إلى XLSX عالي الحجم في سيناريوهات Java.

أين يمكنني العثور على مزيد من التفاصيل حول الترخيص لـ GroupDocs.Conversion Cloud SDK for Java؟
قم بزيارة صفحة الترخيص المؤقتة للحصول على مفتاح تجريبي وتحقق من صفحة الأسعار للحصول على خيارات الترخيص الكامل. يتم توفير كلا الرابطين على الصفحة الرئيسية للمنتج.

اقرأ المزيد