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에 서는 예외를 Throw 할 수 없습니다. 핸들러로부터 예외를 Throw 하는 효과는 DOM 구현에 따라서 다릅니다.

파라미터:

operation - 노드로 실행되고 있는 조작의 종류를 지정

key - 핸들러가 불려가 고 있는 키를 지정

data - 핸들러가 불려가 고 있는 데이터를 지정

src - 복제, 거두어 들여 임포트, 또는 이름의 변경을 실시하고 있는 노드를 지정. 노드가 삭제되고 있는 경우는 null

dst - 새롭게 작성된 노드를 지정 (존재하는 경우). 존재하지 않는 경우는 null