La modification programmatique de fichiers Excel est une exigence fréquente lors de la création d’applications Java basées sur les données, en particulier lorsqu’il faut mettre à jour des rapports ou générer des feuilles de calcul dynamiques à la volée. GroupDocs.Editor Cloud SDK for Java fournit une bibliothèque puissante basée sur REST qui vous permet de manipuler les classeurs XLSX sans avoir à gérer les formats de fichiers de bas niveau. Dans ce guide, vous verrez un exemple complet de code Java, des commandes cURL équivalentes, les étapes d’installation et les options de configuration pour intégrer l’édition d’Excel dans vos projets Java.
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.
- Obtenir un jeton d’accès
RemplacezYOUR_CLIENT_IDetYOUR_CLIENT_SECRETpar 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"
- 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
- 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": {}
}'
- 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 :
- Configurer le client API - L’objet
ApiClientstocke 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");
- Créer l’instance Editor API -
EditorApifournit des méthodes telles queloadDocumentetsaveDocument.
EditorApi editorApi = new EditorApi(apiClient);
- Charger le classeur Excel -
LoadDocumentRequestspé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);
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é.)
Enregistrer le fichier modifié -
SaveDocumentRequestdé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 :
- Options de chargement - Contrôlez si le classeur est ouvert en mode lecture seule.
LoadOptions loadOptions = new LoadOptions();
loadOptions.setReadOnly(false);
- 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);
- 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éthodesloadDocumentetsaveDocumentdu 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 votreAppSidetAppKey, puis incluez‑le dans l’en‑têteAuthorization: Bearerpour 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 leLoadResult. Parcourez les pages, appliquez les modifications et appelezsaveDocumentune 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.