モジュール java.xml

パッケージ org.w3c.dom

クラス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)

メソッドのサマリー

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

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

クラスjava.lang.Objectで宣言されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

フィールド詳細

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)