Das programmgesteuerte Bearbeiten von Excel‑Dateien ist eine häufige Anforderung beim Erstellen datengetriebener Java‑Anwendungen, insbesondere wenn Berichte aktualisiert oder dynamische Tabellenkalkulationen on‑the‑fly generiert werden müssen. GroupDocs.Editor Cloud SDK for Java bietet eine leistungsstarke REST‑basierte Bibliothek, mit der Sie XLSX Arbeitsmappen manipulieren können, ohne sich mit Low‑Level‑Dateiformaten auseinandersetzen zu müssen. In diesem Leitfaden sehen Sie ein vollständiges Java‑Codebeispiel, äquivalente cURL‑Befehle, Installationsschritte und Konfigurationsoptionen, um die Excel‑Bearbeitung in Ihre Java‑Projekte zu integrieren.
Excel-Tabelle über REST in Java bearbeiten - Vollständiges Codebeispiel
Das folgende Beispiel zeigt, wie man eine Excel‑Arbeitsmappe lädt, Änderungen vornimmt und sie wieder im Speicher speichert, indem man das GroupDocs.Editor Cloud SDK for Java verwendet.
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);
}
}
Hinweis: Dieses Codebeispiel demonstriert die Kernfunktionalität. Bevor Sie es in Ihrem Projekt verwenden, stellen Sie sicher, dass Sie die Dateipfade (
sample.xlsx,output.xlsx) aktualisieren, dass alle erforderlichen Abhängigkeiten ordnungsgemäß installiert sind und testen Sie gründlich in Ihrer Entwicklungsumgebung. Wenn Sie auf Probleme stoßen, lesen Sie bitte die offizielle Dokumentation oder wenden Sie sich an das Support-Team für Unterstützung.
Excel-REST-Bearbeitung mit cURL-Befehlen
Wenn Sie einen reinen REST‑Ansatz bevorzugen, kann dieselbe Operation mit cURL durchgeführt werden. Nachfolgend sind die typischen Schritte aufgeführt.
- Ein Zugriffstoken erhalten
Ersetzen SieYOUR_CLIENT_IDundYOUR_CLIENT_SECRETdurch Ihre Anmeldeinformationen.
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"
- Laden Sie die Quell‑XLSX‑Datei hoch
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
- Laden Sie die Arbeitsmappe zur Bearbeitung
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": {}
}'
- Speichern Sie die modifizierte Arbeitsmappe
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": {}
}'
Weitere Details zu Anforderungskörpern und zusätzlichen Parametern finden Sie in der offiziellen API-Dokumentation.
Verstehen der Bearbeitung von Excel-Tabellen über REST in Java-Code
Im Folgenden finden Sie eine schrittweise Aufschlüsselung des Java‑Beispiels:
API-Client konfigurieren - Das
ApiClient-Objekt speichert die Basis-URL und die Authentifizierungsdaten.ApiClient apiClient = new ApiClient(); apiClient.setBasePath("https://api.groupdocs.cloud"); apiClient.setAppSid("YOUR_CLIENT_ID"); apiClient.setAppKey("YOUR_CLIENT_SECRET");Erstellen Sie die Editor-API-Instanz -
EditorApistellt Methoden wieloadDocumentundsaveDocumentbereit.
EditorApi editorApi = new EditorApi(apiClient);
- Laden Sie die Excel‑Arbeitsmappe –
LoadDocumentRequestgibt den Dateinamen an; die Antwort enthält Seiten (Blatt)-Informationen.
LoadDocumentRequest loadRequest = new LoadDocumentRequest("sample.xlsx", null);
LoadResult loadResult = editorApi.loadDocument(loadRequest);
Arbeitsmappe bearbeiten - Für Excel erscheint jedes Blatt als Seite. Sie können die HTML Darstellung einer Seite manipulieren oder andere Bearbeitungs-APIs verwenden. (Das Beispiel lässt diesen Teil als Platzhalter stehen.)
Speichern der geänderten Datei -
SaveDocumentRequestdefiniert die Quell- und Zielpfade.SaveDocumentRequest saveRequest = new SaveDocumentRequest("sample.xlsx", "output.xlsx", null); editorApi.saveDocument(saveRequest);
Für eine vollständige Liste der Klassen und Eigenschaften siehe die API‑Referenz.
Umgebung vorbereiten
Fügen Sie das SDK zu Ihrem Maven‑Projekt hinzu:
<dependency>
<groupId>com.groupdocs</groupId>
<artifactId>groupdocs-editor-cloud</artifactId>
<version>25.7</version>
</dependency>
Voraussetzungen: Java 8 oder höher, ein GroupDocs Cloud‑Konto und gültige Client‑Anmeldeinformationen (AppSid und AppKey). Laden Sie die neuesten JARs von der Download‑Seite herunter.
Excel‑Bearbeitungsoptionen konfigurieren
Das SDK ermöglicht es Ihnen, das Laden und Speichern fein abzustimmen:
- Ladeoptionen - Steuern Sie, ob die Arbeitsmappe im Nur‑Lese‑Modus geöffnet wird.
LoadOptions loadOptions = new LoadOptions();
loadOptions.setReadOnly(false);
- Speicheroptionen - Wählen Sie das Ausgabeformat (XLSX, CSV, usw.) und ob Formeln beibehalten werden sollen.
SaveOptions saveOptions = new SaveOptions();
saveOptions.setFormat(SaveOptions.FormatEnum.XLSX);
saveOptions.setPreserveFormulas(true);
- Authentifizierungseinstellungen - Sie können bei Bedarf eine benutzerdefinierte Zeitüberschreitung oder einen Proxy festlegen.
apiClient.setTimeout(120000); // 2 minutes
Diese Optionen werden an die zuvor gezeigten Request‑Objekte übergeben.
Fazit
Das Bearbeiten eines Excel‑Blatts über REST in Java wird mit dem GroupDocs.Editor Cloud SDK for Java unkompliziert. Das SDK abstrahiert die REST‑Aufrufe, sodass Sie sich auf die Geschäftslogik konzentrieren können, während Authentifizierung, Dateispeicherung und Formatdetails im Hintergrund gehandhabt werden. Nach der Integration des Codebeispiels können Sie die Lösung erweitern, um Batch‑Verarbeitung, benutzerdefiniertes Zelle Styling oder Formelauswertung zu unterstützen. Denken Sie daran, für den Produktionseinsatz eine gültige Lizenz zu erwerben; Preisinformationen finden Sie auf der Produktseite, und eine temporäre Testlizenz kann über die temporäre Lizenzseite angefordert werden. Beginnen Sie noch heute mit der Automatisierung Ihrer Excel‑Workflows und steigern Sie die Produktivität Ihrer Java‑Anwendungen.
FAQs
Wie kann ich ein Excel‑Blatt über REST in Java mit GroupDocs.Editor bearbeiten?
Verwenden Sie dieloadDocument‑ undsaveDocument‑Methoden des SDK, wie im Codebeispiel gezeigt. Die Bibliothek übernimmt die REST‑Kommunikation, sodass Sie nur mit Java‑Objekten arbeiten.Welche Authentifizierungsmethode erfordert die REST-API?
Die API verwendet den OAuth2‑Client‑Credentials‑Flow. Holen Sie ein Zugriffstoken mit IhremAppSidundAppKeyund fügen Sie es anschließend in den HeaderAuthorization: Bearerfür alle Aufrufe ein. Einzelheiten finden Sie in der offiziellen Dokumentation.Kann ich mehrere Arbeitsblätter in einer einzigen Anfrage bearbeiten?
Ja. Nach dem Laden der Arbeitsmappe erscheint jedes Arbeitsblatt als separate Seite imLoadResult. Durchlaufen Sie die Seiten, wenden Sie Änderungen an und rufen Sie einmalsaveDocumentauf, um alle Änderungen zu speichern.Wo finde ich Preis- und Lizenzinformationen?
Besuchen Sie die Hauptseite des Produkts für Abonnementpläne und die temporäre Lizenzseite für einen Testschlüssel.