Редагування листа Excel за допомогою REST у Java

Редагування файлів Excel програмно є частою вимогою при створенні орієнтованих на дані Java‑додатків, особливо коли потрібно оновлювати звіти або генерувати динамічні електронні таблиці «на льоту». GroupDocs.Editor Cloud SDK for Java надає потужну бібліотеку на базі REST, яка дозволяє маніпулювати робочими книгами XLSX без роботи з низькорівневими форматами файлів. У цьому посібнику ви побачите повний приклад коду Java, еквівалентні команди cURL, кроки встановлення та параметри конфігурації для інтеграції редагування Excel у ваші Java‑проекти.

Редагування листа 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