Giriş

Bir hukuk departmanı birden fazla sözleşme PDF’si aldığında, her inceleyici genellikle gizli maddeleri korumak için kendi şifresini ekler. Bu dosyaları tek bir klasörde birleştirmek, şifrelerin farklı olması ve dosyaların doğrudan birleştirilememesi nedeniyle bir kabusa dönüşür. Manuel şifre çözme, özellikle onlarca PDF ile uğraşırken zaman alıcı ve hataya açıktır.

Password‑merge, heterojen PDF’leri açan ve birleştirilmiş sonucu tek bir kimlik bilgisiyle yeniden koruyan bir GroupDocs.Merger Java iş akışıdır. Bu öğreticide korumalı PDF’lerin tespiti, açılması, içeriğin birleştirilmesi ve isteğe bağlı olarak birleşik şifrenin döndürülmesi adımları anlatılmaktadır.

Merger API’sını nasıl yapılandıracağınızı, bayt akışlarını nasıl işleyeceğinizi ve 30 satırdan az Java kodu ile güvenli bir birleşik PDF oluşturacağınızı öğreneceksiniz.

Şifre‑korumalı PDF’leri Ne Zaman Birleştirmeliyim?

Şifre‑korumalı PDF’leri birleştirmek, birden çok şifreyle uğraşmadan güvenlik politikalarına uygun, tek bir aranabilir arşiv gerektiğinde mantıklıdır. Tipik senaryolar arasında çeyrek dönem finansal rapor paketleri, denetimler için sözleşme klasörleri ve her katılımcının farklı bir şifre uyguladığı hukuk dosyaları bulunur. Her dosyayı programlı olarak açıp birleşik bir şifre uygulayarak arşivi güvenli tutar ve sonraki inceleme süreçlerini basitleştirirsiniz. Bu işlem bir CI boru hattında otomatikleştirilebilir ve saatler süren manuel çalışmayı tasarruf ettirir.

Önkoşullar

  • Java 11 veya üzeri
  • GroupDocs.Merger for Java 24.6+ (temporary license)
  • Her biri isteğe bağlı olarak şifresi olan bir PDF dosyası seti

Kütüphaneyi Maven üzerinden kurun:

mvn dependency:copy -Dartifact=com.groupdocs:groupdocs-merger:24.6

Adım 1 – Bir PDF’nin şifre‑korumalı olup olmadığını tespit edin

Bir dosyayı açmaya çalışmadan önce gerçekten şifre içerip içermediğini kontrol edin. Bu, gereksiz işleme engel olur ve hangi dosyaların kimlik bilgisine ihtiyaç duyduğunu kaydetmenizi sağlar.

// Returns true if the PDF at `path` has an owner or user password
public boolean isDocumentProtected(String path, String password) {
    Merger merger;
    if (password == null || password.isEmpty()) {
        merger = new Merger(path);
    } else {
        merger = new Merger(path, new LoadOptions(password));
    }
    try {
        return merger.isPasswordSet();
    } finally {
        merger.dispose();
    }
}

Temel noktalar:

  • LoadOptions bilinen bir şifre taşır; hiç şifre verilmezse dosya normal şekilde açılır.
  • isPasswordSet() hem sahibi hem de kullanıcı şifreleri için true döndürür.
  • Yerel kaynakları serbest bırakmak için Merger örneğini her zaman dispose edin.

Adım 2 – Her PDF’yi açın ve ham baytları toplayın

Anahtarın dosya yolu, değerin ise şifresi (yoksa null) olduğu bir harita üzerinde döngü yapın. Metod, açılmış PDF’leri temsil eden bayt dizileri listesini döndürür.

public List<byte[]> unlockAll(Map<String, String> sources) throws IOException {
    List<byte[]> unlocked = new ArrayList<>();
    for (Map.Entry<String, String> e : sources.entrySet()) {
        String path = e.getKey();
        String password = e.getValue();
        System.out.println("Unlocking (credentials=" +
                (password != null ? "yes" : "no") + "): " + path);
        if (password == null || password.isEmpty()) {
            unlocked.add(Files.readAllBytes(Paths.get(path)));
        } else {
            LoadOptions opts = new LoadOptions(password);
            ByteArrayOutputStream buf = new ByteArrayOutputStream();
            Merger m = new Merger(path, opts);
            try {
                m.removePassword();
                m.save(buf);
            } finally {
                m.dispose();
            }
            unlocked.add(buf.toByteArray());
        }
    }
    return unlocked;
}

Temel noktalar:

  • removePassword() mevcut korumayı kaldırır.
  • Şifrelenmemiş içerik, bellek içinde işlemek için bir ByteArrayOutputStream‘a yazılır.
  • Şifresi olmayan dosyalar, akışı basit tutmak için doğrudan okunur.

Adım 3 – Açılmış PDF’leri birleştirin ve birleşik bir şifre uygulayın

İlk PDF akışından bir Merger oluşturun, ardından kalan akışları ekleyin. Son olarak, birleşik belgeyi AddPasswordOptions ile koruyun.

public void mergeAndProtect(List<byte[]> unlockedPdfs,
                            String unifiedPassword,
                            String outputPath) {
    InputStream first = new ByteArrayInputStream(unlockedPdfs.get(0));
    Merger merger = new Merger(first);
    try {
        for (int i = 1; i < unlockedPdfs.size(); i++) {
            merger.join(new ByteArrayInputStream(unlockedPdfs.get(i)));
        }
        merger.addPassword(new AddPasswordOptions(unifiedPassword));
        merger.save(outputPath);
    } finally {
        merger.dispose();
    }
    System.out.println("Merged output: " + new File(outputPath).getAbsolutePath());
    System.out.println("Unified password: " + unifiedPassword);
}

Temel noktalar:

  • addPassword son PDF’yi sağlanan kimlik bilgisiyle şifreler.
  • Tüm işlemler bellek içinde gerçekleşir; yalnızca nihai dosya diske yazılır.
  • Yerel tutamaçları serbest bırakmak için Merger nesnesini dispose edin.

Adım 4 – Zaten korumalı bir PDF’de şifreyi döndürün (isteğe bağlı)

Kuruluşunuz periyodik şifre değişimini zorunlu kılıyorsa, kaynak dosyaları yeniden birleştirmeden kimlik bilgisini güncelleyebilirsiniz.

public void rotateUnifiedPassword(String path,
                                 String oldPassword,
                                 String newPassword,
                                 String outputPath) {
    Merger merger = new Merger(path, new LoadOptions(oldPassword));
    try {
        merger.updatePassword(new UpdatePasswordOptions(newPassword));
        merger.save(outputPath);
    } finally {
        merger.dispose();
    }
    System.out.println("Rotated output: " + new File(outputPath).getAbsolutePath());
    System.out.println("New password: " + newPassword);
}

Temel noktalar:

  • Korunan PDF’yi mevcut şifreyle yükleyin.
  • updatePassword yeni kimlik bilgisiyle değiştirir.
  • PDF içeriği yeniden işlenmediği için bu işlem çok hızlıdır.

Gerçek Dünya Uygulaması

Beş yatırımcı sözleşmesini birleştirirken her birinin farklı bir inceleyici şifresi olduğunu gördüm. Yukarıdaki adımları izleyerek tüm dosyaları açtım, tek bir klasörde birleştirdim ve şirket politikamıza uygun tek bir şifre uyguladım. Tüm süreç standart bir dizüstü bilgisayarda iki dakikadan kısa sürdü.

En İyi Uygulamalar

  • Şifreleri erken doğrulayın: isDocumentProtected kullanarak manuel müdahale gerektirebilecek dosyaları işaretleyin.
  • Bellek kullanımını sınırlayın: Büyük PDF’ler için bayt dizileri yerine akışları diske yönlendirin.
  • Nesneleri zamanında serbest bırakın: Merger sınıfı yerel kaynak tutar; her zaman bir finally bloğunda dispose() çağırın.
  • Geçici lisansı sadece geliştirme için kullanın; üretim öncesi bir lisans edinin.

Sonuç

GroupDocs.Merger for Java, PDF koleksiyonlarını açma, birleştirme ve yeniden güvence altına alma için temiz bir API sunar. Koruma tespiti, açma, birleşik şifreyle birleştirme ve isteğe bağlı şifre döndürme adımlarını izleyerek manuel müdahale olmadan güvenli PDF klasörleri oluşturabilirsiniz.

Sonraki adımlar:

  • Birleştirmeden sonra PDF meta verilerini ayarlama gibi ek seçenekleri keşfedin (documentation).
  • Yer imlerini koruyarak PDF birleştirmeyi öğrenin (API reference).
  • Hazır‑çalıştır örnek uygulama için GitHub’daki tam örnek projeye göz atın.

Ek Kaynaklar