クラスSAXParseException

java.lang.Object
java.lang.Throwable
java.lang.Exception
org.xml.sax.SAXException
org.xml.sax.SAXParseException
すべての実装されたインタフェース:
Serializable
public class SAXParseException extends SAXException
XML構文解析エラーまたは警告をカプセル化します。

Locatorオブジェクトから出たかのようなこの例外は、元のXML文書内のエラーの位置を突き止めるための情報を提供します。 アプリケーションはErrorHandlerインタフェース内のハンドラへの引数としてSAXParseExceptionを受け取りますが、実際に例外をスローする必要はありません。情報を確認して、別のアクションをとるだけでかまいません。

この例外はSAXExceptionのサブクラスなので、別の例外をラップする機能を継承しています。

導入されたバージョン:
1.4, SAX 1.0
関連項目:

  • コンストラクタのサマリー

    コンストラクタ
    コンストラクタ
    説明
    SAXParseException(String message, String publicId, String systemId, int lineNumber, int columnNumber)
    新しいSAXParseExceptionを生成します。
    SAXParseException(String message, String publicId, String systemId, int lineNumber, int columnNumber, Exception e)
    組込み例外を使って新しいSAXParseExceptionを生成します。
    SAXParseException(String message, Locator locator)
    メッセージとLocatorから新しいSAXParseExceptionを生成します。
    SAXParseException(String message, Locator locator, Exception e)
    既存の例外をSAXParseExceptionにラップします。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    int
    getColumnNumber()
    例外の発生元テキストの終わりの列番号です。
    int
    getLineNumber()
    例外の発生元テキストの終わりの行番号です。
    String
    getPublicId()
    例外の発生元エンティティの公開識別子を取得します。
    String
    getSystemId()
    例外の発生元エンティティのシステム識別子を取得します。
    String
    toString()
    toStringをオーバーライドして、より詳細なエラー・メッセージを提供します。

    クラスで宣言されたメソッド SAXException

    getCause, getException, getMessage
    修飾子と型
    メソッド
    説明
    Throwable
    getCause()
    この例外の原因を返します。
    Exception
    getException()
    組込み例外を返します(存在する場合)。
    String
    getMessage()
    この例外の詳細メッセージを返します。

    Throwableクラスで宣言されたメソッド

    addSuppressed, fillInStackTrace, getLocalizedMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace
    修飾子と型
    メソッド
    説明
    final void
    addSuppressed(Throwable exception)
    この例外を提供する目的で抑制された例外に、指定された例外を追加します。
    Throwable
    fillInStackTrace()
    実行スタック・トレースを埋め込みます。
    String
    getLocalizedMessage()
    このスロー可能オブジェクトの、ローカライズされた記述を作成します。
    StackTraceElement[]
    getStackTrace()
    Throwable.printStackTrace()によって出力されるスタック・トレース情報にプログラムでアクセスできるようにします。
    final Throwable[]
    getSuppressed()
    この例外を提供する目的で(通常try-with-resources文によって)抑制された例外をすべて含む配列を返します。
    Throwable
    initCause(Throwable cause)
    このスロー可能オブジェクトの原因を、指定された値に初期化します。
    void
    printStackTrace()
    このスロー可能オブジェクトおよびそのバックトレースを標準エラー・ストリームに出力します。
    void
    printStackTrace(PrintStream s)
    このスロー可能オブジェクトとそのバックトレースを指定された印刷ストリームに出力します。
    void
    printStackTrace(PrintWriter s)
    このスロー可能オブジェクトとそのバックトレースを指定されたプリント・ライターに出力します。
    void
    setStackTrace(StackTraceElement[] stackTrace)
    Throwable.getStackTrace()によって返され、Throwable.printStackTrace()と関連メソッドによって出力される、スタック・トレース要素を設定します。

    クラスオブジェクトで宣言されたメソッド

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
    修飾子と型
    メソッド
    説明
    protected Object
    clone()
    このオブジェクトのコピーを作成して、返します。
    boolean
    equals(Object obj)
    このオブジェクトと他のオブジェクトが等しいかどうかを示します。
    protected void
    finalize()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    最終決定は非推奨であり、将来のリリースで削除される可能性があります。
    final Class<?>
    getClass()
    このObjectの実行時クラスを返します。
    int
    hashCode()
    このオブジェクトに対するハッシュ・コード値を返します。
    final void
    notify()
    このオブジェクトのモニターで待機中のスレッドを1つ再開します。
    final void
    notifyAll()
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    final void
    wait()
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

  • コンストラクタの詳細

    • SAXParseException

      public SAXParseException(String message, Locator locator)
      メッセージとLocatorから新しいSAXParseExceptionを生成します。

      このコンストラクタは、アプリケーションがContentHandlerコールバック内から独自の例外を作成するときに特に役に立ちます。

      パラメータ:
      message - エラーまたは警告メッセージ。
      locator - エラーまたは警告のロケータ・オブジェクト(nullの場合もある)。
      関連項目:

    • SAXParseException

      public SAXParseException(String message, Locator locator, Exception e)
      既存の例外をSAXParseExceptionにラップします。

      このコンストラクタは、アプリケーションがContentHandlerコールバック内から独自の例外を生成し、SAXExceptionのサブクラスになっていない既存の例外をラップする必要がある場合に非常に便利です。

      パラメータ:
      message - エラー・メッセージ、警告メッセージ、またはnull。nullの場合は組込み例外のメッセージを利用する。
      locator - エラーまたは警告のロケータ・オブジェクト(nullの場合もある)。
      e - 任意の例外。
      関連項目:

    • SAXParseException

      public SAXParseException(String message, String publicId, String systemId, int lineNumber, int columnNumber)
      新しいSAXParseExceptionを生成します。

      このコンストラクタは、主にパーサーの作成者を対象としています。

      メッセージを除き、すべてのパラメータは、Locatorから提供された場合と同じになります。 たとえば、システム識別子がURL (関連するファイル名を含む)である場合、呼出し側は、例外を生成する前にこれを完全に解決する必要があります。

      パラメータ:
      message - エラーまたは警告メッセージ。
      publicId - エラーまたは警告を生成したエンティティの公開識別子。
      systemId - エラーまたは警告を生成したエンティティのシステム識別子。
      lineNumber - エラーまたは警告の原因となったテキストの終わりの行番号。
      columnNumber - エラーまたは警告の原因となったテキストの終わりの列番号。

    • SAXParseException

      public SAXParseException(String message, String publicId, String systemId, int lineNumber, int columnNumber, Exception e)
      組込み例外を使って新しいSAXParseExceptionを生成します。

      このコンストラクタは、主に、SAXExceptionのサブクラスになっていない例外をラップする必要があるパーサーの作成者を対象としています。

      メッセージと例外を除き、すべてのパラメータは、Locatorから提供された場合と同じになります。 たとえば、システム識別子がURL (関連するファイル名を含む)である場合、呼出し側は、例外を生成する前にこれを完全に解決する必要があります。

      パラメータ:
      message - エラー・メッセージ、警告メッセージ、またはnull。nullの場合は組込み例外のメッセージを利用する。
      publicId - エラーまたは警告を生成したエンティティの公開識別子。
      systemId - エラーまたは警告を生成したエンティティのシステム識別子。
      lineNumber - エラーまたは警告の原因となったテキストの終わりの行番号。
      columnNumber - エラーまたは警告の原因となったテキストの終わりの列番号。
      e - この例外に組み込む別の例外。

  • メソッドの詳細

    • getPublicId

      public String getPublicId()
      例外の発生元エンティティの公開識別子を取得します。
      戻り値:
      公開識別子を含む文字列。使用できない場合はnull。
      関連項目:

    • getSystemId

      public String getSystemId()
      例外の発生元エンティティのシステム識別子を取得します。

      システム識別子がURLである場合、完全に解決されます。

      戻り値:
      システム識別子を含む文字列。使用できない場合はnull。
      関連項目:

    • getLineNumber

      public int getLineNumber()
      例外の発生元テキストの終わりの行番号です。

      行1は最初の行です。

      戻り値:
      行番号を表す整数値。使用できない場合は -1。
      関連項目:

    • getColumnNumber

      public int getColumnNumber()
      例外の発生元テキストの終わりの列番号です。

      列1は行内の最初の列です。

      戻り値:
      列番号を表す整数値。使用できない場合は -1。
      関連項目:

    • toString

      public String toString()
      toStringをオーバーライドして、より詳細なエラー・メッセージを提供します。
      オーバーライド:
      toString、クラスSAXException
      戻り値:
      この例外の文字列表現。