Tam Çalışan Örnek: REST ile Node.JS’de PDF’den Açıklama Nesnelerini Kaldırma

Bu örnek, bir PDF’yi nasıl yükleyeceğinizi, tüm ek açıklamalarını nasıl sileceğinizi ve temizlenmiş dosyayı GroupDocs.Annotation SDK kullanarak nasıl indireceğinizi gösterir.

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}`);
})();

Not: Bu kod örneği temel işlevselliği göstermektedir. Projenizde kullanmadan önce, dosya yollarını ve yapılandırma değerlerini gerçek ortamınıza uygun şekilde güncellediğinizden, tüm gerekli bağımlılıkların doğru şekilde yüklendiğinden emin olun ve geliştirme ortamınızda kapsamlı bir şekilde test edin. Herhangi bir sorunla karşılaşırsanız, lütfen resmi belgelere bakın veya destek ekibi ile iletişime geçin.

cURL Kullanarak REST API ile PDF Açıklamaları Silme

Aşağıda, GroupDocs.Annotation Cloud REST uç noktaları aracılığıyla aynı ek açıklama kaldırma iş akışını gerçekleştiren cURL komutları bulunmaktadır.

# 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

Uç noktalar ve parametrelerin tam listesi için, resmi API belgelerine bakın.

PDF’de REST ile Node.JS’de Açıklama Nesnelerini Kaldırma Nasıl Çalışır

1. Kimlik Doğrulama Ayarı - Configuration sınıfı, clientId ve clientSecret değerlerinizle örneklenir ve sonraki tüm API çağrıları için kimliği doğrulanmış bir bağlam oluşturur.

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

2. Dosya Yükleme - UploadFileRequest, yerel PDF baytlarını GroupDocs Cloud depolamasına gönderir. storageApi.uploadFile yöntemi aktarımı gerçekleştirir.

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

3. Ek Açıklamaları Al - GetAnnotationsRequest, bir FileInfo referansı içeren istek nesnesi oluşturur. annotationsApi.getAnnotations çağrısı, ek açıklama nesnelerinden oluşan bir koleksiyon döndürür ve bu koleksiyondan kimlikler çıkarılır.

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

4. Ek Açıklamaları Sil - Eğer herhangi bir kimlik mevcutsa, DeleteAnnotationsRequest doldurulur ve annotationsApi.deleteAnnotations metoduna gönderilir; bu, depolanan PDF’den ek açıklamaları kalıcı olarak kaldırır.

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

5. Temiz PDF’yi İndir - Son olarak, DownloadFileRequest güncellenmiş dosyayı alır ve fs.writeFileSync bu dosyayı yerel dosya sistemine yazar.

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

Detaylı sınıf ve yöntem tanımları için, API referansına bakın.

Kurulum ve Yapılandırma GroupDocs.Annotation Cloud SDK for Node.js

SDK bir npm paketi olarak dağıtılır. Aşağıdaki komutla kurun ve ardından projenizde require edin.

npm install groupdocs-annotation-cloud

En son paketi doğrudan GitHub sürüm sayfasından veya resmi indirme URL’sinden indirebilirsiniz.

Kurulumdan sonra, kütüphaneyi içe aktarın ve kod örneğinde gösterildiği gibi bir yapılandırma nesnesi oluşturun:

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

Çalışma ortamınızın Node.js sürüm gereksinimlerini karşıladığından ve istemci kimlik bilgilerini alabilmek için geçerli bir GroupDocs hesabına sahip olduğunuzdan emin olun.

Açıklama Kaldırma Seçenekleri ve Ayarlar

SDK, ayarlayabileceğiniz çeşitli parametreler sunar:

• clientId / clientSecret - OAuth kim doğrulaması için kimlik bilgileri. Configuration yapıcısında ayarlayın.
• fileInfo.filePath - PDF’in GroupDocs Cloud depolama alanındaki yolu. Dosyaları farklı bir klasörde saklıyorsanız bunu ayarlayın.
• annotationIds - GetAnnotations tarafından döndürülen kimliklerin bir dizisi. Bir alt küme sağlamak, seçici silme olanağı verir.

İstek zaman aşımı ve proxy yapılandırması gibi ek ayarlar SDK belgelerinde mevcuttur; tam liste için resmi belgeler sayfasına bakın.

REST üzerinden PDF Açıklamaları Kaldırma için En İyi Uygulamalar

• Anotasyon Kimliklerini Doğrula - Her zaman silmeyi düşündüğünüz kimliklerin mevcut olduğundan emin olun; var olmayan kimlikleri silmeye çalışmak 404 hatasına neden olabilir.
• HTTPS Kullan - Tüm API çağrıları, kimlik bilgilerinizin ve belge verilerinizin korunması için HTTPS üzerinden yapılmalıdır.
• Büyük Dosyaları Parçalı Yüklemelerle İşleyin - 100 MB’den büyük PDF’ler için, zaman aşımını önlemek amacıyla çok parçalı yükleme uç noktasını tercih edin.
• API Yanıtlarını Günlüğe Kaydet - Denetim izleri ve daha kolay sorun giderme için istek kimliklerini ve yanıtları saklayın.
• Erişim Token’larını Yeniden Kullan - Kimlik doğrulama yükünü azaltmak için OAuth token’ını süresi dolana kadar önbellekte tutun.

Sık Sorulan Sorular

• GroupDocs.Annotation Cloud API ile nasıl kimlik doğrulaması yapabilirim?
  GroupDocs hesabınızdan bir istemci kimliği ve gizli anahtar alın, ardından OAuth uç noktası üzerinden bir erişim belirteci isteyin. Ayrıntılar için resmi belgeleri inceleyin.

• Tümünü silmek yerine belirli yorumları silebilir miyim?
  Evet, silmek istediğiniz yorumların kimliklerini DeleteAnnotationsRequest içinde sağlayın. SDK, bir GetAnnotations çağrısından sonra yorum kimliklerinin listesini döndürür.

• PDF’den Annotation nesnelerini REST ile Node.JS’de nasıl kaldırabilirim?
  Annotation kimliklerini aldıktan sonra DeleteAnnotations uç noktasını çağırmak için GroupDocs.Annotation Cloud SDK for Node.js’i kullanın. Tam iş akışı bu kılavuzun kod örneği ve cURL bölümünde gösterilmiştir.

• Üretim kullanımı için hangi lisans gereklidir?
  Üretim için ücretli bir lisans gereklidir. Değerlendirme sırasında geçici bir lisansı geçici lisans sayfasından alabilirsiniz.

Daha Fazla Okuma

• Node.js’te REST API kullanarak PDF’den Açıklamaları Çıkarma veya Kaldırma
• Node.js ve REST API ile PDF’de Üstü Çizili Metin
• Python’da REST API kullanarak PDF’den Açıklamaları Kaldırma

Başlamadan Önce: Önkoşullar ve Kurulum

Başlamadan önce, aşağıdakilere sahip olduğunuzdan emin olun:

• Node.js 14 ve üzeri, geliştirme makinenize kurulu.
• Client ID ve client secret içeren aktif bir GroupDocs Cloud hesabı.
• GroupDocs Cloud depolama alanında saklanan, birleştirmek istediğiniz PDF dosyalarına erişim.

SDK’yı npm aracılığıyla kurun ve en son paketi indirin:

npm install groupdocs-merger-cloud

SDK’yı resmi sürüm sayfasından da alabilirsiniz: SDK’yi İndir. Kurulumdan sonra kodlamaya başlayabilirsiniz.

Node.JS’de PDF Birleştirme İçin Adım Adım Kılavuz

Adım 1: SDK’yı Yükleyin ve Gerekli Sınıfları İçe Aktarın

İlk olarak, PDF’leri birleştirmek için ihtiyacınız olan sınıfları içe aktarın.

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

Bu içe aktarma, çekirdek API’ye, yapılandırma nesnelerine ve dosya tanımlayıcılarına erişim sağlar.

Adım 2: GroupDocs Kimlik Bilgilerinizi Yapılandırın

İstemci kimlik bilgilerinizle bir yapılandırma nesnesi oluşturun.

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

Doğru kimlik bilgilerini sağlamak, kütüphanenin isteklerinizi kimlik doğrulamasına izin verir.

Adım 3: Birleştirilecek PDF Dosyalarını Tanımlayın

Birleştirmek istediğiniz PDF belgelerini listeleyin. Bu adım, Node.JS’te PDF birleştirmeyi verimli bir şekilde hazırlamanızı sağlar.

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

Her FileInfo, GroupDocs Cloud depolamanızda saklanan bir dosyaya işaret eder.

Adım 4: Birleştirme Seçeneklerini Ayarla

Çıktı konumunu yapılandırın ve dosya listesini birleştirme isteğine ekleyin.

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

Bu ayarlar, PDF’yi Node.JS’te nasıl birleştireceğinizi ve sonucun nerede kaydedileceğini kontrol eder.

Adım 5: Birleştirme İşlemini Gerçekleştir

API örneğini oluşturun, birleştirme metodunu çağırın ve yanıtı işleyin.

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);
}

Asenkron çağrı, işlem başarılı olursa birleştirilmiş belgenin yolunu döndürür.

Node.JS’de PDF’leri Birleştirme için Tam Uygulama Örneği

Aşağıdaki kod, yapılandırmadan sonuç işleme kadar tam iş akışını gösterir.

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();

Not: Bu kod örneği temel işlevselliği göstermektedir. Projenizde kullanmadan önce, dosya yollarını ve yapılandırma değerlerini gerçek ortamınıza uygun şekilde güncellediğinizden, tüm gerekli bağımlılıkların doğru şekilde yüklendiğini doğruladığınızdan ve geliştirme ortamınızda kapsamlı bir şekilde test ettiğinizden emin olun. Herhangi bir sorunla karşılaşırsanız, lütfen resmi belgeler adresine bakın veya destek ekibi ile iletişime geçin.

cURL Kullanarak REST API ile PDF Birleştirme

Saf bir REST yaklaşımını tercih ediyorsanız, aynı işlem cURL komutlarıyla gerçekleştirilebilir.

İlk olarak, bir erişim belirteci alın:

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"}'

Kaynak PDF’leri depolamanıza yükleyin (önceki adımdan aldığınız token ile YOUR_ACCESS_TOKEN değerini değiştirin):

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"

input2.pdf için yüklemeyi tekrarlayın. Ardından birleştirme işlemini isteyin:

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"
         }'

Son olarak, birleştirilmiş dosyayı indirin:

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

Uç noktalar ve parametrelerin tam listesi için, API referansına bakın.

Birleştirme Seçeneklerini Yapılandırma

SDK, birleştirme sürecini ince ayar yapmanıza olanak tanıyan çeşitli seçenekler sunar:

• outputPath - Birleştirilmiş PDF için hedef yol. Sonucun nerede saklanacağını kontrol etmek için bunu ayarlayın.
• fileInfos - Kaynak PDF’leri ve sırasını tanımlayan FileInfo nesnelerinin bir dizisi.

Belirli sayfa aralıklarını birleştirmek için pages gibi ek özellikleri veya şifreli PDF’ler için password özelliğini de ayarlayabilirsiniz. Tam yapılandırılabilir alanların listesi için resmi belgeler sayfasına bakın.

PDF Birleştirme İçin Performans Düşünceleri

Büyük veya çok sayıda PDF dosyasını birleştirirken, bu ipuçlarını aklınızda bulundurun:

• async/await kullanın olay döngüsünü engellememek için, özellikle büyük belgeler için.
• Toplu yüklemeler: Birleştirmeyi çağırmadan önce kaynak PDF’leri paralel olarak yükleyin, böylece genel gecikmeyi azaltın.
• Akışlı işleme: Aşırı büyük PDF’ler için ara sonuçları bulut depolamada saklamayı ve daha küçük parçalar halinde birleştirmeyi düşünün.
• Şifreli PDF’ler: FileInfo nesnelerinde şifreleri sağlayın; şifreli dosyaların işlenmesi ek yük getirir, bu yüzden mümkün olduğunda şifre çözme işleminden sonra birleştirin.

Bu uygulamaları benimsemek, PDF’leri Node.JS’te verimli bir şekilde birleştirmenize yardımcı olur ve bellek tüketimini en aza indirir.

Sahip Olabileceğiniz Sorular

• Node.JS’de GroupDocs kullanarak PDF dosyalarını nasıl birleştiririm?
  Node.js için GroupDocs.Merger Cloud SDK for Node.js kullanarak bir MergeApi örneği oluşturun, MergeOptions‘ı kaynak PDF’lerinizle yapılandırın ve mergeDocuments‘ı çağırın. Bu kılavuzdaki tam kod örneği süreci gösterir.

• Node.JS’te şifreli PDF dosyalarını birleştirebilir miyim?
  Evet, SDK şifreli PDF’leri birleştirmeyi destekler. mergeDocuments metodunu çağırmadan önce FileInfo nesnelerinde doğru şifreleri sağlayın. Ayrıntılar için resmi dokümantasyona bakın.

• GroupDocs.Merger için lisans seçenekleri nelerdir?
  GroupDocs esnek fiyatlandırma planları sunar. Test amacıyla, tam abonelik satın almadan önce kütüphaneyi değerlendirmek için bir geçici lisans isteyebilirsiniz.

• Daha fazla örnek ve destek nereden bulabilirim?
  Ek örnekler GitHub deposunda mevcuttur. Yardım için, destek forumunu ziyaret edin.

Daha Fazla Okuma

• Node.JS’te PDF’yi Birden Çok PDF’ye Böl
• Node.js’te REST API Kullanarak PDF Belgelerini Şifreyle Kilitle
• REST API Kullanarak C#’ta PDF Dosyalarını Birleştirme

Java’da PDF Belgelerine Görüntü Filigranı Ekleme 5 Adımda

1. API istemcisini başlatın: ApiClient örneğini istemci kimliğiniz ve gizli anahtarınızla oluşturun.

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

Bu adım, Java kodunuzu GroupDocs.Watermark Cloud hizmetine bağlar. Daha fazla ayrıntı için API referansına bakın.

2. Kaynak PDF dosyasını belirtin: İşaretlemek istediğiniz PDF’ye işaret eden bir FileInfo nesnesi oluşturun.

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

Dosya, istek yapılmadan önce GroupDocs depolama alanınıza yüklenmelidir.

3. Görüntü filigranını yapılandırın: Görüntü yolunu, opaklığı, ölçek faktörünü, dönüşü ve hizalamayı tanımlayın.

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

   İstenilen görünümü elde etmek için bu değerleri ayarlayın; opaklık şeffaflığı kontrol ederken, ölçek faktörü sayfaya göre boyutu belirler.

4. Filigran seçeneklerini ve çıktı yolunu ayarlayın: Dosya bilgisi ve filigranı bir WatermarkOptions nesnesine birleştirin.

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

   outputPath, hizmete oluşturulan PDF’nin nerede saklanacağını bildirir.

5. İsteği yürütün: Bir AddWatermarkRequest oluşturun ve API’yi çağırın. Başarı veya hata yanıtlarını işleyin.

   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());
   }
   

   Yürütmeden sonra, filigranlı PDF belirttiğiniz konumda bulunur.

Tam Kod Örneği: Java’da PDF Belgelerine Görüntü Filigranı Ekleme

Aşağıdaki örnek, istemci başlatmadan su işareti eklenmiş PDF’yi kaydetmeye kadar tam uygulamayı gösterir.

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();
        }
    }
}

Not: Bu kod örneği temel işlevselliği gösterir. Projenizde kullanmadan önce dosya yollarını (input.pdf, watermark.png, output.pdf) gerçek dosya konumlarınıza göre güncellediğinizden, tüm gerekli bağımlılıkların doğru şekilde yüklendiğinden emin olun ve geliştirme ortamınızda kapsamlı bir şekilde test edin. Herhangi bir sorunla karşılaşırsanız, lütfen resmi belgeler adresine bakın veya destek ekibi ile iletişime geçin.

cURL ve REST API ile PDF Belgelerine Görüntü Filigranı Uygulama

Aşağıda, Java kodu yazmadan aynı sonucu elde etmek için cURL ile kullanabileceğiniz REST çağrıları bulunmaktadır.

1. Erişim belirteci alın

   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"}'
   

   Yanıt, sonraki çağrılarda kullanılan bir access_token içerir.

2. Kaynak PDF’yi yükleyin

   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. Filigran görüntüsünü yükleyin

   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. Görüntü filigranı ekleyin

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"
         }'

Bu istek, Java kod mantığını yansıtarak aynı opaklık, ölçekleme ve hizalama ayarlarını uygular.

5. Filigranlı PDF’yi indirin

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

İstek gövdeleri ve desteklenen parametreler hakkında daha fazla ayrıntı için, resmi API belgelerine bakın.

Kurulum ve Yapılandırma GroupDocs.Watermark Cloud SDK for Java

Maven bağımlılığını pom.xml dosyanıza ekleyin (veya eşdeğer Gradle snippet’ini). Kütüphane Maven Central’da barındırılmaktadır.

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

Ayrıca geçerli bir GroupDocs Cloud hesabına da ihtiyacınız var. Client ID ve Client Secret değerlerinizi GroupDocs portalından alın. SDK bulut hizmetiyle iletişim kurduğundan ek bir çalışma zamanı kurulumu gerekmez.

PDF Belgeleri için Görüntü Filigran Seçeneklerini İnce Ayar Yapma

SDK, filigranın görsel görünümünü kontrol etmenizi sağlayan çeşitli özellikler sunar.

Opaklığı Ayarla

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

Opaklık değerleri 0.0 (tamamen şeffaf) ile 1.0 (tamamen opak) arasında değişir.

Ölçek Faktörünü Değiştir

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

Ölçek faktörü, filigran boyutunu sayfa boyutlarına göre belirler.

Hizalama ve Kenar Boşluklarını Ayarla

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

Bu ayarlar, filigranı sağ alt köşeye 20 puanlık bir kenar boşluğu ile yerleştirir.

Yapılandırılabilir özelliklerin tam listesi için, API referansına bakın.

Sonuç

Java’da PDF belgelerine resim filigranı eklemek, GroupDocs.Watermark Cloud SDK for Java kullandığınızda basit bir görevdir. SDK, tüm düşük seviyeli PDF manipülasyonunu yönetir ve opaklık, ölçekleme ve konumlandırma gibi görsel yönlere odaklanmanızı sağlar. Yerel bir Java uygulamasını mı yoksa bulut tabanlı bir cURL iş akışını mı tercih ederseniz edin, aynı yüksek kaliteli sonuçlar performanstan ödün vermeden elde edilebilir. Üretim kullanımı için uygun bir lisans almayı unutmayın; fiyatlandırma detayları ürün sayfasında mevcuttur ve değerlendirme için bir geçici lisans sayfası kullanılabilir.

FAQs

• Java’da kalite kaybı olmadan PDF’ye resim filigranı nasıl eklenir?
  scaleFactor özelliğini kullanarak filigranı sayfaya göre boyutlandırın ve kaynak PDF’nin orijinal DPI’sını koruyun. SDK, PDF’nin çözünürlüğünü korur, böylece filigran herhangi bir yakınlaştırma seviyesinde net görünür.

• Aynı PDF’ye birden fazla filigran ekleyebilir miyim?
  Evet. Farklı yapılandırmalara sahip ayrı ImageWatermark nesneleri oluşturun ve bunları addWatermark metodunu birden fazla kez çağırarak veya istekte bir listeye ekleyerek sıralı bir şekilde ekleyin.

• Filigran için desteklenen görüntü formatları nelerdir?
  API, PNG, JPG, BMP, GIF ve TIFF gibi yaygın görüntü türlerini kabul eder. PNG, kayıpsız kalite ve şeffaflık desteği nedeniyle önerilir.

• Uygulamadan önce filigranı önizlemenin bir yolu var mı?
  Filigranlı geçici bir PDF oluşturmak ve inceleme için indirmek için GroupDocs.Watermark Cloud SDK for Java’yı kullanabilirsiniz. Bu, aynı addWatermark çağrısını, çıkış yolunu geçici bir konuma işaret edecek şekilde kullanır.

Daha Fazla

• Java kullanarak Görsellere Filigran Ekle
• Java’da Word’e Filigran Ekle - Filigran Oluşturucu
• PDF’ye Görsel Filigran Ekle | .NET Kullanarak PDF Belgelerine Filigran Ekleme