DOMException (Java Platform SE 6)

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM Platform
Standard Ed. 6

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

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
extends RuntimeException

DOM 操作只在 "exceptional" 情况下引发异常，即不能执行操作时（由于逻辑原因，因为丢失数据或因为实现变得不稳定）。通常，DOM 方法在普通处理情况下返回特定的错误值，如使用 NodeList 时的超出边界错误。

实现应该在其他情况下引发其他异常。例如，如果不期望是 null 时传递 null 参数，则实现应该引发一个与实现有关的异常。

有些语言和对象系统不支持异常的概念。对于这样的系统，可以使用本机错误报告机制指示错误情况。例如，对于一些绑定，方法可以返回错误代码，它们类似于在相应方法描述中列出的错误代码。

另请参见 Document Object Model (DOM) Level 3 Core Specification。

另请参见：: 序列化表格

字段摘要
`short`	`code`
`static short`	`DOMSTRING_SIZE_ERR` 如果文本的指定范围不适合 `DOMString`。
`static short`	`HIERARCHY_REQUEST_ERR` 如果在不属于 `Node` 的位置将任何 `Node` 插入。
`static short`	`INDEX_SIZE_ERR` 如果索引或大小为负，或大于允许的值。
`static short`	`INUSE_ATTRIBUTE_ERR` 如果试图添加已经在其他位置使用的属性。
`static short`	`INVALID_ACCESS_ERR` 如果基础对象不支持某个参数或操作。
`static short`	`INVALID_CHARACTER_ERR` 如果指定无效或非法字符，如在 XML 名称中。
`static short`	`INVALID_MODIFICATION_ERR` 如果试图修改基础对象的类型。
`static short`	`INVALID_STATE_ERR` 如果试图使用不可用或不再可用的对象。
`static short`	`NAMESPACE_ERR` 如果试图以一种与名称空间有关的错误的方式创建或更改一个对象。
`static short`	`NO_DATA_ALLOWED_ERR` 如果为不支持数据的 `Node` 指定数据。
`static short`	`NO_MODIFICATION_ALLOWED_ERR` 如果试图在不允许修改的位置修改对象。
`static short`	`NOT_FOUND_ERR` 如果试图在它不存在的上下文中引用 `Node`。
`static short`	`NOT_SUPPORTED_ERR` 如果实现不支持请求类型的对象或操作。
`static short`	`SYNTAX_ERR` 如果指定无效或非法字符串。
`static short`	`TYPE_MISMATCH_ERR` 如果对象的类型和与此对象相关联的参数的期望类型不兼容。
`static short`	`VALIDATION_ERR` 如果调用诸如 `insertBefore` 或 `removeChild` 之类的方法使 `Node` 无效(和 "partial validity" 有关的），则引发此异常并且将不进行操作。
`static short`	`WRONG_DOCUMENT_ERR` 如果 `Node` 用于不同的文档而不是创建它的文档（该文档不支持它）。

构造方法摘要
`DOMException(short code, String message)`

方法摘要

从类 java.lang.Throwable 继承的方法
`fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, 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 的位置将任何 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

如果试图使用不可用或不再可用的对象。

从以下版本开始：: DOM Level 2
另请参见：: 常量字段值

SYNTAX_ERR

public static final short SYNTAX_ERR

如果指定无效或非法字符串。

从以下版本开始：: DOM Level 2
另请参见：: 常量字段值

INVALID_MODIFICATION_ERR

public static final short INVALID_MODIFICATION_ERR

如果试图修改基础对象的类型。

从以下版本开始：: DOM Level 2
另请参见：: 常量字段值

NAMESPACE_ERR

public static final short NAMESPACE_ERR

如果试图以一种与名称空间有关的错误的方式创建或更改一个对象。

从以下版本开始：: DOM Level 2
另请参见：: 常量字段值

INVALID_ACCESS_ERR

public static final short INVALID_ACCESS_ERR

如果基础对象不支持某个参数或操作。

从以下版本开始：: DOM Level 2
另请参见：: 常量字段值

VALIDATION_ERR

public static final short VALIDATION_ERR

如果调用诸如 insertBefore 或 removeChild 之类的方法使 Node 无效(和 "partial validity" 有关的），则引发此异常并且将不进行操作。此代码用于 [DOM Level 3 Validation]。更多的信息，请参见此规范。

从以下版本开始：: DOM Level 3
另请参见：: 常量字段值

TYPE_MISMATCH_ERR

public static final short TYPE_MISMATCH_ERR

如果对象的类型和与此对象相关联的参数的期望类型不兼容。

从以下版本开始：: DOM Level 3
另请参见：: 常量字段值

构造方法详细信息

DOMException

public DOMException(short code,
                    String message)

概述