Java'da PDF'den Görüntü Filigranını Kaldır

İstenmeyen görüntü filigranları, PDF belgelerinin profesyonel görünümünü bozabilir ve sonraki işlemeyi engelleyebilir. GroupDocs.Watermark Cloud SDK for Java Java geliştiricilerine bu filigranları PDF dosyalarından programlı olarak kaldırma imkanı sağlayan sağlam bir API sunar. Bu kılavuz, SDK’nın kaldırma uç noktasını kullanarak Java’da PDF’den görüntü filigranını kaldırma gösterir. Sonunda, herhangi bir Java uygulamasına otomatik filigran kaldırma entegrasyonu yapabileceksiniz.

Java Geliştirme Ortamı - Önkoşullar ve Kurulum

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

Java 17 veya daha yeni bir sürüm yüklü.
Bağımlılık yönetimi için Maven veya Gradle.
Bir GroupDocs Cloud hesabı ve client ID ile client secret.

SDK’yı projenize aşağıdaki Maven bağımlılığıyla ekleyin (Gradle eşdeğerini de kullanabilirsiniz). En son ikili dosyalar indirme sayfasında mevcuttur.

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

API istemcisini kimlik bilgilerinizle başlatın. Bu kod parçacığı doğrudan örnek koddan alınmıştır.

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

İstemci hazır olduğunda, gerçek kaldırma iş akışına geçebilirsiniz.

Java’da PDF’den Görüntü Filigranını Kaldırmak için Adım Adım Kılavuz

Adım 1: Kaynak Belgeyi Yükleyin

İlk olarak, temizlemek istediğiniz PDF’yi belirtin. FileInfo nesnesi, API’ye dosyanın nerede olduğunu söyler ve isteğe bağlı olarak bir şifre sağlar.

FileInfo inputFile = new FileInfo();
inputFile.setFilePath("input.pdf");
// inputFile.setPassword("pdfPassword"); // Uncomment if needed

Adım 2: Görüntü Filigranı Kriterlerini Tanımlama

Silmek istediğiniz filigran görüntüsüne işaret eden bir ImageSearchCriteria oluşturun. Bu, Java’da PDF’ten görüntü filigranını kaldırma işleminin çekirdeğidir.

ImageSearchCriteria imageCriteria = new ImageSearchCriteria();
imageCriteria.setImagePath("watermark.png");

Adım 3: Kaldırma Seçeneklerini Ayarlama

Dosya bilgilerini ve arama kriterlerini bir RemoveOptions nesnesine birleştirin. Ayrıca temizlenmiş PDF’nin nerede kaydedileceğini tanımlarsınız.

RemoveOptions removeOptions = new RemoveOptions();
removeOptions.setFileInfo(inputFile);
removeOptions.setOutputPath("output.pdf");
removeOptions.setSearchCriteria(Collections.singletonList(imageCriteria));

Adım 4: Kaldırma Çağrısını Gerçekleştir

WatermarkApi üzerindeki remove metodunu çağırın. Çağrı, işlenmiş dosyanın yolunu içeren bir RemoveResult döndürür.

RemoveResult result = watermarkApi.remove(removeOptions);
System.out.println("Watermark removal completed. Output file: " + result.getPath());

Adım 5: Sonucu İşleyin

Karşılaşılabilecek tüm istisnaları ele alın. SDK, hizmet‑tarafı hataları için ApiException ve beklenmeyen sorunlar için genel Exception fırlatır.

try {
    // removal code above
} catch (ApiException e) {
    System.err.println("API exception occurred: " + e.getMessage());
} catch (Exception e) {
    System.err.println("Unexpected error: " + e.getMessage());
}

Tam Kod Örneği: GroupDocs Kullanarak Görüntü Filigranını Kaldırma

Aşağıdaki örnek, istemci başlatmadan sonuç işleme kadar tam iş akışını gösterir.

import com.groupdocs.watermark.cloud.api.WatermarkApi;
import com.groupdocs.watermark.cloud.client.ApiClient;
import com.groupdocs.watermark.cloud.client.ApiException;
import com.groupdocs.watermark.cloud.model.FileInfo;
import com.groupdocs.watermark.cloud.model.ImageSearchCriteria;
import com.groupdocs.watermark.cloud.model.RemoveOptions;
import com.groupdocs.watermark.cloud.model.RemoveResult;
import java.util.Collections;

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

// Prepare input file information
        FileInfo inputFile = new FileInfo();
        inputFile.setFilePath("input.pdf");
        // If the PDF is password protected, uncomment the following line and set the password
        // inputFile.setPassword("pdfPassword");

// Define the image watermark to be removed
        ImageSearchCriteria imageCriteria = new ImageSearchCriteria();
        imageCriteria.setImagePath("watermark.png");

// Set up removal options
        RemoveOptions removeOptions = new RemoveOptions();
        removeOptions.setFileInfo(inputFile);
        removeOptions.setOutputPath("output.pdf");
        removeOptions.setSearchCriteria(Collections.singletonList(imageCriteria));

try {
            // Execute removal
            RemoveResult result = watermarkApi.remove(removeOptions);
            System.out.println("Watermark removal completed. Output file: " + result.getPath());
        } catch (ApiException e) {
            System.err.println("API exception occurred: " + e.getMessage());
        } catch (Exception e) {
            System.err.println("Unexpected error: " + e.getMessage());
        }
    }
}

Not: Bu kod örneği temel işlevselliği gösterir. 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 belgeler adresine bakın veya destek ekibi ile iletişime geçin.

cURL kullanarak REST API üzerinden Filigran Kaldırma İşlemi

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

Kimlik doğrulaması yapın ve bir 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"}'

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=@/local/path/input.pdf"

Filigran kaldırma işlemini yürütün

curl -X POST "https://api.groupdocs.cloud/v2.0/watermark/remove" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": {"filePath":"input.pdf"},
           "outputPath":"output.pdf",
           "searchCriteria":[{"type":"Image","imagePath":"watermark.png"}]
         }'

Temizlenmiş 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

Tam referans için, API belgelerine bakın.

İnce Ayar Kaldırma Seçenekleri

SDK, farklı senaryolara uyacak şekilde ayarlayabileceğiniz çeşitli özellikler sunar.

Şifre Koruması - Kaynak PDF şifrelenmişse, şifreyi FileInfo üzerinde ayarlayın.

  inputFile.setPassword("mySecret");

Birden Çok Arama Kriteri - Listeye daha fazla ImageSearchCriteria nesnesi ekleyerek tek bir çağrıda birden fazla filigranı kaldırın.

  ImageSearchCriteria logoCriteria = new ImageSearchCriteria();
  logoCriteria.setImagePath("logo.png");
  removeOptions.setSearchCriteria(Arrays.asList(imageCriteria, logoCriteria));

Output Format - Varsayılan PDF olsa da, outputPath‘i farklı bir uzantı (ör. output.docx) belirleyerek çıktı formatını değiştirebilirsiniz.

  removeOptions.setOutputPath("output.docx");

Bu seçenekler, Java’da PDF’den resim filigranını kaldırma sürecini tam ihtiyaçlarınıza göre özelleştirmenizi sağlar.

Sonuç

PDF dosyalarından görüntü filigranını programlı olarak kaldırmak, GroupDocs.Watermark Cloud SDK for Java ile oldukça basittir. Yukarıdaki adımları izleyerek, filigran silmeyi herhangi bir Java backend’ine entegre edebilir, şifreli PDF’leri işleyebilir ve esnek seçeneklerle işlemi ince ayar yapabilirsiniz. Üretim kullanımı için uygun bir lisans almayı unutmayın; fiyatlandırma detayları ürün sayfasında mevcuttur ve geçici bir lisans geçici lisans sayfası üzerinden talep edilebilir. PDF’lerinizi bugün temizlemeye başlayın ve kullanıcılara düzenli belgeler sunun.

SSS

Java’da PDF’den görüntü filigranını nasıl kaldırırım?
WatermarkApi‘nin remove metodunu, filigran görüntüsüne işaret eden bir ImageSearchCriteria ile kullanın. Bu makaledeki tam kod örneği tam adımları gösterir.
PDF’im şifre korumalıysa ne olur?
Kaldırma API’sini çağırmadan önce FileInfo nesnesine şifreyi ayarlayın (inputFile.setPassword("yourPassword")). SDK dosyayı otomatik olarak çözecek, işleyip yeniden şifreleyecektir.
Diğer formatlardan, örneğin DOCX gibi, filigranları kaldırabilir miyim?
Evet. Aynı API, GroupDocs.Watermark tarafından desteklenen herhangi bir formatta çalışır. Sadece filePath ve outputPath uzantılarını buna göre değiştirin.
PDF’i işleyebileceğim dosya boyutu sınırlamaları var mı?
Bulut hizmeti, istekte 500 MB’a kadar dosyaları işler. Daha büyük belgeler için, işleme başlamadan önce PDF’i daha küçük parçalara bölmeyi düşünün.

Java Geliştirme Ortamı - Önkoşullar ve Kurulum#

Java’da PDF’den Görüntü Filigranını Kaldırmak için Adım Adım Kılavuz#

Adım 1: Kaynak Belgeyi Yükleyin#

Adım 2: Görüntü Filigranı Kriterlerini Tanımlama#

Adım 3: Kaldırma Seçeneklerini Ayarlama#

Adım 4: Kaldırma Çağrısını Gerçekleştir#

Adım 5: Sonucu İşleyin#

Tam Kod Örneği: GroupDocs Kullanarak Görüntü Filigranını Kaldırma#

cURL kullanarak REST API üzerinden Filigran Kaldırma İşlemi#

İnce Ayar Kaldırma Seçenekleri#

Sonuç#

SSS#

Read More#