org.w3c.dom
介面 UserDataHandler

public interface UserDataHandler

當使用 Node.setUserData() 將一個對象與節點上的鍵相關聯時，當複製、導入或重命名該物件關聯的節點時應用程序可以提供調用的處理程序。應用程序可以使用此方法實作與它與 DOM 節點相關聯的資料有關的各種行為。此介面定義該處理程序。

另請參見 Document Object Model (DOM) Level 3 Core Specification。

從以下版本開始：

DOM Level 3

欄位摘要

static short	NODE_ADOPTED 使用 Document.adoptNode() 採用節點。
static short	NODE_CLONED 使用 Node.cloneNode() 複製節點。
static short	NODE_DELETED 刪除節點。
static short	NODE_IMPORTED 使用 Document.importNode() 導入節點。
static short	NODE_RENAMED 使用 Document.renameNode() 重命名節點。

方法摘要

void	handle(short operation, String key, Object data, Node src, Node dst) 每當導入或複製為其註冊此處理程序的節點時，調用此方法。

欄位詳細資訊

NODE_CLONED

static final short NODE_CLONED

使用 Node.cloneNode() 複製節點。

另請參見：

常數欄位值

NODE_IMPORTED

static final short NODE_IMPORTED

使用 Document.importNode() 導入節點。

另請參見：

常數欄位值

NODE_DELETED

static final short NODE_DELETED

刪除節點。

註：在某些環境（如 Java）中，此方法可能不被支持或可能不可靠，在此情況下，實作不具備真正控制何時實際刪除物件。

另請參見：

常數欄位值

NODE_RENAMED

static final short NODE_RENAMED

使用 Document.renameNode() 重命名節點。

另請參見：

常數欄位值

NODE_ADOPTED

static final short NODE_ADOPTED

使用 Document.adoptNode() 採用節點。

另請參見：

常數欄位值

方法詳細資訊

handle

void handle(short operation,
            String key,
            Object data,
            Node src,
            Node dst)

每當導入或複製為其註冊此處理程序的節點時，調用此方法。
DOM 應用程序不能在 UserDataHandler 中引發異常。從處理程序拋出異常所產生的影響與 DOM 實作有關。

參數：

operation - 指定在節點上正在執行的操作的型別。

key - 指定正在為其調用此處理程序的鍵。

data - 指定正在為其調用此處理程序的資料。

src - 指定正在被複製、採用、導入或重命名的節點。正在刪除節點時，這為 null。

dst - 指定新創建的節點（如果有），或 null。