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.

1. Uzyskaj token dostępu
   Zastąp YOUR_CLIENT_ID i YOUR_CLIENT_SECRET swoimi 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"

2. 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

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

4. 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:

1. Skonfiguruj klienta API - Obiekt ApiClient przechowuje 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");
   

2. Utwórz instancję Editor API - EditorApi udostępnia metody takie jak loadDocument i saveDocument.

EditorApi editorApi = new EditorApi(apiClient);

3. Załaduj skoroszyt Excel - LoadDocumentRequest określa nazwę pliku; odpowiedź zawiera informacje o stronie (arkuszu).

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

4. 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.)

5. Zapisz zmodyfikowany plik - SaveDocumentRequest okreś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:

1. Opcje ładowania - Kontroluj, czy skoroszyt jest otwierany w trybie tylko do odczytu.

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

2. 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);

3. 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 metod loadDocument i saveDocument SDK, 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 swojego AppSid i AppKey, a następnie dołącz go w nagłówku Authorization: Bearer we 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 w LoadResult. Przejdź przez strony, zastosuj zmiany i wywołaj saveDocument raz, 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.

Czytaj więcej

• Edytuj pliki PowerPoint przy użyciu biblioteki Java
• Edytuj dokumenty Word lub Excel przy użyciu REST API
• Edytuj arkusz Excel przy użyciu REST API w Pythonie