ErrorHandler

SAX エラーハンドラの基本インターフェイスです。

説明

SAX アプリケーションがカスタムのエラー処理の実行を必要とする場合、このインターフェイスを実装し、XMLReader.set-error-handler メソッドを使用してインスタンスを XML リーダーに登録することが必要です。その後、パーサーがこのインターフェイスを通じてすべてのエラーと警告をレポートします。

警告：アプリケーションが ErrorHandler を登録しないと、XML 解析エラーがレポートされずに不適切な動作が生じる可能性があります。たとえ、ErrorHandler が無い場合、または、ErrorHandler.fatal-error メソッドが正常に復帰する場合でも、致命的エラーによって例外がスローされる可能性があります。

XML 処理エラーに関しては、SAX ドライバは例外をスローするのではなく、必ずこのインターフェイスを使用する必要があります。他の型のエラーや警告について、例外をスローするかどうかはアプリケーションの判断によります。ただし、パーサーは ErrorHandler.fatal-error 呼び出し後は、継続して有用な情報を提供する義務はないことに注意してください (SAX ドライバクラスは例外をキャッチして重大なエラーをレポートできます)。

注意事項

参照：SAXParseException

メソッド継承 Object: object-describe, object-describe-for-debugging, object-serialize

error (メソッド)

修復可能なエラーの通知を受け取ります。

exception: SAX 解析例外内にカプセル化されたエラー情報。

説明

これは、『W3C XML 1.0 Recommendation, section 1.2』のエラーの定義に対応しています。たとえば、検証パーサーはこのコールバックを使用して有効性の制約違反をレポートします。既定の動作はアクションなしです。

SAX パーサーは、このメソッドを起動した後、通常の解析イベントを継続して供給することが必要です。アプリケーションがドキュメントを最後まで処理することはまだ可能です。アプリケーションがドキュメントを最後まで処理できない場合は、『XML 1.0 Recommendation』で義務付けられていなくても、パーサーが重大なエラーをレポートする必要があります。

他の非 XML エラーをレポートするためにフィルタがこのメソッドを使用することもできます。

注意事項

参照：SAXParseException

fatal-error (メソッド)

修復不可能なエラーの通知を受け取ります。

exception: SAX 解析例外内にカプセル化されたエラー情報。

説明

これは、『W3C XML 1.0 Recommendation, section 1.2』の重大なエラーの定義に対応しています。たとえば、検証パーサーはこのコールバックを使用して有効なフォーマットの制約違反をレポートします。

パーサーがこのメソッドを起動した後は、アプリケーションはドキュメントが使用不可能であると想定して、追加のエラーメッセージ取得 (ある場合) の目的のみで継続しなければなりません。実際、SAX パーサーはいったんこのメソッドが起動された後は、他のイベントのレポートを自由に停止できます。

注意事項

参照：SAXParseException

warning (メソッド)

警告通知を受け取ります。

exception: SAX 解析例外内にカプセル化された警告情報。

説明

SAX パーサーはこのメソッドを使用して、『XML 1.0 Recommendation』で定義されているエラーや重大なエラーでない状態をレポートします。既定の動作はアクションなしです。

SAX パーサーは、このメソッドを起動した後、通常の解析イベントを継続して供給することが必要です。アプリケーションがドキュメントを最後まで処理することはまだ可能です。

他の非 XML 警告をレポートするためにフィルタがこのメソッドを使用することもできます。

注意事項

参照：SAXParseException