[PDFBOX-5805] Replace IOException on PDF parsing

• Type: Improvement
• Status: Open
• Priority: Major
• Resolution: Unresolved
• Affects Version/s: 2.0.31
• Assignee: Unassigned
• Reporter: Aleksandr Beliakov
• Created: 16/Apr/24 12:23
• Updated: 16/Apr/24 12:32

Description

Classes like PDFParser, COSParser and other throw an IOException in case of an issue within PDF document structure. This makes it impossible to differentiate programmatically an IOException returned because of the file or InputStream reading issue (for instance a not accessible, corrupted input file/stream) against an exception returned because of an issue within PDF structure.

Would it be possible to introduce a new exception class (for instance, PDFParserException) and throw that exception in case of parsing-related issues? A new class (optionally) may extend IOException in order to provide a smooth migration for the end-user.