DOMException (Java 2 Platform SE 6)

概觀

軟體套件

類別

使用

階層樹

已過時

索引

說明

Java^TM 2 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)

概觀