DOMException (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 5.0

上一个类 下一个类

框架 无框架

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

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

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

字段摘要
`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)

概述