[PDFBOX-1474] PDDocument.decrypt does not throws InvalidPasswordException

• Type: Bug
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 1.7.1, 1.8.5, 1.8.6, 2.0.0
• Fix Version/s: 1.8.6, 2.0.0
• Component/s: Documentation
• Labels: decrypt
• Environment: All
• Assignee: Tilman Hausherr
• Reporter: Josue Martinez Buenrrostro
• Created: 19/Dec/12 23:18
• Updated: 22/Jun/14 14:34
• Resolved: 11/Jun/14 13:46

Description

PDDocument.decrypt does not throws InvalidPasswordException

The documentation say the method should throw "InvalidPasswordException" but it doest't i suggest either:

correct the Exception methods throws
or
correct the javadoc

The method for this version is:

/**

• This will decrypt a document. This method is provided for compatibility reasons only. User should use
• the new security layer instead and the openProtection method especially.
  *
• @param password Either the user or owner password.
  *
• @throws CryptographyException If there is an error decrypting the document.
• @throws IOException If there is an error getting the stream data.
• @throws InvalidPasswordException If the password is not a user or owner password.
  *
  */
  public void decrypt( String password ) throws CryptographyException, IOException, InvalidPasswordException
  Unknown macro: { try { StandardDecryptionMaterial m = new StandardDecryptionMaterial(password); this.openProtection(m); document.dereferenceObjectStreams(); } catch(BadSecurityHandlerException e) { throw new CryptographyException(e); } }