JavaTM 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

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
          如果调用诸如 insertBeforeremoveChild 之类的方法使 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
如果调用诸如 insertBeforeremoveChild 之类的方法使 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)

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策