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

FAQs

• Как отредактировать лист 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