javax.xml.bind.helpers
클래스 AbstractUnmarshallerImpl

java.lang.Object 
  javax.xml.bind.helpers.AbstractUnmarshallerImpl

모든 구현된 인터페이스:

Unmarshaller

public abstract class AbstractUnmarshallerImpl
extends Object 
implements Unmarshaller 

부분적인 디폴트 Unmarshaller 구현입니다.

이 클래스는,Unmarshaller 인터페이스의 부분적인 디폴트 구현을 제공합니다.

JAXB 프로바이더는, getUnmarshallerHandler, unmarshal(Node), unmarshal(XMLReader, InputSource), unmarshal(XMLStreamReader), 및 unmarshal(XMLEventReader)의 5 개의 메소드를 구현할 필요가 있습니다 .

도입된 버젼:

JAXB1. 0

관련 항목:

Unmarshaller

상자의 클래스의 개요

인터페이스 javax.xml.bind. Unmarshaller 로부터 상속된 상자의 클래스/인터페이스

Unmarshaller.Listener

필드의 개요

protected boolean

validating unmarshaller 가 검증을 실시할지 어떨지

생성자 의 개요

AbstractUnmarshallerImpl ()

메소드의 개요

protected UnmarshalException	createUnmarshalException (SAXException e) SAXException 로부터 UnmarshalException 를 작성합니다.
<A extends XmlAdapter > A	getAdapter (Class <A> type) 지정한 형태에 관련지을 수 있고 있는 어댑터를 가져옵니다.
AttachmentUnmarshaller	getAttachmentUnmarshaller ()
ValidationEventHandler	getEventHandler () 현재의 이벤트 핸들러, 또는, 그것이 설정되어 있지 않은 경우는 디폴트 이벤트 핸들러를 돌려줍니다.
Unmarshaller.Listener	getListener () 이 Unmarshaller 에 등록되어 있는 Unmarshaller.Listener 를 돌려줍니다.
Object	getProperty (String name) 필요한 프로퍼티이 없기 때문에, getProperty 메소드의 디폴트 구현은 항상, PropertyException 를 throw 합니다.
Schema	getSchema () 비정렬화시의 검증에 사용되고 있는 JAXP 1.3 Schema 객체를 가져옵니다.
protected XMLReader	getXMLReader () 설정된 XMLReader 를 가져옵니다.
boolean	isValidating () 비정렬화 조작중에 검증하도록(듯이) Unmarshaller 가 설정되어 있는지 어떤지를 나타냅니다.
<A extends XmlAdapter > void	setAdapter (Class <A> type, A adapter) XmlAdapter 의 설정 끝난 인스턴스를 이 Unmarshaller 에 관련짓습니다.
void	setAdapter (XmlAdapter adapter) XmlAdapter 의 설정 끝난 인스턴스를 이 Unmarshaller 에 관련짓습니다.
void	setAttachmentUnmarshaller (AttachmentUnmarshaller au) cid, 컨텐츠 ID URI 를, 첨부로서 건네받은 바이너리 데이터에 해결하는 문맥을 관련짓습니다.
void	setEventHandler (ValidationEventHandler handler) 어플리케이션이 검증 이벤트 핸들러를 등록할 수가 있습니다.
void	setListener (Unmarshaller.Listener listener) 이 Unmarshaller 에 비정렬화 이벤트 콜백 Unmarshaller.Listener 를 등록합니다.
void	setProperty (String name, Object value) 필요한 프로퍼티이 없기 때문에, setProperty 메소드의 디폴트 구현은 항상, PropertyException 를 throw 합니다.
void	setSchema (Schema schema) 후의 비정렬화 조작의 검증에 사용하는, JAXP 1.3 Schema 객체를 지정합니다.
void	setValidating (boolean validating) 비정렬화 조작중에 Unmarshaller 가 검증을 실시할지 어떨지를 지정합니다.
Object	unmarshal (File f) 지정된 파일로부터 XML 데이터를 비정렬화해, 결과의 컨텐츠 트리를 돌려줍니다.
Object	unmarshal (InputSource source) 지정된 SAX InputSource 로부터 XML 데이터를 비정렬화해, 결과의 컨텐츠 트리를 돌려줍니다.
Object	unmarshal (InputStream is) 지정된 InputStream 로부터 XML 데이터를 비정렬화해, 결과의 컨텐츠 트리를 돌려줍니다.
<T> JAXBElement <T>	unmarshal (Node node, Class <T> expectedType) JAXB 맵 declaredType 에 의해 XML 데이터를 비정렬화해, 결과의 컨텐츠 트리를 돌려줍니다.
Object	unmarshal (Reader reader) 지정된 Reader 로부터 XML 데이터를 비정렬화해, 결과의 컨텐츠 트리를 돌려줍니다.
Object	unmarshal (Source source) 지정된 XML Source 로부터 XML 데이터를 비정렬화해, 결과의 컨텐츠 트리를 돌려줍니다.
<T> JAXBElement <T>	unmarshal (Source source, Class <T> expectedType) declaredType 에 근거해, 지정된 XML Source 로부터 XML 데이터를 비정렬화해, 결과의 컨텐츠 트리를 돌려줍니다.
Object	unmarshal (URL url) 지정된 URL 로부터 XML 데이터를 비정렬화해, 결과의 컨텐츠 트리를 돌려줍니다.
Object	unmarshal (XMLEventReader reader) 지정된 프르파서로부터 XML 데이터를 비정렬화해, 결과의 컨텐츠 트리를 돌려줍니다.
<T> JAXBElement <T>	unmarshal (XMLEventReader reader, Class <T> expectedType) JAXB 맵 declaredType 에 루트 요소를 비정렬화해, 결과의 컨텐츠 트리를 돌려줍니다.
protected abstract Object	unmarshal (XMLReader reader, InputSource source) 지정한 XMLReader 와 InputSource 를 사용해, 객체를 비정렬화합니다.
Object	unmarshal (XMLStreamReader reader) 지정된 프르파서로부터 XML 데이터를 비정렬화해, 결과의 컨텐츠 트리를 돌려줍니다.
<T> JAXBElement <T>	unmarshal (XMLStreamReader reader, Class <T> expectedType) JAXB 맵 declaredType 에 루트 요소를 비정렬화해, 결과의 컨텐츠 트리를 돌려줍니다.

클래스 java.lang. Object 로부터 상속된 메소드

clone , equals , finalize , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait

인터페이스 javax.xml.bind. Unmarshaller 로부터 상속된 메소드

getUnmarshallerHandler , unmarshal

필드의 상세

validating

protected boolean validating

unmarshaller 가 검증을 실시할지 어떨지

생성자 의 상세

AbstractUnmarshallerImpl

public AbstractUnmarshallerImpl()

메소드의 상세

getXMLReader

protected XMLReader  getXMLReader()
                          throws JAXBException 

설정된 XMLReader 를 가져옵니다. 이 메소드는, 클라이언트가 지정한 SAXSource 객체에 XMLReader 가 없는 경우에 사용됩니다. Unmarshaller 는 재입 불가능하기 때문에, XMLReader 의 단일의 인스턴스만이 사용됩니다.

예외:

JAXBException

unmarshal

public Object  unmarshal(Source  source)
                 throws JAXBException 

인터페이스 Unmarshaller 의 기술:

지정된 XML Source 로부터 XML 데이터를 비정렬화해, 결과의 컨텐츠 트리를 돌려줍니다.

글로벌 루트 요소의 비정렬화를 구현합니다.

플러그 인 가능한 SAX 2.0 퍼서

클라이언트 어플리케이션은, 그 JAXB 프로바이더로 제공되고 있는 디폴트 퍼서 기구를 사용하지 않는 것을 선택할 수 있습니다. 임의의 SAX 2.0 준거 퍼서를, JAXB 프로바이더의 디폴트 기구에 치환할 수가 있습니다. 이것을 실시하기 (위해)때문에, 클라이언트 어플리케이션은, SAX 2.0 퍼서 프로바이더가 구현하고 있는 XMLReader 를 포함한 SAXSource 를 적절히 설정할 필요가 있습니다. XMLReader 에 org.xml.sax.ErrorHandler 가 등록되어 있는 경우, 그것이 JAXB 프로바이더에 의해 옮겨놓을 수 있어 검증 에러는 JAXB 의 ValidationEventHandler 기구를 개입시켜 보고될 가능성이 있습니다. SAXSource 에 XMLReader 가 포함되지 않는 경우, JAXB 프로바이더의 디폴트 퍼서 기구가 사용됩니다.

이 퍼서 치환 기구는, JAXB 프로바이더의 비정렬화시의 검증 엔진의 치환에도 사용할 수 있습니다. 클라이언트 어플리케이션은, (전술의 예에 나타낸 것처럼) 그 SAX 2.0 준거 퍼서가 검증을 실행하도록(듯이) 적절히 설정할 필요가 있습니다. 비정렬화 조작중에 퍼서가 SAXParserExceptions 에 조우하면(자), JAXB 프로바이더가 그것을 처리해, JAXB ValidationEvent 객체에 변환됩니다. 이 객체는,Unmarshaller 에 등록되어 있는 ValidationEventHandler 를 개입시켜 클라이언트에 보고됩니다. 주: 비정렬화에 대체의 검증 SAX 2.0 퍼서를 지정했을 경우에서도, On Demand의 검증을 실행하기 위해서 JAXB 프로바이더가 사용하는 검증 엔진은 반드시 옮겨놓을 수 없습니다.

비정렬화중에 사용되는 다른 퍼서 기구를 클라이언트 어플리케이션을 지정할 수 있는 유일한 방법은,unmarshal(SAXSource) API 를 개입시키는 방법입니다. 비정렬화 메소드의 다른 모든 형식 (File, URL, Node 등)은, JAXB 프로바이더의 디폴트의 퍼서와 발리 데이터 기구를 사용합니다.

정의:

인터페이스 Unmarshaller 내의 unmarshal

파라미터:

source - 비정렬화하는 XML 데이터가 포함되는 XML Source (프로바이더는, SAXSource, DOMSource, StreamSource 를 지원할 필요가 있을 뿐)

반환값:

새롭게 작성되는 Java 컨텐츠 트리의 루트 객체

예외:

JAXBException - 비정렬화의 실행중에 예상외의 에러가 발생했을 경우

UnmarshalException - ValidationEventHandler 의 handleEvent 메소드로부터 false 가 반환되는지, 또는 Unmarshaller 가 XML 로부터 Java 에의 바인딩을 실행 할 수 없는 경우. 「XML 데이터의 비정렬화」를 참조

관련 항목:

Unmarshaller.unmarshal(javax.xml.transform.Source, Class)

unmarshal

protected abstract Object  unmarshal(XMLReader  reader,
                                    InputSource  source)
                             throws JAXBException 

지정한 XMLReader 와 InputSource 를 사용해, 객체를 비정렬화합니다. 불려 가는 측은, XMLReader 의 setErrorHandler 메소드를 호출해, 에러가 클라이언트 지정의 ValidationEventHandler 에게 건네지도록 해 주세요.

예외:

JAXBException

unmarshal

public final Object  unmarshal(InputSource  source)
                       throws JAXBException 

인터페이스 Unmarshaller 의 기술:

지정된 SAX InputSource 로부터 XML 데이터를 비정렬화해, 결과의 컨텐츠 트리를 돌려줍니다.

글로벌 루트 요소의 비정렬화를 구현합니다.

정의:

인터페이스 Unmarshaller 내의 unmarshal

파라미터:

source - 비정렬화하는 XML 데이터가 포함되는 입력 소스

반환값:

새롭게 작성되는 Java 컨텐츠 트리의 루트 객체

예외:

JAXBException - 비정렬화의 실행중에 예상외의 에러가 발생했을 경우

UnmarshalException - ValidationEventHandler 의 handleEvent 메소드로부터 false 가 반환되는지, 또는 Unmarshaller 가 XML 로부터 Java 에의 바인딩을 실행 할 수 없는 경우. 「XML 데이터의 비정렬화」를 참조

unmarshal

public final Object  unmarshal(URL  url)
                       throws JAXBException 

인터페이스 Unmarshaller 의 기술:

지정된 URL 로부터 XML 데이터를 비정렬화해, 결과의 컨텐츠 트리를 돌려줍니다.

글로벌 루트 요소의 비정렬화를 구현합니다.

정의:

인터페이스 Unmarshaller 내의 unmarshal

파라미터:

url - 비정렬화하는 XML 데이터가 포함되는 URL

반환값:

새롭게 작성되는 Java 컨텐츠 트리의 루트 객체

예외:

JAXBException - 비정렬화의 실행중에 예상외의 에러가 발생했을 경우

UnmarshalException - ValidationEventHandler 의 handleEvent 메소드로부터 false 가 반환되는지, 또는 Unmarshaller 가 XML 로부터 Java 에의 바인딩을 실행 할 수 없는 경우. 「XML 데이터의 비정렬화」를 참조

unmarshal

public final Object  unmarshal(File  f)
                       throws JAXBException 

인터페이스 Unmarshaller 의 기술:

지정된 파일로부터 XML 데이터를 비정렬화해, 결과의 컨텐츠 트리를 돌려줍니다.

글로벌 루트 요소의 비정렬화를 구현합니다.

정의:

인터페이스 Unmarshaller 내의 unmarshal

파라미터:

f - 비정렬화하는 XML 데이터가 포함되는 파일

반환값:

새롭게 작성되는 Java 컨텐츠 트리의 루트 객체

예외:

JAXBException - 비정렬화의 실행중에 예상외의 에러가 발생했을 경우

UnmarshalException - ValidationEventHandler 의 handleEvent 메소드로부터 false 가 반환되는지, 또는 Unmarshaller 가 XML 로부터 Java 에의 바인딩을 실행 할 수 없는 경우. 「XML 데이터의 비정렬화」를 참조

unmarshal

public final Object  unmarshal(InputStream  is)
                       throws JAXBException 

인터페이스 Unmarshaller 의 기술:

지정된 InputStream 로부터 XML 데이터를 비정렬화해, 결과의 컨텐츠 트리를 돌려줍니다. 이 형식의 비정렬화 API 를 사용했을 경우, 검증 이벤트의 위치 정보가 불완전한 경우가 있습니다.

글로벌 루트 요소의 비정렬화를 구현합니다.

정의:

인터페이스 Unmarshaller 내의 unmarshal

파라미터:

is - 비정렬화하는 XML 데이터가 포함되는 InputStream

반환값:

새롭게 작성되는 Java 컨텐츠 트리의 루트 객체

예외:

JAXBException - 비정렬화의 실행중에 예상외의 에러가 발생했을 경우

UnmarshalException - ValidationEventHandler 의 handleEvent 메소드로부터 false 가 반환되는지, 또는 Unmarshaller 가 XML 로부터 Java 에의 바인딩을 실행 할 수 없는 경우. 「XML 데이터의 비정렬화」를 참조

unmarshal

public final Object  unmarshal(Reader  reader)
                       throws JAXBException 

인터페이스 Unmarshaller 의 기술:

지정된 Reader 로부터 XML 데이터를 비정렬화해, 결과의 컨텐츠 트리를 돌려줍니다. 이 형식의 비정렬화 API 를 사용했을 경우, Reader 는 시스템 ID 를 제공하지 않기 때문에, 검증 이벤트의 위치 정보가 불완전한 경우가 있습니다.

글로벌 루트 요소의 비정렬화를 구현합니다.

정의:

인터페이스 Unmarshaller 내의 unmarshal

파라미터:

reader - 비정렬화하는 XML 데이터가 포함되는 Reader

반환값:

새롭게 작성되는 Java 컨텐츠 트리의 루트 객체

예외:

JAXBException - 비정렬화의 실행중에 예상외의 에러가 발생했을 경우

UnmarshalException - ValidationEventHandler 의 handleEvent 메소드로부터 false 가 반환되는지, 또는 Unmarshaller 가 XML 로부터 Java 에의 바인딩을 실행 할 수 없는 경우. 「XML 데이터의 비정렬화」를 참조

isValidating

public boolean isValidating()
                     throws JAXBException 

비정렬화 조작중에 검증하도록(듯이) Unmarshaller 가 설정되어 있는지 어떤지를 나타냅니다.

주: getValidating()에 대해서, JAXP 에 맞추어 isValidating()라고 하는 메소드명으로 했습니다.

정의:

인터페이스 Unmarshaller 내의 isValidating

반환값:

Unmarshaller 가 비정렬화 조작중에 검증을 실행하도록(듯이) 설정되어 있다 경우, true. 그 이외의 경우, false

예외:

JAXBException - 검증 플래그의 취득중에 에러가 발생했을 경우

setEventHandler

public void setEventHandler(ValidationEventHandler  handler)
                     throws JAXBException 

어플리케이션이 검증 이벤트 핸들러를 등록할 수가 있습니다.

검증 이벤트 핸들러는, 몇개의 unmarshal 메소드를 호출하고 있는 도중에 검증 에러가 발생했을 경우, JAXB 프로바이더에 의해 불려 갑니다. 비정렬화 메소드를 호출하기 전에, 클라이언트 어플리케이션이 검증 이벤트 핸들러를 등록하지 않았던 경우, 모든 검증 이벤트는 통지되는 일 없이 무시되어 예상외의 동작을 일으킬 가능성이 있습니다.

정의:

인터페이스 Unmarshaller 내의 setEventHandler

파라미터:

handler - 검증 이벤트 핸들러

예외:

JAXBException - 이벤트 핸들러의 설정중에 에러가 발생했을 경우

setValidating

public void setValidating(boolean validating)
                   throws JAXBException 

비정렬화 조작중에 Unmarshaller 가 검증을 실시할지 어떨지를 지정합니다. 디폴트에서는,Unmarshaller 는 검증을 실시하지 않습니다.

이 메소드는, 비정렬화 메소드의 어느쪽이든을 호출하기 전, 또는 호출한 뒤에, 호출할 수가 있습니다.

정의:

인터페이스 Unmarshaller 내의 setValidating

파라미터:

validating - Unmarshaller 가 비정렬화중에 검증해야 할 경우, true 그 이외의 경우, false

예외:

JAXBException - 비정렬화시의 검증을 유효 또는 무효로 하고 있는 도중에 에러가 발생했을 경우

getEventHandler

public ValidationEventHandler  getEventHandler()
                                       throws JAXBException 

현재의 이벤트 핸들러, 또는, 그것이 설정되어 있지 않은 경우는 디폴트 이벤트 핸들러를 돌려줍니다.

정의:

인터페이스 Unmarshaller 내의 getEventHandler

반환값:

현재의 ValidationEventHandler, 또는, 그것이 설정되어 있지 않은 경우, 디폴트 이벤트 핸들러

예외:

JAXBException - 현재의 이벤트 핸들러의 취득중에 에러가 발생했을 경우

createUnmarshalException

protected UnmarshalException  createUnmarshalException(SAXException  e)

SAXException 로부터 UnmarshalException 를 작성합니다. 이것은, 상속 클래스에 제공되는 유틸리티 메소드입니다.

프로바이더가 구현한 ContentHandler 가 JAXBException 를 throw 하는 것을 바라는 경우, SAXException 에 의해 그 예외를 랩 할 필요가 있습니다. unmarshaller 구현이 JAXBException 에 의해 SAXException 를 마구에 랩 했을 경우, 이러한 예외가 다른 JAXBException 에 의해 랩 된 SAXException 에 의해 랩 된 JAXBException 가 됩니다. 이것은 매우 무익합니다.

이 메소드는, SAXException 의 상자의 예외를 체크해, 이러한 과잉인 랩을 배제합니다.

반환값:

결과의 UnmarshalException

setProperty

public void setProperty(String  name,
                        Object  value)
                 throws PropertyException 

필요한 프로퍼티이 없기 때문에, setProperty 메소드의 디폴트 구현은 항상, PropertyException 를 throw 합니다. 프로바이더는 추가 프로퍼티을 취급할 필요가 있는 경우, 상속 클래스로 이 메소드를 오버라이드(override) 하도록 해 주세요.

정의:

인터페이스 Unmarshaller 내의 setProperty

파라미터:

name - 설정하는 프로퍼티의 이름. 이 값은, 정수 필드의 1 개인가 사용자 지정 캐릭터 라인을 사용해 지정할 수 있는

value - 설정하는 프로퍼티의 값

예외:

PropertyException - 주어진 프로퍼티 또는 값의 처리중에 에러가 발생했을 경우

getProperty

public Object  getProperty(String  name)
                   throws PropertyException 

필요한 프로퍼티이 없기 때문에, getProperty 메소드의 디폴트 구현은 항상, PropertyException 를 throw 합니다. 프로바이더는 추가 프로퍼티을 취급할 필요가 있는 경우, 상속 클래스로 이 메소드를 오버라이드(override) 하도록 해 주세요.

정의:

인터페이스 Unmarshaller 내의 getProperty

파라미터:

name - 취득하는 프로퍼티의 이름

반환값:

요구된 프로퍼티의 값

예외:

PropertyException - 지정한 프로퍼티, 또는 프로퍼티명치의 취득중에 에러가 발생 했을 경우

unmarshal

public Object  unmarshal(XMLEventReader  reader)
                 throws JAXBException 

인터페이스 Unmarshaller 의 기술:

지정된 프르파서로부터 XML 데이터를 비정렬화해, 결과의 컨텐츠 트리를 돌려줍니다.

이 메소드는,글로벌 루트의 비정렬화 메소드입니다.

이 메소드는, 퍼서에서의 START_DOCUMENT 또는 START_ELEMENT 이벤트의 발생을 전제로 하고 있습니다. 비정렬화는, 이 start 이벤트로부터, 대응하는 end 이벤트까지의 사이에 실행됩니다. 이 메소드가 정상적인 결과를 돌려주는 경우,reader 는, end 이벤트의 직후의 토큰을 포인트 합니다.

정의:

인터페이스 Unmarshaller 내의 unmarshal

파라미터:

reader - 읽히는 퍼서

반환값:

새롭게 작성되는 Java 컨텐츠 트리의 루트 객체

예외:

JAXBException - 비정렬화의 실행중에 예상외의 에러가 발생했을 경우

UnmarshalException - ValidationEventHandler 의 handleEvent 메소드로부터 false 가 반환되는지, 또는 Unmarshaller 가 XML 로부터 Java 에의 바인딩을 실행 할 수 없는 경우. 「XML 데이터의 비정렬화」를 참조

관련 항목:

Unmarshaller.unmarshal(javax.xml.stream.XMLEventReader, Class)

unmarshal

public Object  unmarshal(XMLStreamReader  reader)
                 throws JAXBException 

인터페이스 Unmarshaller 의 기술:

지정된 프르파서로부터 XML 데이터를 비정렬화해, 결과의 컨텐츠 트리를 돌려줍니다.

글로벌 루트 요소의 비정렬화를 구현합니다.

이 메소드는, 퍼서에서의 START_DOCUMENT 또는 START_ELEMENT 이벤트의 발생을 전제로 하고 있습니다. 비정렬화는, 이 start 이벤트로부터, 대응하는 end 이벤트까지의 사이에 실행됩니다. 이 메소드가 정상적인 결과를 돌려주는 경우,reader 는, end 이벤트의 직후의 토큰을 포인트 합니다.

정의:

인터페이스 Unmarshaller 내의 unmarshal

파라미터:

reader - 읽히는 퍼서

반환값:

새롭게 작성되는 Java 컨텐츠 트리의 루트 객체

예외:

JAXBException - 비정렬화의 실행중에 예상외의 에러가 발생했을 경우

UnmarshalException - ValidationEventHandler 의 handleEvent 메소드로부터 false 가 반환되는지, 또는 Unmarshaller 가 XML 로부터 Java 에의 바인딩을 실행 할 수 없는 경우. 「XML 데이터의 비정렬화」를 참조

관련 항목:

Unmarshaller.unmarshal(javax.xml.stream.XMLStreamReader, Class)

unmarshal

public <T> JAXBElement <T> unmarshal(Node  node,
                                    Class <T> expectedType)
                         throws JAXBException 

인터페이스 Unmarshaller 의 기술:

JAXB 맵 declaredType 에 의해 XML 데이터를 비정렬화해, 결과의 컨텐츠 트리를 돌려줍니다.

「선언형에 의한 비정렬화」를 구현합니다.

정의:

인터페이스 Unmarshaller 내의 unmarshal

파라미터:

node - 비정렬화하는 XML 데이터가 포함되는 문서 또는 요소. 호출측은 최저한, 문서와 요소를 지원할 필요가 있는

expectedType - node 의 XML 데이터를 보관 유지하는, 적절한 JAXB 맵 클래스

반환값:

node 의 JAXB 요소 표현

예외:

JAXBException - 비정렬화의 실행중에 예상외의 에러가 발생했을 경우

UnmarshalException - ValidationEventHandler 의 handleEvent 메소드로부터 false 가 반환되는지, 또는 Unmarshaller 가 XML 로부터 Java 에의 바인딩을 실행 할 수 없는 경우. 「XML 데이터의 비정렬화」를 참조

unmarshal

public <T> JAXBElement <T> unmarshal(Source  source,
                                    Class <T> expectedType)
                         throws JAXBException 

인터페이스 Unmarshaller 의 기술:

declaredType 에 근거해, 지정된 XML Source 로부터 XML 데이터를 비정렬화해, 결과의 컨텐츠 트리를 돌려줍니다.

「선언형에 의한 비정렬화」를 구현합니다.

「플러그 인 가능한 SAX 2.0 퍼서」를 참조해 주세요.

정의:

인터페이스 Unmarshaller 내의 unmarshal

파라미터:

source - 비정렬화하는 XML 데이터가 포함되는 XML Source (프로바이더는, SAXSource, DOMSource, StreamSource 를 지원할 필요가 있을 뿐)

expectedType - source 의 XML 루트 요소를 보관 유지하는, 적절한 JAXB 맵 클래스

반환값:

JAXB 요소를 루트로 하는 Java 컨텐츠

예외:

JAXBException - 비정렬화의 실행중에 예상외의 에러가 발생했을 경우

UnmarshalException - ValidationEventHandler 의 handleEvent 메소드로부터 false 가 반환되는지, 또는 Unmarshaller 가 XML 로부터 Java 에의 바인딩을 실행 할 수 없는 경우. 「XML 데이터의 비정렬화」를 참조

unmarshal

public <T> JAXBElement <T> unmarshal(XMLStreamReader  reader,
                                    Class <T> expectedType)
                         throws JAXBException 

인터페이스 Unmarshaller 의 기술:

JAXB 맵 declaredType 에 루트 요소를 비정렬화해, 결과의 컨텐츠 트리를 돌려줍니다.

이 메소드는,선언형에 의한 비정렬화를 구현합니다.

이 메소드는, 퍼서에서의 START_DOCUMENT 또는 START_ELEMENT 이벤트의 발생을 전제로 하고 있습니다. 비정렬화는, 이 start 이벤트로부터, 대응하는 end 이벤트까지의 사이에 실행됩니다. 이 메소드가 정상적인 결과를 돌려주는 경우,reader 는, end 이벤트의 직후의 토큰을 포인트 합니다.

정의:

인터페이스 Unmarshaller 내의 unmarshal

파라미터:

reader - 읽히는 퍼서

expectedType - reader 의 START_ELEMENT XML 데이터를 보관 유지하는, 적절한 JAXB 맵 클래스

반환값:

JAXB 요소 표현을 루트로 하는 컨텐츠 트리

예외:

JAXBException - 비정렬화의 실행중에 예상외의 에러가 발생했을 경우

UnmarshalException - ValidationEventHandler 의 handleEvent 메소드로부터 false 가 반환되는지, 또는 Unmarshaller 가 XML 로부터 Java 에의 바인딩을 실행 할 수 없는 경우. 「XML 데이터의 비정렬화」를 참조

unmarshal

public <T> JAXBElement <T> unmarshal(XMLEventReader  reader,
                                    Class <T> expectedType)
                         throws JAXBException 

인터페이스 Unmarshaller 의 기술:

JAXB 맵 declaredType 에 루트 요소를 비정렬화해, 결과의 컨텐츠 트리를 돌려줍니다.

이 메소드는,선언형에 의한 비정렬화를 구현합니다.

이 메소드는, 퍼서에서의 START_DOCUMENT 또는 START_ELEMENT 이벤트의 발생을 전제로 하고 있습니다. 비정렬화는, 이 start 이벤트로부터, 대응하는 end 이벤트까지의 사이에 실행됩니다. 이 메소드가 정상적인 결과를 돌려주는 경우,reader 는, end 이벤트의 직후의 토큰을 포인트 합니다.

정의:

인터페이스 Unmarshaller 내의 unmarshal

파라미터:

reader - 읽히는 퍼서

expectedType - reader 의 START_ELEMENT XML 데이터를 보관 유지하는, 적절한 JAXB 맵 클래스

반환값:

JAXB 요소 표현을 루트로 하는 컨텐츠 트리

예외:

JAXBException - 비정렬화의 실행중에 예상외의 에러가 발생했을 경우

UnmarshalException - ValidationEventHandler 의 handleEvent 메소드로부터 false 가 반환되는지, 또는 Unmarshaller 가 XML 로부터 Java 에의 바인딩을 실행 할 수 없는 경우. 「XML 데이터의 비정렬화」를 참조

setSchema

public void setSchema(Schema  schema)

인터페이스 Unmarshaller 의 기술:

후의 비정렬화 조작의 검증에 사용하는, JAXP 1.3 Schema 객체를 지정합니다. 이 메소드에 null 를 건네주면(자), 검증은 무효가 됩니다.

이 메소드는, 추천 되지 않게 된 setValidating(boolean) API 에 옮겨지는 것입니다.

이 프로퍼티은 최초로 null 로 설정됩니다.

정의:

인터페이스 Unmarshaller 내의 setSchema

파라미터:

schema - 비정렬화 조작의 검증에 사용하는 schema 객체. 검증을 무효로 하는 경우는 null

getSchema

public Schema  getSchema()

인터페이스 Unmarshaller 의 기술:

비정렬화시의 검증에 사용되고 있는 JAXP 1.3 Schema 객체를 가져옵니다. Unmarshaller 에 schema가 설정되어 있지 않은 경우, 이 메소드는, 비정렬화시에 검증을 실행하지 않는 것을 나타내는, null 를 돌려줍니다.

이 메소드는, 추천 되지 않게 된 Unmarshaller.isValidating() API 에 옮겨지는 것과 동시에, Schema 객체에의 액세스를 제공합니다. Unmarshaller 가 검증을 유효하게 하고 있을지 어떨지를 판단하려면 , 반환값의 형태와 null 를 대조해 체크하면 간단하게 압니다.

boolean isValidating = u.getSchema()! =null;

정의:

인터페이스 Unmarshaller 내의 getSchema

반환값:

비정렬화시의 검증을 실행하기 위해서 사용되는 schema 객체, 또는, 존재하지 않는 경우, null

setAdapter

public void setAdapter(XmlAdapter  adapter)

인터페이스 Unmarshaller 의 기술:

XmlAdapter 의 설정 끝난 인스턴스를 이 Unmarshaller 에 관련짓습니다.

이것은,setAdapter(adapter.getClass(), adapter); 를 호출하는 편리한 메소드입니다.

정의:

인터페이스 Unmarshaller 내의 setAdapter

관련 항목:

Unmarshaller.setAdapter(Class, XmlAdapter)

setAdapter

public <A extends XmlAdapter > void setAdapter(Class <A> type,
                                              A adapter)

인터페이스 Unmarshaller 의 기술:

XmlAdapter 의 설정 끝난 인스턴스를 이 Unmarshaller 에 관련짓습니다.

모든 Unmarshaller 는, 내부적으로 Map <Class ,XmlAdapter > 를 보관 유지하고 있어, 필드 또는 메소드가 XmlJavaTypeAdapter 로 주석 된 클래스를 비정렬화하기 위해서(때문에) 사용합니다.

이 메소드에 의해, 어플리케이션은 XmlAdapter 의 설정 끝난 인스턴스를 사용할 수가 있습니다. 어댑터의 인스턴스가 주어지지 않는 경우, Unmarshaller 는 그 디폴트 생성자 을 호출해 인스턴스를 작성합니다.

정의:

인터페이스 Unmarshaller 내의 setAdapter

파라미터:

type - 어댑터의 형태. XmlJavaTypeAdapter.value() 하지만 이 형태를 참조하고 있는 경우, 지정된 인스턴스가 사용되는

adapter - 사용하는 어댑터의 인스턴스. null 의 경우, 이 형태의 현재의 어댑터 세트의 등록을 취소한다

getAdapter

public <A extends XmlAdapter > A getAdapter(Class <A> type)

인터페이스 Unmarshaller 의 기술:

지정한 형태에 관련지을 수 있고 있는 어댑터를 가져옵니다. 이 메소드는,Unmarshaller.setAdapter(javax.xml.bind.annotation.adapters.XmlAdapter) 메소드의 역의 조작입니다.

정의:

인터페이스 Unmarshaller 내의 getAdapter

setAttachmentUnmarshaller

public void setAttachmentUnmarshaller(AttachmentUnmarshaller  au)

인터페이스 Unmarshaller 의 기술:

cid, 컨텐츠 ID URI 를, 첨부로서 건네받은 바이너리 데이터에 해결하는 문맥을 관련짓습니다.

비정렬화시의 검증은,Unmarshaller.setSchema(Schema) 를 개입시켜 유효화 되어 Unmarshaller 가 XOP 처리를 실행하는 경우에서도 지원할 필요가 있습니다.

정의:

인터페이스 Unmarshaller 내의 setAttachmentUnmarshaller

getAttachmentUnmarshaller

public AttachmentUnmarshaller  getAttachmentUnmarshaller()

정의:

인터페이스 Unmarshaller 내의 getAttachmentUnmarshaller

setListener

public void setListener(Unmarshaller.Listener  listener)

인터페이스 Unmarshaller 의 기술:

이 Unmarshaller 에 비정렬화 이벤트 콜백 Unmarshaller.Listener 를 등록합니다.

각 Unmarshaller 에 Listener 는 1 개 뿐입니다. Listener 를 설정하면(자), 전으로 설정되어 있던 Listener 와 옮겨집니다. Listener 에 null 를 설정하는 것으로써, 현재의 Listener 의 등록을 해제할 수 있습니다.

정의:

인터페이스 Unmarshaller 내의 setListener

파라미터:

listener - 이 Unmarshaller 에 비정렬화 이벤트 콜백을 제공한다

getListener

public Unmarshaller.Listener  getListener()

인터페이스 Unmarshaller 의 기술:

이 Unmarshaller 에 등록되어 있는 Unmarshaller.Listener 를 돌려줍니다.

정의:

인터페이스 Unmarshaller 내의 getListener

반환값:

등록되어 있는 Unmarshaller.Listener , 또는, 이 Unmarshaller 에 등록되어 있는 Listener 가 없는 경우,null