クラスDOMException

java.lang.Object
java.lang.Throwable
java.lang.Exception
java.lang.RuntimeException
org.w3c.dom.DOMException
すべての実装されたインタフェース:
Serializable
public class DOMException extends RuntimeException
DOM操作によって例外が発生するのは、ごく「例外的な」場合のみです。たとえば、論理上の問題、データの損失、実装の安定性の欠如などが原因で操作を実行できない場合にのみ、例外が発生します。 通常の処理状況では、DOMメソッドは例外ではなく、特定のエラー値を返します(NodeListの使用時における範囲外(out-of-bound)エラーなど)。

実装は、それ以外の状況でもさまざまな例外を返します。 たとえば、nullが予想されないときに、null引数が渡されると、実装依存の例外が発生することもあります。

一部の言語システムおよびオブジェクト・システムは、例外の概念をサポートしていません。 このようなシステムでは、ネイティブのエラー・レポート・メカニズムによってエラー条件が示されます。 たとえば、一部のバインディングでは、メソッドが対応するメソッド記述に含まれているコードと同様のエラー・コードを返します。

「Document Object Model (DOM) Level 3 Core Specification」も参照してください。

導入されたバージョン:
1.4、DOMレベル2
関連項目:

  • フィールドのサマリー

    フィールド
    修飾子と型
    フィールド
    説明
    short
    code
     
    static final short
    DOMSTRING_SIZE_ERR
    指定されたテキスト範囲がDOMString内に収まらない場合。
    static final short
    HIERARCHY_REQUEST_ERR
    Nodeが所属先以外に挿入された場合。
    static final short
    INDEX_SIZE_ERR
    インデックスまたはサイズが負の数または許容値より大きい場合。
    static final short
    INUSE_ATTRIBUTE_ERR
    すでにほかで使用されている属性を追加しようとした場合。
    static final short
    INVALID_ACCESS_ERR
    パラメータまたは操作が基本となるオブジェクトによってサポートされていない場合。
    static final short
    INVALID_CHARACTER_ERR
    XML名などに不正な文字列、無効な文字列が指定された場合。
    static final short
    INVALID_MODIFICATION_ERR
    基本となるオブジェクト型を変更しようとした場合。
    static final short
    INVALID_STATE_ERR
    使用できないオブジェクトを使用しようとした場合。
    static final short
    NAMESPACE_ERR
    不正な名前空間を使ってオブジェクトを作成または変更しようとした場合。
    static final short
    NO_DATA_ALLOWED_ERR
    データをサポートしないNodeに対してデータが指定された場合。
    static final short
    NO_MODIFICATION_ALLOWED_ERR
    変更が許可されていないオブジェクトを変更しようとした場合。
    static final short
    NOT_FOUND_ERR
    コンテキスト内に存在しないNodeを参照しようとした場合。
    static final short
    NOT_SUPPORTED_ERR
    実装が要求されたオブジェクト型または操作をサポートしていない場合。
    static final short
    SYNTAX_ERR
    不正な文字列、無効な文字列が指定された場合。
    static final short
    TYPE_MISMATCH_ERR
    オブジェクトの型が、オブジェクトに関連するパラメータの予想される型と互換性がない場合。
    static final short
    VALIDATION_ERR
    insertBeforeやremoveChildといったメソッドへの呼出しで、「部分的有効性」の面でNodeが無効になる場合は、この例外がスローされ、操作は完了しません。
    static final short
    WRONG_DOCUMENT_ERR
    Nodeが作成元文書以外(このノードをサポートしない文書)で使用された場合。

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

    コンストラクタ
    コンストラクタ
    説明
    DOMException(short code, String message)
     

  • メソッドのサマリー

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

    addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
    修飾子と型
    メソッド
    説明
    final void
    addSuppressed(Throwable exception)
    この例外を提供する目的で抑制された例外に、指定された例外を追加します。
    Throwable
    fillInStackTrace()
    実行スタック・トレースを埋め込みます。
    Throwable
    getCause()
    このスロー可能オブジェクトの原因を返しますが、原因が存在しないか不明な場合はnullを返します。
    String
    getLocalizedMessage()
    このスロー可能オブジェクトの、ローカライズされた記述を作成します。
    String
    getMessage()
    このスロー可能オブジェクトの詳細メッセージ文字列を返します。
    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()と関連メソッドによって出力される、スタック・トレース要素を設定します。
    String
    toString()
    このスロー可能オブジェクトの短い記述を返します。

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

    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であるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

  • フィールド詳細

    • code

      public short code

    • INDEX_SIZE_ERR

      public static final short INDEX_SIZE_ERR
      インデックスまたはサイズが負の数または許容値より大きい場合。
      関連項目:

    • DOMSTRING_SIZE_ERR

      public static final short DOMSTRING_SIZE_ERR
      指定されたテキスト範囲がDOMString内に収まらない場合。
      関連項目:

    • HIERARCHY_REQUEST_ERR

      public static final short HIERARCHY_REQUEST_ERR
      Nodeが所属先以外に挿入された場合。
      関連項目:

    • WRONG_DOCUMENT_ERR

      public static final short WRONG_DOCUMENT_ERR
      Nodeが作成元文書以外(このノードをサポートしない文書)で使用された場合。
      関連項目:

    • INVALID_CHARACTER_ERR

      public static final short INVALID_CHARACTER_ERR
      XML名などに不正な文字列、無効な文字列が指定された場合。
      関連項目:

    • NO_DATA_ALLOWED_ERR

      public static final short NO_DATA_ALLOWED_ERR
      データをサポートしないNodeに対してデータが指定された場合。
      関連項目:

    • NO_MODIFICATION_ALLOWED_ERR

      public static final short NO_MODIFICATION_ALLOWED_ERR
      変更が許可されていないオブジェクトを変更しようとした場合。
      関連項目:

    • NOT_FOUND_ERR

      public static final short NOT_FOUND_ERR
      コンテキスト内に存在しないNodeを参照しようとした場合。
      関連項目:

    • NOT_SUPPORTED_ERR

      public static final short NOT_SUPPORTED_ERR
      実装が要求されたオブジェクト型または操作をサポートしていない場合。
      関連項目:

    • INUSE_ATTRIBUTE_ERR

      public static final short INUSE_ATTRIBUTE_ERR
      すでにほかで使用されている属性を追加しようとした場合。
      関連項目:

    • INVALID_STATE_ERR

      public static final short INVALID_STATE_ERR
      使用できないオブジェクトを使用しようとした場合。
      導入されたバージョン:
      1.4、DOMレベル2
      関連項目:

    • SYNTAX_ERR

      public static final short SYNTAX_ERR
      不正な文字列、無効な文字列が指定された場合。
      導入されたバージョン:
      1.4、DOMレベル2
      関連項目:

    • INVALID_MODIFICATION_ERR

      public static final short INVALID_MODIFICATION_ERR
      基本となるオブジェクト型を変更しようとした場合。
      導入されたバージョン:
      1.4、DOMレベル2
      関連項目:

    • NAMESPACE_ERR

      public static final short NAMESPACE_ERR
      不正な名前空間を使ってオブジェクトを作成または変更しようとした場合。
      導入されたバージョン:
      1.4、DOMレベル2
      関連項目:

    • INVALID_ACCESS_ERR

      public static final short INVALID_ACCESS_ERR
      パラメータまたは操作が基本となるオブジェクトによってサポートされていない場合。
      導入されたバージョン:
      1.4、DOMレベル2
      関連項目:

    • VALIDATION_ERR

      public static final short VALIDATION_ERR
      insertBeforeやremoveChildといったメソッドへの呼出しで、「部分的有効性」の面でNodeが無効になる場合は、この例外がスローされ、操作は完了しません。 このコードは「DOM Level 3 Validation」で使用されます。 詳細については、この仕様を参照してください。
      導入されたバージョン:
      1.5、DOMレベル3
      関連項目:

    • TYPE_MISMATCH_ERR

      public static final short TYPE_MISMATCH_ERR
      オブジェクトの型が、オブジェクトに関連するパラメータの予想される型と互換性がない場合。
      導入されたバージョン:
      1.5、DOMレベル3
      関連項目:

  • コンストラクタの詳細

    • DOMException

      public DOMException(short code, String message)