ویرایش برگه 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) به‌روز شده‌اند، تأیید کنید تمام وابستگی‌های مورد نیاز به‌درستی نصب شده‌اند و به‌طور کامل در محیط توسعه خود تست کنید. اگر با مشکلی مواجه شدید، لطفاً به مستندات رسمی مراجعه کنید یا برای دریافت کمک به تیم پشتیبانی مراجعه نمایید.

ویرایش 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 مراجعه کنید.

درک ویرایش شیت اکسل از طریق REST در کد جاوا

در زیر تجزیه و تحلیل گام به گام مثال Java آورده شده است:

1. پیکربندی کلاینت API - شی ApiClient آدرس پایه و اعتبارهای احراز هویت را ذخیره می‌کند.

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 یک صفحه را دستکاری کنید یا از APIهای ویرایشی دیگر استفاده کنید. (این نمونه این بخش را به عنوان یک جایگزین نگه می‌دارد.)

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ها را از صفحه دانلود دریافت کنید.

پیکربندی گزینه‌های ویرایش اکسل

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 ویرایش کنم؟
  از متدهای loadDocument و saveDocument SDK همان‌طور که در مثال کد نشان داده شده استفاده کنید. کتابخانه ارتباط REST را مدیریت می‌کند، بنابراین فقط با اشیاء Java کار می‌کنید.

• روش احراز هویت مورد نیاز API REST چیست؟
  API از جریان OAuth2 client‑credentials استفاده می‌کند. یک توکن دسترسی با AppSid و AppKey خود دریافت کنید، سپس آن را در هدر Authorization: Bearer برای تمام درخواست‌ها گنجانید. جزئیات در مستندات رسمی موجود است.

• آیا می‌توانم چندین برگه کاری را در یک درخواست ویرایش کنم؟
  بله. پس از بارگذاری کتاب‌کار، هر برگه کاری به‌عنوان یک صفحه جداگانه در LoadResult ظاهر می‌شود. بر روی صفحات تکرار کنید، تغییرات را اعمال کنید، و یک‌بار saveDocument را فراخوانی کنید تا تمام ویرایش‌ها ذخیره شوند.

• کجا می‌توانم اطلاعات قیمت‌گذاری و مجوزها را پیدا کنم؟
  صفحه اصلی محصول را برای برنامه‌های اشتراک مشاهده کنید و برای دریافت کلید آزمایشی به صفحه مجوز موقت مراجعه کنید.

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

• ویرایش فایل‌های PowerPoint با استفاده از کتابخانه Java
• ویرایش اسناد Word یا Excel با استفاده از REST API
• ویرایش شیت Excel با استفاده از REST API در Python