Editar planilha Excel via REST em Java - Exemplo de código completo

O exemplo a seguir mostra como carregar uma pasta de trabalho do Excel, fazer alterações e salvá‑la de volta no armazenamento usando o 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);
    }
}

Nota: Este exemplo de código demonstra a funcionalidade principal. Antes de usá‑lo em seu projeto, certifique‑se de atualizar os caminhos dos arquivos (sample.xlsx, output.xlsx), verifique se todas as dependências necessárias estão devidamente instaladas e teste minuciosamente em seu ambiente de desenvolvimento. Se encontrar algum problema, consulte a documentação oficial ou entre em contato com a equipe de suporte para obter assistência.

Edição de Excel via REST com comandos cURL

Se você preferir uma abordagem REST pura, a mesma operação pode ser realizada com cURL. Abaixo estão as etapas típicas.

1. Obtenha um token de acesso
   Substitua YOUR_CLIENT_ID e YOUR_CLIENT_SECRET pelas suas credenciais.

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. Carregue o arquivo XLSX de origem

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. Carregar a pasta de trabalho para edição

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. Salvar a pasta de trabalho modificada

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": {}
         }'

Para mais detalhes sobre os corpos de requisição e parâmetros adicionais, veja a documentação oficial da API.

Entendendo a Edição de Planilha Excel via REST em Código Java

A seguir, uma análise passo a passo do exemplo em Java:

1. Configurar cliente API - O objeto ApiClient armazena a URL base e as credenciais de autenticação.

   ApiClient apiClient = new ApiClient();
   apiClient.setBasePath("https://api.groupdocs.cloud");
   apiClient.setAppSid("YOUR_CLIENT_ID");
   apiClient.setAppKey("YOUR_CLIENT_SECRET");
   

2. Criar a instância da API do Editor - EditorApi fornece métodos como loadDocument e saveDocument.

   EditorApi editorApi = new EditorApi(apiClient);
   

3. Carregar a pasta de trabalho do Excel - LoadDocumentRequest especifica o nome do arquivo; a resposta contém informações da página (planilha).

   LoadDocumentRequest loadRequest = new LoadDocumentRequest("sample.xlsx", null);
   LoadResult loadResult = editorApi.loadDocument(loadRequest);
   

4. Editar a pasta de trabalho - Para Excel, cada planilha aparece como uma página. Você pode manipular a representação HTML de uma página ou usar outras APIs de edição. (O exemplo deixa esta parte como um espaço reservado.)

5. Salvar o arquivo modificado - SaveDocumentRequest define os caminhos de origem e destino.

   SaveDocumentRequest saveRequest = new SaveDocumentRequest("sample.xlsx", "output.xlsx", null);
   editorApi.saveDocument(saveRequest);
   

Para obter uma lista completa de classes e propriedades, consulte a referência da API.

Preparando o Ambiente

Adicione o SDK ao seu projeto Maven:

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-editor-cloud</artifactId>
    <version>25.7</version>
</dependency>

Pré-requisitos: Java 8 ou superior, uma conta GroupDocs Cloud e credenciais de cliente válidas (AppSid e AppKey). Baixe os JARs mais recentes na página de download.

Configurando Opções de Edição do Excel

O SDK permite que você ajuste finamente o comportamento de carregamento e salvamento:

1. Load options - Controle se a pasta de trabalho é aberta no modo somente‑leitura.

LoadOptions loadOptions = new LoadOptions();
loadOptions.setReadOnly(false);

2. Opções de salvamento - Escolha o formato de saída (XLSX, CSV, etc.) e se deve preservar as fórmulas.

SaveOptions saveOptions = new SaveOptions();
saveOptions.setFormat(SaveOptions.FormatEnum.XLSX);
saveOptions.setPreserveFormulas(true);

3. Configurações de autenticação - Você pode definir um tempo limite personalizado ou proxy, se necessário.

apiClient.setTimeout(120000); // 2 minutes

Essas opções são passadas para os objetos de solicitação mostrados anteriormente.

Conclusão

Editar uma planilha Excel via REST em Java torna‑se simples com o GroupDocs.Editor Cloud SDK for Java. O SDK abstrai as chamadas REST, permitindo que você se concentre na lógica de negócios enquanto lida com autenticação, armazenamento de arquivos e nuances de formato nos bastidores. Após integrar o exemplo de código, você pode expandir a solução para suportar processamento em lote, estilo personalizado de cell ou avaliação de fórmulas. Lembre‑se de obter uma licença adequada para uso em produção; detalhes de preços estão disponíveis na página do produto, e uma licença de teste temporária pode ser solicitada na temporary license page. Comece a automatizar seus fluxos de trabalho Excel hoje e aumente a produtividade em suas aplicações Java.

Perguntas Frequentes

• Como posso editar uma planilha Excel via REST em Java usando GroupDocs.Editor?
  Use os métodos loadDocument e saveDocument do SDK conforme mostrado no exemplo de código. A biblioteca lida com a comunicação REST, portanto você trabalha apenas com objetos Java.

• Qual método de autenticação a API REST requer?
  A API usa o fluxo de credenciais de cliente OAuth2. Obtenha um token de acesso com seu AppSid e AppKey, então inclua‑o no cabeçalho Authorization: Bearer em todas as chamadas. Detalhes estão na documentação oficial.

• Posso editar várias planilhas em uma única solicitação?
  Sim. Após carregar a pasta de trabalho, cada planilha aparece como uma página separada no LoadResult. Percorra as páginas, aplique as alterações e chame saveDocument uma vez para persistir todas as edições.

• Onde posso encontrar informações de preços e licenciamento?
  Visite a página principal do produto para planos de assinatura e a página de licença temporária para obter uma chave de avaliação.

Leia Mais

• Editar arquivos PowerPoint usando biblioteca Java
• Editar documentos Word ou Excel usando API REST
• Editar planilha Excel usando API REST em Python