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 に示されています。