Редактирование файлов 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. Ниже приведены типичные шаги.
- Получить токен доступа
Замените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"
- Загрузите исходный файл 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
- Загрузить книгу для редактирования
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": {}
}'
- Сохранить измененную рабочую книгу
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:
Настройка API‑клиента – Объект
ApiClientхранит базовый URL и учетные данные для аутентификации.ApiClient apiClient = new ApiClient(); apiClient.setBasePath("https://api.groupdocs.cloud"); apiClient.setAppSid("YOUR_CLIENT_ID"); apiClient.setAppKey("YOUR_CLIENT_SECRET");Создайте экземпляр Editor API -
EditorApiпредоставляет методы, такие какloadDocumentиsaveDocument.EditorApi editorApi = new EditorApi(apiClient);Загрузить книгу Excel -
LoadDocumentRequestуказывает имя файла; ответ содержит информацию о страницах (листах).
LoadDocumentRequest loadRequest = new LoadDocumentRequest("sample.xlsx", null);
LoadResult loadResult = editorApi.loadDocument(loadRequest);
Редактировать книгу - Для Excel каждый лист отображается как страница. Вы можете манипулировать представлением HTML страницы или использовать другие API редактирования. (В примере эта часть оставлена как заполнитель.)
Сохранить измененный файл -
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 позволяет точно настраивать поведение при загрузке и сохранении:
- Параметры загрузки - Управляйте тем, открывается ли рабочая книга в режиме только для чтения.
LoadOptions loadOptions = new LoadOptions();
loadOptions.setReadOnly(false);
- Параметры сохранения - Выберите формат вывода (XLSX, CSV, и т.д.) и укажите, сохранять ли формулы.
SaveOptions saveOptions = new SaveOptions();
saveOptions.setFormat(SaveOptions.FormatEnum.XLSX);
saveOptions.setPreserveFormulas(true);
- Настройки аутентификации - При необходимости вы можете установить пользовательский тайм-аут или прокси.
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иsaveDocumentSDK, как показано в примере кода. Библиотека обрабатывает REST‑коммуникацию, поэтому вы работаете только с объектами Java.Какой метод аутентификации требуется для REST API?
API использует поток OAuth2 client‑credentials. Получите токен доступа с помощью вашихAppSidиAppKey, затем включите его в заголовокAuthorization: Bearerдля всех вызовов. Подробности находятся в официальной документации.Могу ли я редактировать несколько листов в одном запросе?
Да. После загрузки рабочей книги каждый лист появляется как отдельная страница вLoadResult. Пройдите по страницам, примените изменения и вызовитеsaveDocumentодин раз, чтобы сохранить все правки.Где я могу найти информацию о ценах и лицензировании?
Посетите главную страницу продукта для планов подписки и страницу временной лицензии для пробного ключа.