8.10.4 ErrorHandler オブジェクト

このインターフェースのオブジェクトは XMLReader からのエラーや警告の情報を受け取るために使われます。このインターフェースを実装したオブジェクトを作成し XMLReader に登録すると、パーサは警告やエラーの通知のためにそのオブジェクトのメソッドを呼び出すようになります。エラーには警告、回復可能エラー、回復不能エラーの3段階があります。すべてのメソッドは SAXParseException だけをパラメータとして受け取ります。受け取った例外オブジェクトを raise することで、エラーや警告は例外に変換されることもあります。

error( exception): パーサが回復可能なエラーを検知すると呼び出されます。このメソッドが例外を raise しないとパースは継続されますが、アプリケーション側ではエラー以降のドキュメント情報を期待していないこともあります。パーサが処理を継続した場合、入力ドキュメント内のほかのエラーを見つけることができます。

fatalError( exception): パーサが回復不能なエラーを検知すると呼び出されます。このメソッドが return した後、すぐにパースを停止することが求められています。

warning( exception): パーサが軽微な警告情報をアプリケーションに通知するために呼び出されます。このメソッドが return した後もパースを継続し、ドキュメント情報をアプリケーションに送り続けるよう求められています。このメソッドで例外を発生させた場合、パースは中断されてしまいます。

ご意見やご指摘をお寄せになりたい方は、 このドキュメントについて... をご覧ください。