JavaTM Platform
Standard Ed. 6

javax.xml.bind.annotation
클래스 W3CDomHandler

java.lang.Object 
  상위를 확장 javax.xml.bind.annotation.W3CDomHandler
모든 구현된 인터페이스:
DomHandler <Element ,DOMResult >


public class W3CDomHandler
extends Object
implements DomHandler <Element ,DOMResult >

W3C DOM (org.w3c.dom 패키지) 용 DomHandler 구현

도입된 버젼:
JAXB2. 0

생성자 의 개요
W3CDomHandler ()
          디폴트 생성자 입니다.
W3CDomHandler (DocumentBuilder  builder)
          사용하는 DOM 구현을 어플리케이션을 지정할 수 있는 생성자 입니다.
 
메소드의 개요
 DOMResult createUnmarshaller (ValidationEventHandler  errorHandler)
          문서의 일부를 정보 세트 표현에 비정렬화할 필요가 있는 경우, JAXB 프로바이더는 최초로 이 메소드를 호출해 Result 객체를 작성합니다.
 DocumentBuilder getBuilder ()
           
 Element getElement (DOMResult  r)
          일부가 Result 에 한 번 송신된 뒤에 사용됩니다.
 Source marshal (Element  element, ValidationEventHandler  errorHandler)
          JAXB 프로바이더가 요소를 XML 에 정렬화할 필요가 있는 경우, 이 메소드는 불려 갑니다.
 void setBuilder (DocumentBuilder  builder)
           
 
클래스 java.lang. Object 로부터 상속된 메소드
clone , equals , finalize , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait
 

생성자 의 상세

W3CDomHandler

public W3CDomHandler()
디폴트 생성자 입니다. 사용하는 DOM 구현이나 설정 방법법에 대한 결정은, JAXB 프로바이더에 맡길 수 있습니다.


W3CDomHandler

public W3CDomHandler(DocumentBuilder  builder)
사용하는 DOM 구현을 어플리케이션을 지정할 수 있는 생성자 입니다.

파라미터:
builder - null 이외. JAXB 는 이 DocumentBuilder 를 사용해 새로운 요소를 작성한다
메소드의 상세

getBuilder

public DocumentBuilder  getBuilder()

setBuilder

public void setBuilder(DocumentBuilder  builder)

createUnmarshaller

public DOMResult  createUnmarshaller(ValidationEventHandler  errorHandler)
인터페이스 DomHandler 의 기술:
문서의 일부를 정보 세트 표현에 비정렬화할 필요가 있는 경우, JAXB 프로바이더는 최초로 이 메소드를 호출해 Result 객체를 작성합니다.

그 후, JAXB 프로바이더는 XML 의 일부를, 주어진 결과내에 송신합니다. 이러한 XML 의 일부는 항상, 어느 요소를 루트로 하는 XML 문서 전체의 서브 트리를 형성합니다.

정의:
인터페이스 DomHandler <Element ,DOMResult > 내의 createUnmarshaller
파라미터:
errorHandler - 이 메소드의 호출과 DomHandler.getElement(Result) 의 호출동안에 에러가 발생했을 경우, 에러가 이 핸들러에 보고될 필요가 있다 호출측은, null 가 아닌 에러 핸들러를 제공할 필요가 있습니다. 이 메소드로부터 작성된 Result 객체가 이 에러 핸들러에의 참조를 보관 유지하는 경우가 있습니다.
반환값:
처리가 실패했을 경우, null. 에러는 에러 핸들러에 보고되지 않으면 안 된다

getElement

public Element  getElement(DOMResult  r)
인터페이스 DomHandler 의 기술:
일부가 Result 에 한 번 송신된 뒤에 사용됩니다. 이 메소드는, 비정렬화 된 요소 표현을 취득하기 위해서 JAXB 프로바이더에 의해 불려 갑니다.

이 메소드를 여러 차례 호출했을 경우, 다른 객체가 돌려주어질 가능성이 있습니다. 이 메소드는, 서브 트리 전체가 Result 객체에 보내졌을 경우만 호출할 수가 있습니다.

정의:
인터페이스 DomHandler <Element ,DOMResult > 내의 getElement
파라미터:
r - DomHandler.createUnmarshaller(ValidationEventHandler) 로 작성된 Result 객체
반환값:
처리가 실패했을 경우, null. 에러는 에러 핸들러에 보고되지 않으면 안 된다

marshal

public Source  marshal(Element  element,
                      ValidationEventHandler  errorHandler)
인터페이스 DomHandler 의 기술:
JAXB 프로바이더가 요소를 XML 에 정렬화할 필요가 있는 경우, 이 메소드는 불려 갑니다.

반환값 Source 가 null 이외의 경우, 어느 요소를 루트로 하는 문서 전체를 포함할 것이어, 후에 그것은 JAXB 가 정렬화하는 것보다 큰 문서내에 짜넣어집니다.

정의:
인터페이스 DomHandler <Element ,DOMResult > 내의 marshal
errorHandler - 요소를 Source 로 변환하고 있는 도중에 발생한 에러를 받는다 호출측은, null 가 아닌 에러 핸들러를 제공할 필요가 있습니다.
반환값:
에러가 발생했을 경우, null. 에러는 에러 핸들러에 보고되어야 함

JavaTM Platform
Standard Ed. 6

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.