java rest api on Document Processing REST APIs | GroupDocs Cloud https://blog-qa.groupdocs.cloud/pl/tag/java-rest-api/ Recent content in java rest api on Document Processing REST APIs | GroupDocs Cloud Hugo -- gohugo.io pl Wed, 23 Sep 2026 13:04:19 +0000 Dodaj nakładkę tekstową do GIF przy użyciu REST w Javie https://blog-qa.groupdocs.cloud/pl/watermark/add-text-overlay-to-gif-using-rest-in-java/ Wed, 23 Sep 2026 13:04:19 +0000 https://blog-qa.groupdocs.cloud/pl/watermark/add-text-overlay-to-gif-using-rest-in-java/ Dowiedz się, jak dodać nakładkę tekstową do GIF‑ów przy użyciu GroupDocs.Watermark Cloud SDK for Java via REST API. Zawiera kod, cURL i kroki konfiguracji już teraz. Rozpocznij szybko. Dodawanie dynamicznych napisów, napisów podtytułów lub komunikatów promocyjnych do animowanych GIF‑ów jest powszechną potrzebą współczesnych aplikacji internetowych i mobilnych. GroupDocs.Watermark Cloud SDK for Java zapewnia potężną bibliotekę opartą na REST, która ułatwia to zadanie. W tym przewodniku dowiesz się, jak dodać nakładkę tekstową do GIF przy użyciu REST w Javie, zobaczysz pełną implementację w Javie, poznasz równoważne polecenia cURL i zrozumiesz wymagane kroki konfiguracji.

Dodaj nakładkę tekstową do GIF przy użyciu REST w Javie – Przykładowy kod

Ten przykład demonstruje, jak skonfigurować znak wodny tekstowy i zastosować go do każdej klatki pliku GIF.

import com.groupdocs.watermark.cloud.api.WatermarkApi;
import com.groupdocs.watermark.cloud.client.ApiException;
import com.groupdocs.watermark.cloud.client.Configuration;
import com.groupdocs.watermark.cloud.model.AddWatermarkRequest;
import com.groupdocs.watermark.cloud.model.AddWatermarkResponse;
import com.groupdocs.watermark.cloud.model.FileInfo;
import com.groupdocs.watermark.cloud.model.OutputFileInfo;
import com.groupdocs.watermark.cloud.model.TextWatermarkOptions;
import com.groupdocs.watermark.cloud.model.HorizontalAlignment;
import com.groupdocs.watermark.cloud.model.VerticalAlignment;

public class AddTextOverlayToGif {
    public static void main(String[] args) {
        // Initialize API configuration (replace with your actual clientId and clientSecret)
        Configuration config = new Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
        WatermarkApi watermarkApi = new WatermarkApi(config);

// Prepare input file information
        FileInfo inputFile = new FileInfo();
        inputFile.setFilePath("input.gif");          // Path to the source GIF in the storage
        inputFile.setStorageName("MyStorage");       // Optional: name of the storage

// Prepare output file information
        OutputFileInfo outputFile = new OutputFileInfo();
        outputFile.setFilePath("output.gif");        // Desired path for the watermarked GIF
        outputFile.setStorageName("MyStorage");      // Optional: name of the storage

// Configure text watermark options
        TextWatermarkOptions textOptions = new TextWatermarkOptions();
        textOptions.setText("Sample Watermark");
        textOptions.setFontFamily("Arial");
        textOptions.setFontSize(24.0);
        textOptions.setColor("#FF0000");             // Red color in HEX
        textOptions.setOpacity(0.5);                 // 50% opacity
        textOptions.setRotationAngle(0.0);
        textOptions.setHorizontalAlignment(HorizontalAlignment.CENTER);
        textOptions.setVerticalAlignment(VerticalAlignment.MIDDLE);
        textOptions.setPageRange("1-");               // Apply to all frames/pages

// Build the request
        AddWatermarkRequest request = new AddWatermarkRequest();
        request.setFileInfo(inputFile);
        request.setOutputFileInfo(outputFile);
        request.setOptions(textOptions);

try {
            // Execute the request
            AddWatermarkResponse response = watermarkApi.addWatermark(request);
            System.out.println("Watermark added successfully. Output file: " + response.getPath());
        } catch (ApiException e) {
            System.err.println("Error while adding watermark: " + e.getMessage());
            e.printStackTrace();
        }
    }
}

Uwaga: Ten przykład kodu demonstruje podstawową funkcjonalność. Przed użyciem go w swoim projekcie upewnij się, że zaktualizowałeś wszystkie ścieżki do plików i wartości konfiguracyjne, aby odpowiadały rzeczywistemu środowisku, sprawdź, czy wszystkie wymagane zależności są prawidłowo zainstalowane, oraz dokładnie przetestuj 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.

Nakładanie tekstu na GIF za pomocą REST API przy użyciu cURL

Poniżej znajdują się polecenia cURL, które wykonują tę samą operację z terminala. Ilustrują pełny przepływ pracy REST: uwierzytelnianie, przesyłanie, dodawanie znaku wodnego i pobieranie.

# 1. Obtain an access token
curl -X POST "https://api.groupdocs.cloud/v2.0/auth/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

Zastąp YOUR_ACCESS_TOKEN w poniższych wywołaniach tokenem zwróconym powyżej.

# 2. Upload the source GIF to storage
curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/input.gif" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/octet-stream" \
     --data-binary @path/to/local/input.gif

# 3. Add text overlay to the GIF
curl -X POST "https://api.groupdocs.cloud/v2.0/watermark/add" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": { "filePath": "input.gif", "storageName": "MyStorage" },
           "outputFileInfo": { "filePath": "output.gif", "storageName": "MyStorage" },
           "options": {
               "text": "Sample Watermark",
               "fontFamily": "Arial",
               "fontSize": 24,
               "color": "#FF0000",
               "opacity": 0.5,
               "horizontalAlignment": "Center",
               "verticalAlignment": "Middle",
               "pageRange": "1-"
           }
         }'

# 4. Download the watermarked GIF
curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/output.gif" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o path/to/local/output.gif

Aby uzyskać więcej informacji o ciałach żądań i formatach odpowiedzi, zobacz oficjalną dokumentację API.

Analiza dodawania nakładki tekstowej do GIF przy użyciu REST w Javie – jak to działa

  1. Zainicjuj klienta API - new Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET") tworzy obiekt konfiguracji, który przechowuje Twoje poświadczenia. Instancja WatermarkApi używa tej konfiguracji do podpisywania każdego żądania.
Configuration config = new Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
WatermarkApi watermarkApi = new WatermarkApi(config);

  1. Określ pliki źródłowe i docelowe - FileInfo i OutputFileInfo informują usługę, gdzie odczytać oryginalny plik GIF i gdzie zapisać wynik. Oba mogą odwoływać się do niestandardowej nazwy magazynu.

    FileInfo inputFile = new FileInfo();
inputFile.setFilePath("input.gif");
inputFile.setStorageName("MyStorage");

  2. Skonfiguruj znak wodny tekstowy - TextWatermarkOptions zawiera wszystkie właściwości wizualne: tekst, czcionkę, rozmiar, kolor, przezroczystość, obrót i wyrównanie. Ustawienie pageRange na "1-" zapewnia, że każda klatka animowanego GIF‑a otrzyma nakładkę.

TextWatermarkOptions textOptions = new TextWatermarkOptions();
textOptions.setText("Sample Watermark");
textOptions.setFontFamily("Arial");
textOptions.setFontSize(24.0);
textOptions.setColor("#FF0000");
textOptions.setOpacity(0.5);
textOptions.setHorizontalAlignment(HorizontalAlignment.CENTER);
textOptions.setVerticalAlignment(VerticalAlignment.MIDDLE);
textOptions.setPageRange("1-");
  1. Zbuduj i wyślij żądanie - AddWatermarkRequest grupuje informacje o pliku i opcje. Wywołanie watermarkApi.addWatermark(request) wykonuje operację na serwerze i zwraca ścieżkę przetworzonego pliku.
AddWatermarkRequest request = new AddWatermarkRequest();
request.setFileInfo(inputFile);
request.setOutputFileInfo(outputFile);
request.setOptions(textOptions);
AddWatermarkResponse response = watermarkApi.addWatermark(request);
  1. Obsłuż odpowiedź - Odpowiedź zawiera ścieżkę do pliku wyjściowego. W rzeczywistej aplikacji zazwyczaj pobrałbyś plik lub przekazał ścieżkę do innej usługi.

Aby uzyskać pełną listę klas i właściwości, odwołaj się do referencji API.

Instalowanie i konfigurowanie GroupDocs.Watermark Cloud SDK for Java

Dodaj zależność Maven do swojego pom.xml (lub odpowiedni wpis Gradle). To pobiera wersję 23.8 SDK.

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-watermark-cloud</artifactId>
    <version>23.8</version>
</dependency>

Wymagania wstępne

  • Java 8 lub nowsza
  • Aktywne konto GroupDocs Cloud
  • Client ID i Client Secret (dostępne w panelu GroupDocs Cloud)

Przykład konfiguracji

Configuration config = new Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");

Pobierz najnowsze pliki JAR ze strony pobierania. Do użytku produkcyjnego zastosuj ważną licencję uzyskaną ze strony tymczasowej licencji.

Podsumowanie

Dodanie nakładki tekstowej do GIF przy użyciu REST w Javie staje się powtarzalną operacją po stronie serwera dzięki GroupDocs.Watermark Cloud SDK for Java. SDK ukrywa złożoność obsługi animowanych klatek, pozwalając skupić się na treści napisów lub komunikatów promocyjnych. Po zintegrowaniu przykładowego kodu lub przepływu pracy cURL możesz precyzyjnie dostosować style czcionek, kolory i przezroczystość, aby pasowały do Twojej marki. Pamiętaj, aby zabezpieczyć licencję produkcyjną – szczegóły cenowe są dostępne na stronie produktu, a tymczasową licencję można uzyskać do testów poprzez stronę tymczasowej licencji. Szczęśliwego kodowania!

FAQs

  • Jak dodać nakładkę tekstową do GIF‑a przy użyciu REST w Javie, gdy tekst zmienia się w zależności od użytkownika?
    Utwórz obiekt TextWatermarkOptions w czasie wykonywania z ciągiem specyficznym dla użytkownika, a następnie wywołaj tę samą metodę addWatermark. API przetwarza każde żądanie niezależnie, więc dynamiczna zawartość jest w pełni obsługiwana.

  • Czy mogę dodać napisy do animowanego GIF‑a bez wpływu na prędkość animacji?
    Tak. Znak wodny jest nakładany na każdą klatkę, zachowując oryginalne opóźnienie klatek. Po prostu ustaw pageRange na "1-", aby każda klatka otrzymała ten sam overlay.

  • Jakie formaty są obsługiwane dla koloru tekstu nakładki?
    SDK akceptuje kody kolorów HEX (np. #FF0000) oraz standardowe nazwy kolorów HTML. Zobacz odniesienie API po pełną listę.

  • Czy potrzebuję licencji do rozwoju i testowania?
    Tymczasowa licencja jest wystarczająca do oceny i testowania. W przypadku wdrożeń produkcyjnych zakup pełną licencję na stronie produktu i zastosuj ją przy użyciu API licencjonowania SDK.

Read More

]]> Zabezpiecz plik Excel hasłem przy użyciu REST w Javie https://blog-qa.groupdocs.cloud/pl/merger/password-protect-excel-via-rest-in-java/ Fri, 04 Sep 2026 12:18:34 +0000 https://blog-qa.groupdocs.cloud/pl/merger/password-protect-excel-via-rest-in-java/ Dowiedz się, jak zabezpieczyć hasłem skoroszyt Excel za pomocą REST w języku Java, korzystając z GroupDocs.Merger Cloud SDK. Przewodnik krok po kroku, przykładowy kod oraz polecenia cURL w zestawie. Ukrywanie wrażliwych danych w skoroszytach Excel jest powszechnym wymogiem dla przedsiębiorstw, które udostępniają raporty wewnętrznie lub partnerom. GroupDocs.Merger Cloud SDK for Java umożliwia programistom dodanie ochrony hasłem do plików XLSX za pomocą prostego interfejsu REST API. W tym przewodniku dowiesz się, jak zaimplementować zabezpieczanie hasłem Excel za pomocą REST w Javie, zobaczysz kompletny przykład w Javie oraz uruchomisz równoważne polecenia cURL dla integracji w chmurze.

Wymagania wstępne i konfiguracja

Zanim rozpoczniesz, upewnij się, że masz następujące:

  • Zainstalowany Java 8 lub nowszy.
  • Maven lub Gradle do zarządzania zależnościami.
  • Konto GroupDocs Cloud z client ID i client secret.
  • Dostęp do pamięci w chmurze, w której będą przechowywane pliki Excel.

Dodaj zależność Maven do swojego pom.xml (lub równoważny fragment Gradle):

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-merger-cloud</artifactId>
    <version>25.11</version>
</dependency>

Możesz pobrać najnowsze pliki JAR ze strony pobierania. Po dodaniu zależności utwórz obiekt konfiguracji z danymi uwierzytelniającymi:

String clientId = "YOUR_CLIENT_ID";
String clientSecret = "YOUR_CLIENT_SECRET";

Configuration config = new Configuration(clientId, clientSecret);
MergerApi mergerApi = new MergerApi(config);

Po przygotowaniu klienta możesz przejść do rzeczywistego przepływu pracy z zabezpieczeniem hasłem.

Zabezpieczanie hasłem pliku Excel za pomocą REST w Javie: Przewodnik krok po kroku

Krok 1: Załaduj dokument źródłowy

Zdefiniuj lokalizację pliku źródłowego XLSX w swojej pamięci w chmurze.

FileInfo inputFile = new FileInfo();
inputFile.setFilePath("input.xlsx");   // source Excel file

Krok 2: Ustaw ścieżkę docelową

Określ, gdzie zostanie zapisany chroniony skoroszyt.

String outputPath = "output_protected.xlsx"; // destination file

Krok 3: Skonfiguruj opcje ochrony hasłem

Utwórz obiekt ProtectOptions, dołącz informacje o pliku, ścieżkę wyjściową i żądane hasło.

ProtectOptions protectOptions = new ProtectOptions();
protectOptions.setFileInfo(inputFile);
protectOptions.setOutputPath(outputPath);
protectOptions.setPassword("MySecretPassword"); // desired password

Krok 4: Zbuduj żądanie ochrony dokumentu

Umieść opcje w ProtectDocumentRequest.

ProtectDocumentRequest request = new ProtectDocumentRequest(protectOptions);

Krok 5: Wykonaj żądanie i obsłuż odpowiedź

Wywołaj metodę API i obsłuż wszelkie błędy.

try {
    mergerApi.protectDocument(request);
    System.out.println("Excel file has been password protected successfully.");
    System.out.println("Protected file stored at: " + outputPath);
} catch (ApiException e) {
    System.err.println("Error while protecting the Excel file:");
    System.err.println("Status Code: " + e.getCode());
    System.err.println("Message: " + e.getMessage());
}

Aby uzyskać więcej szczegółów na temat każdej klasy, odwołaj się do referencji API.

Pełny działający przykład zabezpieczania hasłem pliku Excel za pomocą REST w Javie

Poniższy kod demonstruje kompletny proces od początku do końca.

import com.groupdocs.merger.cloud.ApiException;
import com.groupdocs.merger.cloud.Configuration;
import com.groupdocs.merger.cloud.api.MergerApi;
import com.groupdocs.merger.cloud.model.FileInfo;
import com.groupdocs.merger.cloud.model.ProtectOptions;
import com.groupdocs.merger.cloud.model.requests.ProtectDocumentRequest;

public class ProtectExcelExample {
    public static void main(String[] args) {
        // Replace with your actual client credentials
        String clientId = "YOUR_CLIENT_ID";
        String clientSecret = "YOUR_CLIENT_SECRET";

// Initialize the API configuration
        Configuration config = new Configuration(clientId, clientSecret);
        MergerApi mergerApi = new MergerApi(config);

// Define input and output file locations (relative to the storage root)
        FileInfo inputFile = new FileInfo();
        inputFile.setFilePath("input.xlsx");          // source Excel file
        String outputPath = "output_protected.xlsx";  // destination file

// Set password protection options
        ProtectOptions protectOptions = new ProtectOptions();
        protectOptions.setFileInfo(inputFile);
        protectOptions.setOutputPath(outputPath);
        protectOptions.setPassword("MySecretPassword"); // desired password

// Build the request
        ProtectDocumentRequest request = new ProtectDocumentRequest(protectOptions);

try {
            // Execute the password protection operation
            mergerApi.protectDocument(request);
            System.out.println("Excel file has been password protected successfully.");
            System.out.println("Protected file stored at: " + outputPath);
        } catch (ApiException e) {
            System.err.println("Error while protecting the Excel file:");
            System.err.println("Status Code: " + e.getCode());
            System.err.println("Message: " + e.getMessage());
        }
    }
}

Uwaga: Ten przykład kodu demonstruje podstawową funkcjonalność. Przed użyciem go w swoim projekcie upewnij się, że zaktualizowałeś ścieżki do plików (input.xlsx, output_protected.xlsx), aby odpowiadały rzeczywistym lokalizacjom, sprawdź, czy wszystkie wymagane zależności są prawidłowo zainstalowane, oraz dokładnie przetestuj w środowisku programistycznym. Jeśli napotkasz jakiekolwiek problemy, odwołaj się do oficjalnej dokumentacji lub skontaktuj się z zespołem wsparcia w celu uzyskania pomocy.

Zabezpiecz skoroszyt Excel za pomocą REST API przy użyciu cURL

Poniżej znajduje się zestaw poleceń cURL, które wykonują tę samą operację zabezpieczania hasłem bezpośrednio na endpointach REST.

1. Uwierzytelnij się i uzyskaj token dostępu

curl -X POST "https://api.groupdocs.cloud/v2.0/auth/token" \
     -H "Content-Type: application/json" \
     -d '{
           "client_id": "YOUR_CLIENT_ID",
           "client_secret": "YOUR_CLIENT_SECRET"
         }'

Odpowiedź zawiera access_token, którego będziesz używać w kolejnych wywołaniach.

2. Prześlij plik źródłowy XLSX

curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/input.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/octet-stream" \
     --data-binary @input.xlsx

3. Żądanie ochrony hasłem

curl -X POST "https://api.groupdocs.cloud/v2.0/merger/protect" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": { "filePath": "input.xlsx" },
           "outputPath": "output_protected.xlsx",
           "password": "MySecretPassword"
         }'

4. Pobierz chroniony skoroszyt

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/output_protected.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output_protected.xlsx

Te polecenia pozwalają zintegrować przepływ pracy ochrony w skryptach lub pipeline’ach CI. Aby uzyskać więcej szczegółów, zobacz oficjalną dokumentację API.

Podsumowanie

Implementacja zabezpieczanie hasłem Excel przy użyciu REST w Javie jest prosta przy użyciu GroupDocs.Merger Cloud SDK for Java. Postępując zgodnie z powyższymi krokami, możesz zabezpieczyć skoroszyty Excel, zautomatyzować proces w aplikacjach po stronie serwera i chronić wrażliwe dane. Pamiętaj, aby uzyskać odpowiednią licencję do użytku produkcyjnego; informacje o cenach są dostępne na stronie produktu, a możesz rozpocząć od tymczasowej licencji, aby ocenić bibliotekę. Miłego kodowania!

FAQs

  • Jak różni się ochrona hasłem pliku Excel za pomocą REST w Javie od lokalnego szyfrowania?
    API w chmurze wykonuje szyfrowanie na serwerze, więc nie musisz zarządzać bibliotekami kryptograficznymi lokalnie. SDK obsługuje konstruowanie żądania i parsowanie odpowiedzi, upraszczając integrację.

  • Czy można ustawić dodatkowe opcje ochrony, takie jak tryb tylko do odczytu?
    Aktualna klasa ProtectOptions koncentruje się na ochronie hasłem. Aby uzyskać bardziej zaawansowane funkcje zabezpieczeń, zapoznaj się z referencją API w poszukiwaniu nowszych parametrów.

  • Jakie formaty plików są obsługiwane dla ochrony hasłem?
    API Merger obecnie obsługuje XLSX, DOCX, PPTX, i PDF do szyfrowania. Odwołaj się do oficjalnej dokumentacji po pełną listę.

  • Czy potrzebuję licencji, aby uruchomić przykład w środowisku deweloperskim?
    Rozwój i testowanie można przeprowadzić przy użyciu tymczasowej licencji. Wdrożenia produkcyjne wymagają płatnej licencji, którą można zakupić na stronie produktu.

Czytaj więcej

]]>