Редагування листа 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 client - Об’єкт 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 сторінки або використовувати інші 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‑файли зі сторінки завантаження.

Налаштування параметрів редагування 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‑виклики, дозволяючи зосередитися на бізнес‑логіці, одночасно обробляючи автентифікацію, зберігання файлів та нюанси форматів у фоні. Після інтеграції прикладу коду ви можете розширити рішення, щоб підтримувати пакетну обробку, кастомне оформлення cell або оцінку формул. Не забудьте отримати належну ліцензію для використання у продакшн‑середовищі; деталі цін доступні на сторінці продукту, а тимчасову пробну ліцензію можна запросити на сторінка тимчасової ліцензії. Почніть автоматизувати ваші Excel‑процеси вже сьогодні та підвищити продуктивність у ваших Java‑додатках.

Питання та відповіді

• Як можна редагувати лист Excel через REST у Java за допомогою GroupDocs.Editor?
  Використовуйте методи loadDocument та saveDocument SDK, як показано у прикладі коду. Бібліотека обробляє REST‑комунікацію, тому ви працюєте лише з об’єктами Java.

• Який метод автентифікації вимагає REST API?
  API використовує потік OAuth2 client‑credentials. Отримайте токен доступу за допомогою вашого AppSid та AppKey, потім включіть його у заголовок Authorization: Bearer для всіх викликів. Деталі наведено в офіційній документації.

• Чи можу я редагувати кілька робочих листів в одному запиті?
  Так. Після завантаження книги, кожен робочий лист відображається як окрема сторінка в LoadResult. Пройдіться по сторінках, застосуйте зміни та викличте saveDocument один раз, щоб зберегти всі правки.

• Де я можу знайти інформацію про ціни та ліцензування?
  Відвідайте головну сторінку продукту для планів підписки та сторінку тимчасової ліцензії для отримання пробного ключа.

Читати далі

• Редагування файлів PowerPoint за допомогою Java-бібліотеки
• Редагування документів Word або Excel за допомогою REST API
• Редагування листа Excel за допомогою REST API у Python