Details
-
Improvement
-
Status: Closed
-
Major
-
Resolution: Fixed
-
2.0.0
Description
In the PDF specification a "security handler" is defined in the "encryption dictionary", but in PDFBox the security handler belongs to the document itself.
It is not difficult to move the SecurityHandler field of PDDocument to the PDEncryptionDictionary class, and we can do so without introducing any breaking changes.
We can deprecate methods at this point rather than removing them, until we're happy with feedback.
Also, we generally don't use the postfix "Dictionary" because most classes in the PD model represent dictionaries anyway, so we should rename PDEncryptionDictionary to PDEncryption. Luckily we can just deprecate the old class and add a new subclass with the desired name. This avoids breaking changes until we're happy with the new state of things.