Edycja plików Excel programowo jest częstym wymogiem przy tworzeniu aplikacji Java opartych na danych, szczególnie gdy trzeba aktualizować raporty lub generować dynamiczne arkusze kalkulacyjne w locie. GroupDocs.Editor Cloud SDK for Java zapewnia potężną bibliotekę opartą na REST, która pozwala manipulować skoroszytami XLSX bez konieczności zajmowania się niskopoziomowymi formatami plików. W tym przewodniku zobaczysz kompletny przykład kodu Java, równoważne polecenia cURL, kroki instalacji oraz opcje konfiguracji, aby zintegrować edycję Excel w swoich projektach Java.
Edytowanie arkusza Excel za pomocą REST w Javie - Pełny przykład kodu
Poniższy przykład pokazuje, jak załadować skoroszyt Excel, wprowadzić zmiany i zapisać go z powrotem w magazynie przy użyciu 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);
}
}
Uwaga: Ten przykład kodu demonstruje podstawową funkcjonalność. Przed użyciem w swoim projekcie upewnij się, że zaktualizowałeś ścieżki do plików (
sample.xlsx,output.xlsx), sprawdziłeś, czy wszystkie wymagane zależności są poprawnie zainstalowane, oraz dokładnie przetestowałeś w środowisku deweloperskim. Jeśli napotkasz jakiekolwiek problemy, odwołaj się do oficjalnej dokumentacji lub skontaktuj się z zespołem wsparcia w celu uzyskania pomocy.
Edycja Excel REST przy użyciu poleceń cURL
Jeśli wolisz czyste podejście REST, tę samą operację można wykonać przy użyciu cURL. Poniżej znajdują się typowe kroki.
- Uzyskaj token dostępu
ZastąpYOUR_CLIENT_IDiYOUR_CLIENT_SECRETswoimi danymi uwierzytelniającymi.
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"
- Prześlij plik źródłowy XLSX
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
- Załaduj skoroszyt do edycji
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": {}
}'
- Zapisz zmodyfikowany skoroszyt
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": {}
}'
Aby uzyskać więcej informacji o ciałach żądań i dodatkowych parametrach, zobacz oficjalną dokumentację API.
Zrozumienie edycji arkusza Excel za pomocą REST w kodzie Java
Poniżej znajduje się szczegółowy opis przykładu w języku Java:
Skonfiguruj klienta API - Obiekt
ApiClientprzechowuje podstawowy adres URL i dane uwierzytelniające.ApiClient apiClient = new ApiClient(); apiClient.setBasePath("https://api.groupdocs.cloud"); apiClient.setAppSid("YOUR_CLIENT_ID"); apiClient.setAppKey("YOUR_CLIENT_SECRET");Utwórz instancję Editor API -
EditorApiudostępnia metody takie jakloadDocumentisaveDocument.
EditorApi editorApi = new EditorApi(apiClient);
- Załaduj skoroszyt Excel -
LoadDocumentRequestokreśla nazwę pliku; odpowiedź zawiera informacje o stronie (arkuszu).
LoadDocumentRequest loadRequest = new LoadDocumentRequest("sample.xlsx", null);
LoadResult loadResult = editorApi.loadDocument(loadRequest);
Edytuj skoroszyt - W przypadku Excela każdy arkusz wyświetlany jest jako strona. Możesz manipulować reprezentacją HTML strony lub używać innych interfejsów API edycji. (Przykład pozostawia tę część jako placeholder.)
Zapisz zmodyfikowany plik -
SaveDocumentRequestokreśla ścieżki źródłową i docelową.
SaveDocumentRequest saveRequest = new SaveDocumentRequest("sample.xlsx", "output.xlsx", null);
editorApi.saveDocument(saveRequest);
Aby uzyskać pełną listę klas i właściwości, odwołaj się do referencji API.
Przygotowanie środowiska
Dodaj SDK do swojego projektu Maven:
<dependency>
<groupId>com.groupdocs</groupId>
<artifactId>groupdocs-editor-cloud</artifactId>
<version>25.7</version>
</dependency>
Wymagania wstępne: Java 8 lub nowszy, konto GroupDocs Cloud oraz prawidłowe poświadczenia klienta (AppSid i AppKey). Pobierz najnowsze pliki JAR ze strony pobierania.
Konfigurowanie opcji edycji Excela
SDK pozwala precyzyjnie dostosować zachowanie podczas ładowania i zapisywania:
- Opcje ładowania - Kontroluj, czy skoroszyt jest otwierany w trybie tylko do odczytu.
LoadOptions loadOptions = new LoadOptions();
loadOptions.setReadOnly(false);
- Opcje zapisu - Wybierz format wyjściowy (XLSX, CSV, itp.) oraz czy zachować formuły.
SaveOptions saveOptions = new SaveOptions();
saveOptions.setFormat(SaveOptions.FormatEnum.XLSX);
saveOptions.setPreserveFormulas(true);
- Ustawienia uwierzytelniania - Możesz ustawić niestandardowy limit czasu lub proxy, jeśli jest to wymagane.
apiClient.setTimeout(120000); // 2 minutes
Te opcje są przekazywane do obiektów żądania pokazanych wcześniej.
Podsumowanie
Edycja arkusza Excel za pośrednictwem REST w Javie staje się prosta dzięki GroupDocs.Editor Cloud SDK for Java. SDK abstrahuje wywołania REST, pozwalając skupić się na logice biznesowej, jednocześnie obsługując uwierzytelnianie, przechowywanie plików i niuanse formatów w tle. Po zintegrowaniu przykładu kodu możesz rozszerzyć rozwiązanie o obsługę przetwarzania wsadowego, niestandardowego stylu komórka, lub ocenę formuł. Pamiętaj, aby uzyskać odpowiednią licencję do użytku produkcyjnego; szczegóły cenowe są dostępne na stronie produktu, a tymczasową licencję próbną można zamówić na strona tymczasowej licencji. Rozpocznij automatyzację swoich przepływów pracy w Excelu już dziś i zwiększ wydajność w aplikacjach Java.
FAQs
Jak mogę edytować arkusz Excel za pośrednictwem REST w Javie przy użyciu GroupDocs.Editor?
Użyj metodloadDocumentisaveDocumentSDK, jak pokazano w przykładzie kodu. Biblioteka obsługuje komunikację REST, więc pracujesz wyłącznie z obiektami Javy.Jaką metodę uwierzytelniania wymaga REST API?
API używa przepływu OAuth2 client‑credentials. Uzyskaj token dostępu przy użyciu swojegoAppSidiAppKey, a następnie dołącz go w nagłówkuAuthorization: Bearerwe wszystkich wywołaniach. Szczegóły znajdują się w oficjalnej dokumentacji.Czy mogę edytować wiele arkuszy w jednym żądaniu?
Tak. Po załadowaniu skoroszytu każdy arkusz pojawia się jako osobna strona wLoadResult. Przejdź przez strony, zastosuj zmiany i wywołajsaveDocumentraz, aby zachować wszystkie edycje.Gdzie mogę znaleźć informacje o cenach i licencjonowaniu?
Odwiedź główną stronę produktu, aby zobaczyć plany subskrypcji oraz stronę tymczasowej licencji w celu uzyskania klucza próbnego.