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にあります。