Modifier une feuille Excel via REST en Java - Exemple de code complet

L’exemple suivant montre comment charger un classeur Excel, apporter des modifications et l’enregistrer à nouveau dans le stockage en utilisant le 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);
    }
}

Remarque : Cet exemple de code démontre la fonctionnalité principale. Avant de l’utiliser dans votre projet, assurez‑vous de mettre à jour les chemins de fichiers (sample.xlsx, output.xlsx), vérifiez que toutes les dépendances requises sont correctement installées et testez soigneusement dans votre environnement de développement. Si vous rencontrez des problèmes, veuillez consulter la documentation officielle ou contacter l’équipe de support pour obtenir de l’aide.

Modification d’Excel via REST avec des commandes cURL

Si vous préférez une approche REST pure, la même opération peut être effectuée avec cURL. Voici les étapes typiques.

1. Obtenir un jeton d’accès
   Remplacez YOUR_CLIENT_ID et YOUR_CLIENT_SECRET par vos informations d’identification.

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. Téléverser le fichier XLSX source

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. Charger le classeur pour l’édition

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. Enregistrer le classeur modifié

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

Pour plus de détails sur les corps de requête et les paramètres supplémentaires, consultez la documentation officielle de l’API.

Comprendre la modification d’une feuille Excel via REST en code Java

Voici une analyse étape par étape de l’exemple Java :

1. Configurer le client API - L’objet ApiClient stocke l’URL de base et les informations d’authentification.

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

2. Créer l’instance Editor API - EditorApi fournit des méthodes telles que loadDocument et saveDocument.

EditorApi editorApi = new EditorApi(apiClient);

3. Charger le classeur Excel - LoadDocumentRequest spécifie le nom du fichier ; la réponse contient les informations de page (feuille).

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

4. Modifier le classeur - Pour Excel, chaque feuille apparaît comme une page. Vous pouvez manipuler la représentation HTML d’une page ou utiliser d’autres API d’édition. (L’exemple laisse cette partie comme un espace réservé.)

5. Enregistrer le fichier modifié - SaveDocumentRequest définit les chemins source et cible.

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

Pour une liste complète des classes et des propriétés, consultez la référence API.

Préparer l’environnement

Ajoutez le SDK à votre projet Maven:

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

Prérequis : Java 8 ou version supérieure, un compte GroupDocs Cloud et des informations d’identification client valides (AppSid et AppKey). Téléchargez les derniers JAR depuis la page de téléchargement.

Configuration des options d’édition Excel

Le SDK vous permet d’ajuster finement le comportement de chargement et d’enregistrement :

1. Options de chargement - Contrôlez si le classeur est ouvert en mode lecture seule.

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

2. Options d’enregistrement - Choisissez le format de sortie (XLSX, CSV, etc.) et indiquez si vous souhaitez conserver les formules.

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

3. Paramètres d’authentification - Vous pouvez définir un délai d’attente personnalisé ou un proxy si nécessaire.

apiClient.setTimeout(120000); // 2 minutes

Ces options sont transmises aux objets de requête présentés précédemment.

Conclusion

Modifier une feuille Excel via REST en Java devient simple avec le GroupDocs.Editor Cloud SDK for Java. Le SDK abstrait les appels REST, vous permettant de vous concentrer sur la logique métier tout en gérant l’authentification, le stockage des fichiers et les particularités de format en arrière-plan. Après avoir intégré l’exemple de code, vous pouvez étendre la solution pour prendre en charge le traitement par lots, la mise en forme personnalisée des cellule ou l’évaluation de formules. N’oubliez pas d’obtenir une licence appropriée pour une utilisation en production ; les détails tarifaires sont disponibles sur la page du produit, et une licence d’essai temporaire peut être demandée depuis la page de licence temporaire. Commencez dès aujourd’hui à automatiser vos flux de travail Excel et augmentez la productivité de vos applications Java.

FAQs

• Comment puis‑je modifier une feuille Excel via REST en Java en utilisant GroupDocs.Editor ?
  Utilisez les méthodes loadDocument et saveDocument du SDK comme indiqué dans l’exemple de code. La bibliothèque gère la communication REST, vous ne travaillez donc qu’avec des objets Java.

• Quelle méthode d’authentification l’API REST nécessite-t-elle ?
  L’API utilise le flux OAuth2 client‑credentials. Obtenez un jeton d’accès avec votre AppSid et AppKey, puis incluez‑le dans l’en‑tête Authorization: Bearer pour tous les appels. Les détails sont dans la documentation officielle.

• Puis-je modifier plusieurs feuilles de calcul dans une seule requête ?
  Oui. Après le chargement du classeur, chaque feuille de calcul apparaît comme une page distincte dans le LoadResult. Parcourez les pages, appliquez les modifications et appelez saveDocument une fois pour enregistrer toutes les modifications.

• Où puis‑je trouver les informations de tarification et de licence ?
  Visitez la page principale du produit pour les plans d’abonnement et la page de licence temporaire pour une clé d’essai.

En savoir plus

• Modifier des fichiers PowerPoint à l’aide de la bibliothèque Java
• Modifier des documents Word ou Excel via l’API REST
• Modifier une feuille Excel via l’API REST en Python