Úvod

Když právní oddělení obdrží více PDF smluv, každý recenzent často přidá své vlastní heslo pro ochranu důvěrných ustanovení. Konsolidace těchto souborů do jedné složky se stane noční můrou, protože hesla se liší a soubory nelze přímo sloučit. Ruční dešifrování je časově náročné a náchylné k chybám, zejména při práci s desítkami PDF.

Password‑merge je workflow GroupDocs.Merger pro Java, které odemkne heterogenní PDF a znovu ochrání sloučený výsledek jedním heslem. Tento tutoriál vás provede detekcí chráněných PDF, jejich odemčením, sloučením obsahu a volitelným rotováním jednotného hesla.

Naučíte se, jak nakonfigurovat Merger API, zpracovávat proudy bajtů a vytvořit zabezpečené kombinované PDF v méně než 30 řádcích Java kódu.

Kdy bych měl slučovat PDF chráněné heslem?

Slučování PDF chráněných heslem má smysl vždy, když potřebujete jediný, prohledávatelný archiv, který respektuje bezpečnostní politiky a zároveň eliminuje zátěž spojenou se správou více hesel. Typické scénáře zahrnují čtvrtletní balíčky finančních zpráv, svazky smluv pro audity a právní spisy, kde každý přispěvatel použil jiné heslo. Odemčením každého souboru programově a aplikací jednotného hesla udržíte archiv zabezpečený a zjednodušíte následné procesy revize. Celá operace může být automatizována v CI pipeline, čímž ušetříte hodiny manuální práce.

Požadavky

  • Java 11 nebo novější
  • GroupDocs.Merger for Java 24.6+ (temporary license)
  • Sada PDF souborů, z nichž každý může mít přiřazené heslo

Instalace knihovny pomocí Maven:

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

Krok 1 – Detekce, zda je PDF chráněné heslem

Než se pokusíte soubor odemknout, zkontrolujte, zda skutečně obsahuje heslo. Tím se vyhnete zbytečnému zpracování a můžete zaznamenat, které soubory potřebují přihlašovací údaje.

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

Klíčové body:

  • LoadOptions nese známé heslo; pokud není poskytnuto, soubor se otevře normálně.
  • isPasswordSet() vrací true jak pro vlastníka, tak pro uživatelské heslo.
  • Vždy uvolněte instanci Merger pomocí dispose(), aby se uvolnily nativní zdroje.

Krok 2 – Odemknutí každého PDF a sběr surových bajtů

Iterujte přes mapu, kde klíč je cesta k souboru a hodnota je jeho heslo (null, pokud žádné). Metoda vrací seznam pole bajtů představujících odemčená PDF.

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

Klíčové body:

  • removePassword() odstraní existující ochranu.
  • Dešifrovaný obsah se zapisuje do ByteArrayOutputStream pro práci v paměti.
  • Soubory bez hesla se čtou přímo, aby byl tok zjednodušen.

Krok 3 – Sloučení odemčených PDF a aplikace jednotného hesla

Vytvořte Merger z prvního PDF proudu a poté připojte zbývající proudy. Nakonec chraňte kombinovaný dokument pomocí AddPasswordOptions.

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

Klíčové body:

  • addPassword zašifruje finální PDF pomocí zadaných přihlašovacích údajů.
  • Veškeré operace probíhají v paměti; na disk se zapíše jen výsledný soubor.
  • Uvolněte Merger, aby se uvolnily nativní handly.

Krok 4 – Rotace hesla u již chráněného PDF (volitelné)

Pokud vaše organizace vyžaduje periodickou rotaci hesel, můžete aktualizovat přihlašovací údaje bez opětovného slučování zdrojových souborů.

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

Klíčové body:

  • Načtěte chráněné PDF se současným heslem.
  • updatePassword jej nahradí novým přihlašovacím údajem.
  • Tato operace je rychlá, protože nepřetváří obsah PDF.

Praktické použití

Setkal jsem se s tím při konsolidaci pěti investičních smluv, z nichž každá měla jiné heslo recenzenta. Pomocí výše uvedených kroků jsem odemkl všechny soubory, sloučil je do jedné svazky a aplikoval jediné heslo, které odpovídalo naší firemní politice. Celý proces proběhl za méně než dvě minuty na běžném notebooku.

Nejlepší postupy

  • Ověřujte hesla včas: Použijte isDocumentProtected k označení souborů, které mohou vyžadovat ruční zásah.
  • Omezte využití paměti: U velkých PDF je vhodnější je streamovat na disk místo uchovávání všech bajtových polí v paměti.
  • Okamžitě uvolňujte objekty: Třída Merger drží nativní zdroje; vždy volajte dispose() v bloku finally.
  • Používejte dočasnou licenci pouze pro vývoj; před nasazením získáte produkční licenci.

Závěr

GroupDocs.Merger for Java poskytuje čisté API pro odemykání, slučování a opětovné zabezpečování kolekcí PDF. Dodržením čtyř kroků – detekce ochrany, odemknutí, sloučení s jednotným heslem a volitelná rotace hesla – můžete automatizovat tvorbu zabezpečených PDF svazků bez manuálního zásahu.

Další kroky:

  • Prozkoumejte další možnosti, jako je nastavení PDF metadat po sloučení (documentation).
  • Naučte se slučovat PDF při zachování záložek (API reference).
  • Podívejte se na kompletní ukázkový projekt na GitHubu, který je připraven k okamžitému spuštění.

Další zdroje