Pełny działający przykład usuwania obiektów adnotacji z PDF przy użyciu REST w Node.JS

Ten przykład demonstruje, jak przesłać plik PDF, usunąć wszystkie jego adnotacje i pobrać oczyszczony plik przy użyciu GroupDocs.Annotation SDK.

const fs = require('fs');
const path = require('path');
const GroupDocsAnnotationCloud = require("@groupdocs/annotation-cloud");

// ==== Authentication =========================================================
const clientId = "YOUR_CLIENT_ID";
const clientSecret = "YOUR_CLIENT_SECRET";

const config = new GroupDocsAnnotationCloud.Configuration(clientId, clientSecret);
const annotationsApi = new GroupDocsAnnotationCloud.AnnotationsApi(config);
const storageApi = new GroupDocsAnnotationCloud.StorageApi(config);

// ==== Local & Remote file definitions =======================================
const localInputPath = path.resolve(__dirname, "input.pdf");
const localOutputPath = path.resolve(__dirname, "output.pdf");
const remoteFilePath = "input.pdf";

// ==== Main workflow ==========================================================
(async () => {
    // 1. Upload PDF to GroupDocs Cloud storage
    const fileBytes = fs.readFileSync(localInputPath);
    const uploadRequest = new GroupDocsAnnotationCloud.UploadFileRequest({
        path: remoteFilePath,
        file: fileBytes
    });
    await storageApi.uploadFile(uploadRequest);

// 2. Build FileInfo object for the uploaded PDF
    const fileInfo = new GroupDocsAnnotationCloud.FileInfo({
        filePath: remoteFilePath
    });

// 3. Retrieve all existing annotations
    const getAnnotationsRequest = new GroupDocsAnnotationCloud.GetAnnotationsRequest({
        fileInfo: fileInfo
    });
    const annotationsResult = await annotationsApi.getAnnotations(getAnnotationsRequest);
    const annotationIds = (annotationsResult.annotations || []).map(a => a.id);

// 4. Delete all annotations (if any)
    if (annotationIds.length > 0) {
        const deleteRequest = new GroupDocsAnnotationCloud.DeleteAnnotationsRequest({
            fileInfo: fileInfo,
            annotationIds: annotationIds
        });
        await annotationsApi.deleteAnnotations(deleteRequest);
    }

// 5. Download the cleaned PDF back to local storage
    const downloadRequest = new GroupDocsAnnotationCloud.DownloadFileRequest({
        path: remoteFilePath
    });
    const fileStream = await storageApi.downloadFile(downloadRequest);
    fs.writeFileSync(localOutputPath, fileStream);
    console.log(`All annotations removed. Clean file saved to ${localOutputPath}`);
})();

Uwaga: Ten przykład kodu demonstruje podstawową funkcjonalność. Przed użyciem go w swoim projekcie upewnij się, że zaktualizowałeś wszystkie ścieżki 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.

Usuwanie adnotacji PDF za pomocą REST API przy użyciu cURL

Poniżej znajdują się polecenia cURL, które wykonują ten sam przepływ usuwania adnotacji za pośrednictwem punktów końcowych REST usługi GroupDocs.Annotation Cloud.

# 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\"}"

# 2. Upload the source PDF
curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/pdf" \
     --data-binary "@input.pdf"

# 3. Retrieve annotation IDs
curl -X GET "https://api.groupdocs.cloud/v2.0/annotation/annotations?filePath=input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

# 4. Delete all retrieved annotations
curl -X DELETE "https://api.groupdocs.cloud/v2.0/annotation/annotations?filePath=input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d "{\"annotationIds\":[\"id1\",\"id2\"]}"

# 5. Download the cleaned PDF
curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.pdf

Aby uzyskać pełną listę punktów końcowych i parametrów, zobacz oficjalną dokumentację API.

Jak działa usuwanie obiektów adnotacji z PDF przy użyciu REST w Node.JS

1. Konfiguracja uwierzytelniania - Klasa Configuration jest tworzona z Twoim clientId i clientSecret, tworząc uwierzytelniony kontekst dla wszystkich kolejnych wywołań API.

const config = new GroupDocsAnnotationCloud.Configuration(clientId, clientSecret);

2. Przesyłanie pliku - UploadFileRequest wysyła lokalne bajty PDF do magazynu GroupDocs Cloud. Metoda storageApi.uploadFile obsługuje transfer.

const uploadRequest = new GroupDocsAnnotationCloud.UploadFileRequest({
    path: remoteFilePath,
    file: fileBytes
});
await storageApi.uploadFile(uploadRequest);

3. Pobieranie adnotacji - GetAnnotationsRequest tworzy obiekt żądania z odniesieniem do FileInfo. Wywołanie annotationsApi.getAnnotations zwraca kolekcję obiektów adnotacji, z których wyodrębnia się identyfikatory.

const getAnnotationsRequest = new GroupDocsAnnotationCloud.GetAnnotationsRequest({
    fileInfo: fileInfo
});
const annotationsResult = await annotationsApi.getAnnotations(getAnnotationsRequest);

4. Usuwanie adnotacji - Jeśli istnieją jakiekolwiek identyfikatory, DeleteAnnotationsRequest jest wypełniany i przekazywany do annotationsApi.deleteAnnotations, które trwale usuwa adnotacje z przechowywanego PDF.

const deleteRequest = new GroupDocsAnnotationCloud.DeleteAnnotationsRequest({
    fileInfo: fileInfo,
    annotationIds: annotationIds
});
await annotationsApi.deleteAnnotations(deleteRequest);

5. Pobieranie czystego PDF - Na koniec DownloadFileRequest pobiera zaktualizowany plik, a fs.writeFileSync zapisuje go w lokalnym systemie plików.

const downloadRequest = new GroupDocsAnnotationCloud.DownloadFileRequest({
    path: remoteFilePath
});
const fileStream = await storageApi.downloadFile(downloadRequest);
fs.writeFileSync(localOutputPath, fileStream);

Aby uzyskać szczegółowe definicje klas i metod, odwołaj się do referencji API.

Instalowanie i konfigurowanie GroupDocs.Annotation Cloud SDK dla Node.js

SDK jest dystrybuowany jako pakiet npm. Zainstaluj go przy pomocy poniższego polecenia, a następnie użyj require w swoim projekcie.

npm install groupdocs-annotation-cloud

Możesz również pobrać najnowszy pakiet bezpośrednio ze strony wydań GitHub lub z oficjalnego adresu URL do pobrania.

Po instalacji zaimportuj bibliotekę i utwórz obiekt konfiguracji, jak pokazano w przykładzie kodu:

const GroupDocsAnnotationCloud = require("@groupdocs/annotation-cloud");
const config = new GroupDocsAnnotationCloud.Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");

Upewnij się, że Twoje środowisko uruchomieniowe spełnia wymagania dotyczące wersji Node.js oraz że posiadasz ważne konto GroupDocs, aby uzyskać dane uwierzytelniające klienta.

Opcje i ustawienia usuwania adnotacji

SDK udostępnia kilka parametrów, które możesz dostroić:

• clientId / clientSecret - Dane uwierzytelniające do autoryzacji OAuth. Ustaw je w konstruktorze Configuration.
• fileInfo.filePath - Ścieżka do pliku PDF w pamięci GroupDocs Cloud. Dostosuj ją, jeśli przechowujesz pliki w innym folderze.
• annotationIds - Tablica identyfikatorów zwróconych przez GetAnnotations. Podanie podzbioru umożliwia selektywne usuwanie.

Dodatkowe ustawienia, takie jak limit czasu żądania i konfiguracja proxy, są dostępne w dokumentacji SDK; zobacz oficjalną dokumentację po pełną listę.

Najlepsze praktyki usuwania adnotacji PDF za pośrednictwem REST

• Sprawdź identyfikatory adnotacji - Zawsze sprawdzaj, czy identyfikatory, które zamierzasz usunąć, istnieją; próba usunięcia nieistniejących identyfikatorów może spowodować błąd 404.
• Używaj HTTPS - Wszystkie wywołania API muszą być wykonywane przez HTTPS, aby chronić Twoje poświadczenia i dane dokumentu.
• Obsługuj duże pliki przy użyciu przesyłania w częściach - Dla plików PDF większych niż 100 MB, preferuj punkt końcowy wieloczęściowego przesyłania, aby uniknąć przekroczenia limitu czasu.
• Loguj odpowiedzi API - Przechowuj identyfikatory żądań i odpowiedzi w celu tworzenia ścieżek audytu i ułatwienia rozwiązywania problemów.
• Ponownie używaj tokenów dostępu - Buforuj token OAuth, dopóki nie wygaśnie, aby zmniejszyć obciążenie uwierzytelniania.

Często zadawane pytania

• Jak uwierzytelnić się w GroupDocs.Annotation Cloud API?
  Uzyskaj identyfikator klienta (client ID) i sekret z konta GroupDocs, a następnie żądaj tokenu dostępu poprzez punkt końcowy OAuth. Zobacz oficjalną dokumentację, aby uzyskać szczegóły.

• Czy mogę usunąć konkretne adnotacje zamiast wszystkich?
  Tak, podaj identyfikatory adnotacji, które chcesz usunąć w DeleteAnnotationsRequest. SDK zwraca listę identyfikatorów adnotacji po wywołaniu GetAnnotations.

• Jak mogę usunąć obiekty adnotacji z PDF przy użyciu REST w Node.JS?
  Użyj GroupDocs.Annotation Cloud SDK for Node.js, aby wywołać endpoint DeleteAnnotations po pobraniu identyfikatorów adnotacji. Pełny przepływ pracy jest przedstawiony w przykładzie kodu oraz sekcji cURL tego przewodnika.

• Jakie licencjonowanie jest wymagane do użytku produkcyjnego?
  Do produkcji wymagana jest płatna licencja. Podczas oceny możesz uzyskać tymczasową licencję ze strony tymczasowej licencji.

Dalsza lektura

• Wyodrębnij lub usuń adnotacje z PDF przy użyciu REST API w Node.js
• Tekst przekreślony w PDF przy użyciu Node.js i REST API
• Usuń adnotacje z PDF przy użyciu REST API w Pythonie

Zanim zaczniesz: Wymagania wstępne i instalacja

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

• Node.js 14 lub nowszy zainstalowany na Twojej maszynie deweloperskiej.
• Aktywne konto GroupDocs Cloud z identyfikatorem klienta i sekretem klienta.
• Dostęp do plików PDF, które chcesz połączyć, przechowywanych w magazynie GroupDocs Cloud.

Zainstaluj SDK za pomocą npm i pobierz najnowszy pakiet:

npm install groupdocs-merger-cloud

Możesz również pobrać SDK ze strony oficjalnych wydań: Pobierz SDK. Po instalacji jesteś gotowy, aby rozpocząć kodowanie.

Przewodnik krok po kroku łączenia PDF w Node.JS

Krok 1: Zainstaluj SDK i zaimportuj wymagane klasy

Najpierw zaimportuj klasy, które będą potrzebne do scalania plików PDF.

const { MergeApi, MergeOptions, FileInfo, Configuration } = require("@groupdocs/merger-cloud");

Ten import zapewnia dostęp do podstawowego API, obiektów konfiguracyjnych i deskryptorów plików.

Krok 2: Skonfiguruj swoje poświadczenia GroupDocs

Utwórz obiekt konfiguracji ze swoimi poświadczeniami klienta.

const config = new Configuration({
    clientId: "YOUR_CLIENT_ID",
    clientSecret: "YOUR_CLIENT_SECRET"
});

Podanie prawidłowych poświadczeń pozwala bibliotece uwierzytelnić Twoje żądania.

Krok 3: Zdefiniuj pliki PDF do scalenia

Wymień dokumenty PDF, które chcesz połączyć. Ten krok przygotowuje Cię do efektywnego łączenia PDF w Node.JS.

const filesToMerge = [
    new FileInfo({ filePath: "input1.pdf" }),
    new FileInfo({ filePath: "input2.pdf" })
];

Każdy FileInfo wskazuje na plik przechowywany w Twoim magazynie GroupDocs Cloud.

Krok 4: Ustaw opcje scalania

Skonfiguruj lokalizację wyjścia i dołącz listę plików do żądania scalenia.

const mergeOptions = new MergeOptions();
mergeOptions.fileInfos = filesToMerge;
mergeOptions.outputPath = "merged_output.pdf";

Te ustawienia kontrolują, jak łączysz PDF w Node.JS i gdzie zostanie zapisany wynik.

Krok 5: Wykonaj operację scalania

Utwórz instancję API, wywołaj metodę merge i obsłuż odpowiedź.

const mergeApi = new MergeApi(config);

try {
    const result = await mergeApi.mergeDocuments(mergeOptions);
    console.log("Merge completed. Output file stored at:", result.path);
} catch (error) {
    console.error("Error during PDF merge:", error);
}

Wywołanie asynchroniczne zwraca ścieżkę do połączonego dokumentu, jeśli operacja zakończy się sukcesem.

Pełny przykład implementacji łączenia plików PDF w Node.JS

Poniższy kod demonstruje kompletny przepływ pracy od konfiguracji po obsługę wyników.

const { MergeApi, MergeOptions, FileInfo, Configuration } = require("@groupdocs/merger-cloud");

// Configure the SDK (replace with your actual credentials)
const config = new Configuration({
    clientId: "YOUR_CLIENT_ID",
    clientSecret: "YOUR_CLIENT_SECRET"
});

async function mergePdfFiles() {
    // Initialize the Merge API
    const mergeApi = new MergeApi(config);

// Define the PDF files to be merged (must exist in GroupDocs Cloud storage)
    const filesToMerge = [
        new FileInfo({ filePath: "input1.pdf" }),
        new FileInfo({ filePath: "input2.pdf" })
    ];

// Set merge options
    const mergeOptions = new MergeOptions();
    mergeOptions.fileInfos = filesToMerge;
    mergeOptions.outputPath = "merged_output.pdf";

try {
        // Perform the merge operation
        const result = await mergeApi.mergeDocuments(mergeOptions);
        console.log("Merge completed. Output file stored at:", result.path);
    } catch (error) {
        console.error("Error during PDF merge:", error);
    }
}

// Execute the merge
mergePdfFiles();

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

Scalanie plików PDF za pomocą REST API przy użyciu cURL

Jeśli wolisz czyste podejście REST, tę samą operację można wykonać przy użyciu poleceń cURL.

Najpierw uzyskaj token dostępu:

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

Prześlij pliki PDF źródłowe do swojego magazynu (zastąp YOUR_ACCESS_TOKEN tokenem z poprzedniego kroku):

curl -X POST "https://api.groupdocs.cloud/v2.0/storage/file/upload?path=input1.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "file=@/local/path/input1.pdf"

Powtórz przesyłanie pliku input2.pdf. Następnie żądaj operacji scalania:

curl -X POST "https://api.groupdocs.cloud/v2.0/merger/merge" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfos": [
               {"filePath":"input1.pdf"},
               {"filePath":"input2.pdf"}
           ],
           "outputPath":"merged_output.pdf"
         }'

Na koniec pobierz połączony plik:

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/download?path=merged_output.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o merged_output.pdf

Aby uzyskać pełną listę punktów końcowych i parametrów, zobacz referencję API.

Konfigurowanie opcji scalania

SDK udostępnia kilka opcji, które pozwalają precyzyjnie dostosować proces scalania:

• outputPath – Ścieżka docelowa dla scalonego pliku PDF. Dostosuj ją, aby kontrolować, gdzie zostanie zapisany wynik.
• fileInfos – Tablica obiektów FileInfo, które określają źródłowe pliki PDF i ich kolejność.

Możesz także ustawić dodatkowe właściwości, takie jak pages, aby scalić określone zakresy stron, lub password dla zaszyfrowanych plików PDF. Odwołaj się do oficjalnej dokumentacji po pełną listę konfigurowalnych pól.

Rozważania dotyczące wydajności przy łączeniu plików PDF

Podczas łączenia dużych lub wielu plików PDF, pamiętaj o tych wskazówkach:

• Używaj async/await aby uniknąć blokowania pętli zdarzeń, szczególnie przy dużych dokumentach.
• Przesyłanie wsadowe: przesyłaj pliki PDF źródłowe równolegle przed wywołaniem scalania, aby zmniejszyć całkowite opóźnienie.
• Przetwarzanie strumieniowe: dla wyjątkowo dużych plików PDF rozważ przechowywanie wyników pośrednich w chmurze i scalanie ich w mniejszych fragmentach.
• Zaszyfrowane PDF: podaj hasła w obiektach FileInfo; przetwarzanie zaszyfrowanych plików zwiększa obciążenie, więc scal je po odszyfrowaniu, jeśli to możliwe.

Stosowanie tych praktyk pomaga efektywnie łączyć pliki PDF w Node.JS, minimalizując zużycie pamięci.

Pytania, które możesz mieć

• Jak scalić pliki PDF w Node.JS przy użyciu GroupDocs?
  Użyj GroupDocs.Merger Cloud SDK for Node.js aby utworzyć instancję MergeApi, skonfigurować MergeOptions z źródłowymi plikami PDF i wywołać mergeDocuments. Pełny przykład kodu w tym przewodniku demonstruje proces.

• Czy mogę scalać zaszyfrowane pliki PDF w Node.JS?
  Tak, SDK obsługuje scalanie zaszyfrowanych plików PDF. Podaj prawidłowe hasła w obiektach FileInfo przed wywołaniem mergeDocuments. Zobacz oficjalną dokumentację po szczegóły.

• Jakie są opcje licencjonowania dla GroupDocs.Merger?
  GroupDocs oferuje elastyczne plany cenowe. Do testów możesz poprosić o tymczasową licencję, aby ocenić bibliotekę przed zakupem pełnej subskrypcji.

• Gdzie mogę znaleźć więcej przykładów i wsparcia?
  Dodatkowe przykłady są dostępne w repozytorium GitHub. Aby uzyskać pomoc, odwiedź forum wsparcia.

Dalsza lektura

• Podziel PDF na wiele plików PDF w Node.JS
• Zabezpiecz dokumenty PDF hasłami przy użyciu REST API w Node.js
• Jak scalić pliki PDF w C# przy użyciu REST API

Dodaj znak wodny obrazu do dokumentów PDF w Javie w 5 krokach

1. Zainicjuj klienta API: Utwórz instancję ApiClient z identyfikatorem klienta i sekretem.

ApiClient apiClient = new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
WatermarkApi watermarkApi = new WatermarkApi(apiClient);

Ten krok łączy Twój kod Java z usługą GroupDocs.Watermark Cloud. Zobacz odniesienie API po więcej szczegółów.

2. Określ plik PDF źródłowy: Utwórz obiekt FileInfo, który wskazuje na PDF, który chcesz oznaczyć znakiem wodnym.

FileInfo fileInfo = new FileInfo();
fileInfo.setFilePath("input.pdf");

Plik musi zostać przesłany do Twojego magazynu GroupDocs przed żądaniem.

3. Skonfiguruj znak wodny obrazu: Zdefiniuj ścieżkę obrazu, krycie, współczynnik skali, obrót i wyrównanie.

ImageWatermark imageWatermark = new ImageWatermark();
imageWatermark.setImagePath("watermark.png");
imageWatermark.setOpacity(0.5);
imageWatermark.setScaleFactor(0.3);
imageWatermark.setHorizontalAlignment(HorizontalAlignment.CENTER);
imageWatermark.setVerticalAlignment(VerticalAlignment.CENTER);
imageWatermark.setMargin(new Margin(10, 10, 10, 10));

Dostosuj te wartości, aby uzyskać pożądany wygląd; krycie kontroluje przejrzystość, natomiast współczynnik skali określa rozmiar względem strony.

4. Ustaw opcje znaku wodnego i ścieżkę wyjściową: Połącz informacje o pliku i znak wodny w obiekt WatermarkOptions.

WatermarkOptions options = new WatermarkOptions();
options.setFileInfo(fileInfo);
options.setImageWatermark(imageWatermark);
options.setOutputPath("output.pdf");

outputPath informuje usługę, gdzie ma przechowywać wynikowy plik PDF.

5. Wykonaj żądanie: Utwórz AddWatermarkRequest i wywołaj API. Obsłuż odpowiedzi sukcesu lub błędu.

AddWatermarkRequest request = new AddWatermarkRequest(options);
try {
    AddWatermarkResponse response = watermarkApi.addWatermark(request);
    System.out.println("Watermark added successfully. Output file: " + response.getPath());
} catch (Exception e) {
    System.err.println("Error adding watermark: " + e.getMessage());
}

Po wykonaniu żądania plik PDF z dodanym znakiem wodnym jest dostępny w określonej lokalizacji.

Kompletny przykład kodu: Dodaj znak wodny obrazu do dokumentów PDF w Javie

Poniższy przykład demonstruje pełną implementację, od inicjalizacji klienta po zapisanie PDF z znakiem wodnym.

import com.groupdocs.cloud.watermark.api.WatermarkApi;
import com.groupdocs.cloud.watermark.client.ApiClient;
import com.groupdocs.cloud.watermark.model.AddWatermarkRequest;
import com.groupdocs.cloud.watermark.model.AddWatermarkResponse;
import com.groupdocs.cloud.watermark.model.FileInfo;
import com.groupdocs.cloud.watermark.model.ImageWatermark;
import com.groupdocs.cloud.watermark.model.Margin;
import com.groupdocs.cloud.watermark.model.WatermarkOptions;
import com.groupdocs.cloud.watermark.model.enums.HorizontalAlignment;
import com.groupdocs.cloud.watermark.model.enums.VerticalAlignment;

public class AddImageWatermarkExample {
    public static void main(String[] args) {
        // Initialize API client (replace with your actual credentials)
        ApiClient apiClient = new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
        WatermarkApi watermarkApi = new WatermarkApi(apiClient);

// Input PDF file information
        FileInfo fileInfo = new FileInfo();
        fileInfo.setFilePath("input.pdf");

// Image watermark configuration
        ImageWatermark imageWatermark = new ImageWatermark();
        imageWatermark.setImagePath("watermark.png");          // Path to watermark image
        imageWatermark.setOpacity(0.5);                        // 50% opacity
        imageWatermark.setScaleFactor(0.3);                    // 30% of page size
        imageWatermark.setRotationAngle(0);                    // No rotation
        imageWatermark.setHorizontalAlignment(HorizontalAlignment.CENTER);
        imageWatermark.setVerticalAlignment(VerticalAlignment.CENTER);
        imageWatermark.setMargin(new Margin(10, 10, 10, 10));  // 10 points margin on all sides

// Watermark options
        WatermarkOptions options = new WatermarkOptions();
        options.setFileInfo(fileInfo);
        options.setImageWatermark(imageWatermark);
        options.setOutputPath("output.pdf"); // Resulting PDF with watermark

// Create request and call API
        AddWatermarkRequest request = new AddWatermarkRequest(options);
        try {
            AddWatermarkResponse response = watermarkApi.addWatermark(request);
            System.out.println("Watermark added successfully. Output file: " + response.getPath());
        } catch (Exception e) {
            System.err.println("Error 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ś ścieżki do plików (input.pdf, watermark.png, output.pdf), aby odpowiadały rzeczywistym lokalizacjom, sprawdź, czy wszystkie wymagane zależności są poprawnie 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.

Zastosuj znak wodny obrazu w dokumentach PDF za pomocą cURL i REST API

Poniżej znajdują się wywołania REST, których możesz użyć z cURL, aby uzyskać ten sam wynik bez pisania kodu w języku Java.

1. 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 używany w kolejnych wywołaniach.

2. Prześlij źródłowy PDF

   curl -X POST "https://api.groupdocs.cloud/v2.0/storage/upload?path=input.pdf" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -F "file=@/path/to/input.pdf"
   

3. Prześlij obraz znaku wodnego

   curl -X POST "https://api.groupdocs.cloud/v2.0/storage/upload?path=watermark.png" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -F "file=@/path/to/watermark.png"
   

4. Dodaj znak wodny obrazu

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.pdf" },
           "imageWatermark": {
               "imagePath": "watermark.png",
               "opacity": 0.5,
               "scaleFactor": 0.3,
               "horizontalAlignment": "Center",
               "verticalAlignment": "Center",
               "margin": { "top": 10, "right": 10, "bottom": 10, "left": 10 }
           },
           "outputPath": "output.pdf"
         }'

To żądanie odzwierciedla logikę kodu Java, stosując te same ustawienia przezroczystości, skalowania i wyrównania.

5. Pobierz PDF z znakiem wodnym

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/download?path=output.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.pdf

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

Instalowanie i konfigurowanie GroupDocs.Watermark Cloud SDK for Java

Dodaj zależność Maven do swojego pom.xml (lub równoważny fragment Gradle). Biblioteka jest hostowana w Maven Central.

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

Potrzebujesz także ważnego konta GroupDocs Cloud. Pobierz swój Client ID i Client Secret z portalu GroupDocs. Nie jest wymagana dodatkowa instalacja środowiska uruchomieniowego, ponieważ SDK komunikuje się z usługą w chmurze.

Dostosowywanie opcji znaku wodnego obrazu dla dokumentów PDF

SDK udostępnia kilka właściwości, które pozwalają kontrolować wygląd wizualny znaku wodnego.

Dostosuj przezroczystość

imageWatermark.setOpacity(0.75); // 75% opacity for a more visible watermark

Wartości nieprzezroczystości mieszczą się w przedziale od 0.0 (całkowicie przezroczyste) do 1.0 (całkowicie nieprzezroczyste).

Zmień współczynnik skali

imageWatermark.setScaleFactor(0.5); // Watermark occupies 50% of the page width

Współczynnik skalowania określa rozmiar znaku wodnego względem wymiarów strony.

Ustaw wyrównanie i marginesy

imageWatermark.setHorizontalAlignment(HorizontalAlignment.RIGHT);
imageWatermark.setVerticalAlignment(VerticalAlignment.BOTTOM);
imageWatermark.setMargin(new Margin(20, 20, 20, 20));

Te ustawienia umieszczają znak wodny w prawym dolnym rogu z marginesem 20 punktów.

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

Podsumowanie

Dodanie znaku wodnego w postaci obrazu do dokumentów PDF w Javie jest prostym zadaniem, gdy używasz GroupDocs.Watermark Cloud SDK for Java. SDK obsługuje wszystkie niskopoziomowe operacje na PDF, pozwalając skupić się na aspektach wizualnych, takich jak przezroczystość, skalowanie i pozycjonowanie. Niezależnie od tego, czy wolisz natywną implementację w Javie, czy chmurę opartą na cURL, te same wysokiej jakości wyniki są osiągalne bez utraty wydajności. Pamiętaj, aby uzyskać odpowiednią licencję do użytku produkcyjnego; szczegóły cenowe są dostępne na stronie produktu, a strona tymczasowej licencji może być użyta do oceny.

Najczęściej zadawane pytania

• Jak dodać znak wodny obrazu do PDF w Javie bez utraty jakości?
  Użyj właściwości scaleFactor, aby dopasować rozmiar znaku wodnego względem strony i zachować oryginalną rozdzielczość DPI źródłowego PDF. SDK zachowuje rozdzielczość PDF, więc znak wodny pozostaje wyraźny przy każdym poziomie powiększenia.

• Czy mogę dodać wiele znaków wodnych do tego samego PDF?
  Tak. Utwórz osobne obiekty ImageWatermark z różnymi konfiguracjami i dodawaj je kolejno, wywołując addWatermark wielokrotnie lub dodając je do listy w żądaniu.

• Jakie formaty obrazów są obsługiwane dla znaku wodnego?
  API akceptuje powszechne typy obrazów, takie jak PNG, JPG, BMP, GIF oraz TIFF. PNG jest zalecany ze względu na bezstratną jakość i obsługę przezroczystości.

• Czy istnieje sposób, aby podglądnąć znak wodny przed jego zastosowaniem?
  Możesz użyć GroupDocs.Watermark Cloud SDK for Java, aby wygenerować tymczasowy plik PDF ze znakiem wodnym i pobrać go do przeglądu. To używa tego samego wywołania addWatermark z ścieżką wyjściową wskazującą tymczasową lokalizację.

Czytaj więcej

• Dodaj znak wodny do obrazów przy użyciu Javy
• Dodaj znak wodny do Worda w Javie - Watermark Creator
• Dodaj znak wodny obrazu do PDF | Jak dodać znak wodny do dokumentów PDF przy użyciu .NET