تحرير ورقة Excel عبر REST في Java - مثال كامل للكود

يوضح المثال التالي كيفية تحميل مصنف Excel، وإجراء التغييرات، وحفظه مرة أخرى في التخزين باستخدام GroupDocs.Editor Cloud SDK for Java.

import com.groupdocs.cloud.editor.api.*;
import com.groupdocs.cloud.editor.client.*;
import com.groupdocs.cloud.editor.model.*;
import com.groupdocs.cloud.editor.model.requests.*;

public class EditDocument {
    public static void main(String[] args) {
        // Configure API client
        ApiClient apiClient = new ApiClient();
        apiClient.setBasePath("https://api.groupdocs.cloud");
        apiClient.setAppSid("YOUR_CLIENT_ID");
        apiClient.setAppKey("YOUR_CLIENT_SECRET");

// Create EditorApi instance
        EditorApi editorApi = new EditorApi(apiClient);

// Load document
        LoadDocumentRequest loadRequest = new LoadDocumentRequest("sample.xlsx", null);
        LoadResult loadResult = editorApi.loadDocument(loadRequest);

// Get document pages (for Excel, each sheet is a page)
        // Edit cell via editing HTML? Not sure.

// Save document
        SaveDocumentRequest saveRequest = new SaveDocumentRequest("sample.xlsx", "output.xlsx", null);
        editorApi.saveDocument(saveRequest);
    }
}

ملاحظة: يوضح مثال الشيفرة هذا الوظيفة الأساسية. قبل استخدامه في مشروعك، تأكد من تحديث مسارات الملفات (sample.xlsx, output.xlsx)، والتحقق من أن جميع الاعتمادات المطلوبة مثبتة بشكل صحيح، واختبر بدقة في بيئة التطوير الخاصة بك. إذا واجهت أي مشكلات، يرجى الرجوع إلى الوثائق الرسمية أو التواصل مع فريق الدعم للحصول على المساعدة.

تحرير Excel عبر REST باستخدام أوامر cURL

إذا كنت تفضل نهج REST النقي، يمكن تنفيذ العملية نفسها باستخدام cURL. فيما يلي الخطوات النموذجية.

1. الحصول على رمز وصول
   استبدل YOUR_CLIENT_ID و YOUR_CLIENT_SECRET ببيانات الاعتماد الخاصة بك.

curl -X POST "https://api.groupdocs.cloud/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"

2. تحميل ملف XLSX المصدر

curl -X PUT "https://api.groupdocs.cloud/v2.0/editor/storage/file/sample.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" \
     --data-binary @sample.xlsx

3. تحميل دفتر العمل للتعديل

curl -X POST "https://api.groupdocs.cloud/v2.0/editor/load" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "filePath": "sample.xlsx",
           "loadOptions": {}
         }'

4. احفظ المصنف المعدل

curl -X POST "https://api.groupdocs.cloud/v2.0/editor/save" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "filePath": "sample.xlsx",
           "outputPath": "output.xlsx",
           "saveOptions": {}
         }'

لمزيد من التفاصيل حول جسم الطلب والمعلمات الإضافية، راجع وثائق API الرسمية.

فهم تعديل ورقة Excel عبر REST في كود Java

فيما يلي تفصيل خطوة بخطوة لمثال Java:

1. تكوين عميل API - كائن ApiClient يخزن عنوان URL الأساسي وبيانات الاعتماد للمصادقة.

ApiClient apiClient = new ApiClient();
apiClient.setBasePath("https://api.groupdocs.cloud");
apiClient.setAppSid("YOUR_CLIENT_ID");
apiClient.setAppKey("YOUR_CLIENT_SECRET");

2. إنشاء مثيل Editor API - EditorApi يوفر طرقًا مثل loadDocument و saveDocument.

EditorApi editorApi = new EditorApi(apiClient);

3. تحميل دفتر عمل Excel - LoadDocumentRequest يحدد اسم الملف؛ الاستجابة تحتوي على معلومات الصفحة (الورقة).

LoadDocumentRequest loadRequest = new LoadDocumentRequest("sample.xlsx", null);
LoadResult loadResult = editorApi.loadDocument(loadRequest);

4. تحرير دفتر العمل - بالنسبة إلى Excel، كل ورقة تظهر كصفحة. يمكنك تعديل تمثيل HTML لصفحة أو استخدام واجهات برمجة تطبيقات تحرير أخرى. (العينة تترك هذا الجزء كعنصر نائب.)

5. حفظ الملف المعدل - SaveDocumentRequest يحدد مسارات المصدر والهدف.

SaveDocumentRequest saveRequest = new SaveDocumentRequest("sample.xlsx", "output.xlsx", null);
editorApi.saveDocument(saveRequest);

للحصول على قائمة كاملة بالفئات والخصائص، راجع مرجع API.

إعداد البيئة

أضف SDK إلى مشروع Maven الخاص بك:

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-editor-cloud</artifactId>
    <version>25.7</version>
</dependency>

المتطلبات المسبقة: Java 8 أو أعلى، حساب GroupDocs Cloud، واعتمادات عميل صالحة (AppSid و AppKey). قم بتنزيل أحدث ملفات JAR من صفحة التنزيل.

تكوين خيارات تحرير Excel

تتيح لك SDK ضبط سلوك التحميل والحفظ بدقة:

1. خيارات التحميل - التحكم فيما إذا كان دفتر العمل يُفتح في وضع القراءة فقط.

LoadOptions loadOptions = new LoadOptions();
loadOptions.setReadOnly(false);

2. خيارات الحفظ - اختر تنسيق الإخراج (XLSX، CSV، إلخ) وما إذا كنت تريد الحفاظ على الصيغ.

SaveOptions saveOptions = new SaveOptions();
saveOptions.setFormat(SaveOptions.FormatEnum.XLSX);
saveOptions.setPreserveFormulas(true);

3. إعدادات المصادقة - يمكنك تعيين مهلة مخصصة أو وكيل إذا لزم الأمر.

apiClient.setTimeout(120000); // 2 minutes

يتم تمرير هذه الخيارات إلى كائنات الطلب المعروضة سابقًا.

الخلاصة

تحرير ورقة Excel عبر REST في Java يصبح بسيطًا باستخدام GroupDocs.Editor Cloud SDK for Java. يقوم الـ SDK بتجريد استدعاءات REST، مما يتيح لك التركيز على منطق الأعمال بينما يتعامل مع المصادقة وتخزين الملفات وفروق الصيغ في الخلفية. بعد دمج مثال الشيفرة، يمكنك توسيع الحل لدعم المعالجة الدفعية، وتنسيق الخلية المخصص، أو تقييم الصيغ. تذكر الحصول على ترخيص صحيح للاستخدام في الإنتاج؛ تفاصيل التسعير متوفرة على صفحة المنتج، ويمكن طلب ترخيص تجريبي مؤقت من صفحة الترخيص المؤقت. ابدأ بأتمتة سير عمل Excel اليوم وزد الإنتاجية عبر تطبيقات Java الخاصة بك.

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

• كيف يمكنني تعديل ورقة Excel عبر REST في Java باستخدام GroupDocs.Editor؟
  استخدم طرق SDK loadDocument و saveDocument كما هو موضح في مثال الشيفرة. تتولى المكتبة التعامل مع التواصل عبر REST، لذا تتعامل فقط مع كائنات Java.

• ما طريقة المصادقة التي يتطلبها REST API؟
  يستخدم API تدفق OAuth2 client‑credentials. احصل على رمز وصول باستخدام AppSid و AppKey، ثم أدرجه في رأس Authorization: Bearer لجميع الاستدعاءات. التفاصيل موجودة في الوثائق الرسمية.

• هل يمكنني تعديل أوراق عمل متعددة في طلب واحد؟
  نعم. بعد تحميل دفتر العمل، تظهر كل ورقة عمل كصفحة منفصلة في LoadResult. قم بالتكرار عبر الصفحات، تطبيق التغييرات، واستدعِ saveDocument مرة واحدة لحفظ جميع التعديلات.

• أين يمكنني العثور على معلومات التسعير والترخيص؟
  قم بزيارة الصفحة الرئيسية للمنتج للحصول على خطط الاشتراك وصفحة الترخيص المؤقتة للحصول على مفتاح تجريبي.

اقرأ المزيد

• تحرير ملفات PowerPoint باستخدام مكتبة Java
• تحرير مستندات Word أو Excel باستخدام REST API
• تحرير ورقة Excel باستخدام REST API في Python