Modificare i file Excel programmaticamente è una necessità frequente quando si sviluppano applicazioni Java basate sui dati, specialmente quando è necessario aggiornare report o generare fogli di calcolo dinamici al volo. GroupDocs.Editor Cloud SDK for Java fornisce una potente libreria basata su REST che consente di manipolare cartelle di lavoro XLSX senza doversi occupare di formati di file a basso livello. In questa guida vedrai un esempio completo di codice Java, i comandi cURL equivalenti, i passaggi di installazione e le opzioni di configurazione per integrare la modifica di Excel nei tuoi progetti Java.

Modifica foglio Excel tramite REST in Java - Esempio di codice completo

Il seguente esempio mostra come caricare una cartella di lavoro Excel, apportare modifiche e salvarla nuovamente nello storage utilizzando il 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: Questo esempio di codice dimostra la funzionalità principale. Prima di utilizzarlo nel tuo progetto, assicurati di aggiornare i percorsi dei file (sample.xlsx, output.xlsx), verifica che tutte le dipendenze richieste siano correttamente installate e testa accuratamente nell’ambiente di sviluppo. Se riscontri problemi, consulta la documentazione ufficiale o contatta il team di supporto per assistenza.

Modifica di Excel REST con comandi cURL

Se preferisci un approccio REST puro, la stessa operazione può essere eseguita con cURL. Di seguito sono i passaggi tipici.

  1. Ottieni un token di accesso
    Sostituisci YOUR_CLIENT_ID e YOUR_CLIENT_SECRET con le tue credenziali.
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"
  1. Carica il file XLSX di origine
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
  1. Carica la cartella di lavoro per la modifica
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": {}
         }'
  1. Salva la cartella di lavoro modificata
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": {}
         }'

Per ulteriori dettagli su corpi della richiesta e parametri aggiuntivi, vedere la documentazione ufficiale dell’API.

Comprendere la modifica del foglio Excel tramite REST in codice Java

Di seguito è riportata un’analisi passo‑passo dell’esempio Java:

  1. Configura client API - L’oggetto ApiClient memorizza l’URL di base e le credenziali di autenticazione.
ApiClient apiClient = new ApiClient();
apiClient.setBasePath("https://api.groupdocs.cloud");
apiClient.setAppSid("YOUR_CLIENT_ID");
apiClient.setAppKey("YOUR_CLIENT_SECRET");

  1. Crea l’istanza dell’Editor API - EditorApi fornisce metodi come loadDocument e saveDocument.

    EditorApi editorApi = new EditorApi(apiClient);

  2. Carica la cartella di lavoro Excel - LoadDocumentRequest specifica il nome del file; la risposta contiene informazioni sulla pagina (foglio).

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

  3. Modifica la cartella di lavoro - Per Excel, ogni foglio appare come una pagina. È possibile manipolare la rappresentazione HTML di una pagina o utilizzare altre API di modifica. (L’esempio lascia questa parte come segnaposto.)

  4. Salva il file modificato - SaveDocumentRequest definisce i percorsi di origine e destinazione.

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

Per un elenco completo di classi e proprietà, fare riferimento al riferimento API.

Preparazione dell’ambiente

Aggiungi l’SDK al tuo progetto Maven:

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

Prerequisiti: Java 8 o versioni successive, un account GroupDocs Cloud e credenziali client valide (AppSid e AppKey). Scarica gli ultimi JAR dalla pagina di download.

Configurazione delle opzioni di modifica di Excel

L’SDK consente di regolare finemente il comportamento di caricamento e salvataggio:

  1. Opzioni di caricamento - Controlla se la cartella di lavoro viene aperta in modalità sola lettura.
LoadOptions loadOptions = new LoadOptions();
loadOptions.setReadOnly(false);
  1. Opzioni di salvataggio - Scegli il formato di output (XLSX, CSV, ecc.) e se conservare le formule.
SaveOptions saveOptions = new SaveOptions();
saveOptions.setFormat(SaveOptions.FormatEnum.XLSX);
saveOptions.setPreserveFormulas(true);
  1. Impostazioni di autenticazione - È possibile impostare un timeout personalizzato o un proxy se necessario.
apiClient.setTimeout(120000); // 2 minutes

Queste opzioni vengono passate agli oggetti di richiesta mostrati in precedenza.

Conclusione

Modificare un foglio Excel tramite REST in Java diventa semplice con il GroupDocs.Editor Cloud SDK for Java. L’SDK astrae le chiamate REST, consentendoti di concentrarti sulla logica di business mentre gestisce l’autenticazione, l’archiviazione dei file e le sfumature del formato dietro le quinte. Dopo aver integrato l’esempio di codice, puoi espandere la soluzione per supportare l’elaborazione batch, la personalizzazione dello stile delle cella o la valutazione delle formule. Ricorda di ottenere una licenza adeguata per l’uso in produzione; i dettagli dei prezzi sono disponibili sulla pagina del prodotto, e una licenza di prova temporanea può essere richiesta dalla pagina della licenza temporanea. Inizia ad automatizzare i tuoi flussi di lavoro Excel oggi stesso e aumenta la produttività delle tue applicazioni Java.

FAQ

  • Come posso modificare un foglio Excel tramite REST in Java usando GroupDocs.Editor?
    Utilizza i metodi loadDocument e saveDocument dell’SDK come mostrato nell’esempio di codice. La libreria gestisce la comunicazione REST, quindi lavori solo con oggetti Java.

  • Qual è il metodo di autenticazione richiesto dall’API REST?
    L’API utilizza il flusso OAuth2 client‑credentials. Ottieni un token di accesso con il tuo AppSid e AppKey, quindi includilo nell’intestazione Authorization: Bearer per tutte le chiamate. I dettagli sono nella documentazione ufficiale.

  • Posso modificare più fogli di lavoro in una singola richiesta?
    Sì. Dopo aver caricato la cartella di lavoro, ogni foglio di lavoro appare come una pagina separata nel LoadResult. Itera sulle pagine, applica le modifiche e chiama saveDocument una volta per persistere tutte le modifiche.

  • Dove posso trovare informazioni su prezzi e licenze?
    Visita la pagina principale del prodotto per i piani di abbonamento e la pagina della licenza temporanea per una chiave di prova.

Leggi di più