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