PDF 例外処理

PDF例外とは、Java PDFライブラリ内で発生する可能性のある問題や予期しない事象のことです。JPedalはこれらの問題を可能な限り適切に処理しようと試みます。JPedalはプログラムの動作とすべてのメッセージを記録するログファイルを生成するように設定できます。

PDFファイルで発生する可能性のある問題

PDFファイルが破損している場合。 PDFファイルは独自のインデックスを持つ複雑なバイナリ構造です。PDFファイルが暗号化されていない場合、JPedalはPDFファイル内のPDFオブジェクトを手動で識別しようと試みます。復旧が不可能な場合、JPedalは問題の詳細を含む PdfException をスローします。ファイルが暗号化されている場合は、PdfSecurityException がスローされます。

PDFファイルが暗号化されている場合。 PDFファイルには、ファイルへの一般的なアクセスを防ぐための暗号化設定が含まれている場合があります。ユーザーはPDFファイルにアクセスするためにパスワードを入力する必要がある場合があります（JPedalはパスワードを設定するためのルーチンを提供しています）。ユーザーが有効なパスワードを入力していない場合、PdfSecurityException がスローされます。

PDFファイルのデコード時にメモリエラーが発生する場合。 非常に大きな画像を含むPDFファイルの中には、大量のメモリを必要とするものがあります。JPedalは復旧を試み、ログファイルに [MEMORY] という接頭辞を付けたメッセージを生成します。

PDFファイルに軽微な問題がある場合。 PDFファイルには、重大な問題を引き起こさない軽微な問題が含まれている場合があります。その場合、ログファイルに [PDF] という接頭辞を付けたメッセージが書き込まれます。

PDFファイルに重大な問題がある場合。 PDFファイルに重大な問題が含まれている場合、詳細情報を提供する PdfException がスローされます。

その他の問題。 その他のPDF関連の問題が発生した場合は、PDFファイルをお送りください。問題の詳細とともにお送りいただければ、正しく解析され、発生した問題が上記のように適切に処理されるようにいたします。JPedalは処理を継続できる場合は常にメッセージをログに記録します。発生した可能性のある問題を確認する最善の方法は、org.jpedal.PdfDecoder.getPageDecodeStatus(int type) を使用することです。ここで type は org.jpedal.parser.DecodeStatus で定義されている任意の値です。

使用例は org.jpedal.examples.viewer.gui.SwingGUI に示されています。