AbstractMarshallerImpl (Java Platform SE 6) - xrath.com 에서 번역됨

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM Platform
Standard Ed. 6

전의 클래스 다음의 클래스

프레임 있어 프레임 없음

개요: 상자 | 필드 | 생성자 | 메소드

상세: 필드 | 생성자 | 메소드

javax.xml.bind.helpers
클래스 AbstractMarshallerImpl

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

모든 구현된 인터페이스:: Marshaller

public abstract class AbstractMarshallerImpl
extends Object
implements Marshaller
extends Object
implements Marshaller

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

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

JAXB 프로바이더가 구현할 필요가 있는 메소드는,marshal(Object, javax.xml.transform.Result) ,marshal(Object, javax.xml.stream.XMLStreamWriter) , 및 marshal(Object, javax.xml.stream.XMLEventWriter) 뿐입니다.

도입된 버젼:: JAXB1. 0
관련 항목:: Marshaller

상자의 클래스의 개요

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

필드의 개요

인터페이스 javax.xml.bind. Marshaller 로부터 상속된 필드
`JAXB_ENCODING , JAXB_FORMATTED_OUTPUT , JAXB_FRAGMENT , JAXB_NO_NAMESPACE_SCHEMA_LOCATION , JAXB_SCHEMA_LOCATION`

생성자 의 개요
`AbstractMarshallerImpl ()`

메소드의 개요





<A extends XmlAdapter > 


A

getAdapter (Class <A> type)
지정한 형태에 관련지을 수 있고 있는 어댑터를 가져옵니다.

AttachmentMarshaller getAttachmentMarshaller ()

protected String getEncoding ()
현재의 출력 인코딩을 취득하기 위한 편리한 메소드입니다.

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

protected String getJavaEncoding (String encoding)
IANA 명으로부터 대응하는 Java 인코딩명을 가져옵니다.

Marshaller.Listener getListener ()
이 Marshaller 에 등록되어 있는 Marshaller.Listener 를 돌려줍니다.

Node getNode (Object obj)
디폴트에서는, getNode 메소드는 지원되지 않고,UnsupportedOperationException 를 throw 합니다.

protected String getNoNSSchemaLocation ()
현재의 noNamespaceSchemaLocation 를 취득하기 위한 편리한 메소드입니다.

Object getProperty (String name)
getProperty 메소드의 디폴트 구현에서는, Marshaller 의 4 개의 정의가 끝난 프로퍼티을 취급합니다.

Schema getSchema ()
정렬화시의 검증에 사용되는 JAXP 1.3 Schema 객체를 가져옵니다.

protected String getSchemaLocation ()
현재의 schemaLocation 를 취득하기 위한 편리한 메소드입니다.

protected boolean isFormattedOutput ()
서식 설정된 출력 플래그를 취득하기 위한 편리한 메소드입니다.

protected boolean isFragment ()
fragment 플래그를 취득하기 위한 편리한 메소드입니다.

void marshal (Object obj, ContentHandler handler)
jaxbElement 를 루트로 하는 컨텐츠 트리를 SAX2 이벤트에 정렬화합니다.

void marshal (Object obj, Node node)
jaxbElement 를 루트로 하는 컨텐츠 트리를 DOM 트리에 정렬화합니다.

void marshal (Object obj, OutputStream os)
jaxbElement 를 루트로 하는 컨텐츠 트리를 출력 스트림에 정렬화합니다.

void marshal (Object obj, Writer w)
jaxbElement 를 루트로 하는 컨텐츠 트리를 Writer 에 정렬화합니다.

void marshal (Object obj, XMLEventWriter writer)
jaxbElement 를 루트로 하는 컨텐츠 트리를 XMLEventWriter 에 정렬화합니다.

void marshal (Object obj, XMLStreamWriter writer)
jaxbElement 를 루트로 하는 컨텐츠 트리를 XMLStreamWriter 에 정렬화합니다.





<A extends XmlAdapter > 


void

setAdapter (Class <A> type,
           A adapter)

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

void setAdapter (XmlAdapter adapter)
XmlAdapter 의 설정 끝난 인스턴스를 이 Marshaller 에 관련짓습니다.

void setAttachmentMarshaller (AttachmentMarshaller am)
XML 문서내의 바이너리 데이터를, XML 바이너리의 최적화된 첨부로서 전송 가능하게 하는 문맥을 관련짓습니다.

protected void setEncoding (String encoding)
출력 인코딩을 설정하기 위한 편리한 메소드입니다.

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

protected void setFormattedOutput (boolean v)
서식 설정된 출력 플래그를 설정하기 위한 편리한 메소드입니다.

protected void setFragment (boolean v)
fragment 플래그를 설정하기 위한 편리한 메소드입니다.

void setListener (Marshaller.Listener listener)
이 Marshaller 에 정렬화 이벤트 콜백 Marshaller.Listener 를 등록합니다.

protected void setNoNSSchemaLocation (String location)
noNamespaceSchemaLocation 를 설정하기 위한 편리한 메소드입니다.

void setProperty (String name, Object value)
setProperty 메소드의 디폴트 구현에서는, Marshaller 의 4 개의 정의가 끝난 프로퍼티을 취급합니다.

void setSchema (Schema schema)
후의 정렬화 조작의 검증에 사용하는, JAXP 1.3 Schema 객체를 지정합니다.

protected void setSchemaLocation (String location)
schemaLocation 를 설정하기 위한 편리한 메소드입니다.

클래스 java.lang. Object 로부터 상속된 메소드
`clone , equals , finalize , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait`

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

생성자 의 상세

AbstractMarshallerImpl

public AbstractMarshallerImpl()

메소드의 상세

marshal

public final void marshal(Object  obj,
                          OutputStream  os)
                   throws JAXBException

인터페이스 Marshaller 의 기술:

jaxbElement 를 루트로 하는 컨텐츠 트리를 출력 스트림에 정렬화합니다.

정의:: 인터페이스 Marshaller 내의 marshal

파라미터:: obj - 정렬화하는 컨텐츠 트리의 루트; os - XML 는 이 스트림에 추가된다
예외:: JAXBException - 정렬화의 실행중에 예상외의 문제가 발생했을 경우; MarshalException - ValidationEventHandler 의 handleEvent 메소드로부터 false 가 반환되는지, 또는 Marshaller 가 obj (또는, obj 로부터 도달 가능한 객체)를 정렬화할 수 없는 경우. 「 JAXB 요소의 정렬화」를 참조

marshal

public final void marshal(Object  obj,
                          Writer  w)
                   throws JAXBException

인터페이스 Marshaller 의 기술:

jaxbElement 를 루트로 하는 컨텐츠 트리를 Writer 에 정렬화합니다.

정의:: 인터페이스 Marshaller 내의 marshal

파라미터:: obj - 정렬화하는 컨텐츠 트리의 루트; w - XML 는 이 라이터에 송신된다
예외:: JAXBException - 정렬화의 실행중에 예상외의 문제가 발생했을 경우; MarshalException - ValidationEventHandler 의 handleEvent 메소드로부터 false 가 반환되는지, 또는 Marshaller 가 obj (또는, obj 로부터 도달 가능한 객체)를 정렬화할 수 없는 경우. 「 JAXB 요소의 정렬화」를 참조

marshal

public final void marshal(Object  obj,
                          ContentHandler  handler)
                   throws JAXBException

인터페이스 Marshaller 의 기술:

jaxbElement 를 루트로 하는 컨텐츠 트리를 SAX2 이벤트에 정렬화합니다.

정의:: 인터페이스 Marshaller 내의 marshal

파라미터:: obj - 정렬화하는 컨텐츠 트리의 루트; handler - XML 는 이 핸들러에 SAX2 이벤트로서 송신된다
예외:: JAXBException - 정렬화의 실행중에 예상외의 문제가 발생했을 경우; MarshalException - ValidationEventHandler 의 handleEvent 메소드로부터 false 가 반환되는지, 또는 Marshaller 가 obj (또는, obj 로부터 도달 가능한 객체)를 정렬화할 수 없는 경우. 「 JAXB 요소의 정렬화」를 참조

marshal

public final void marshal(Object  obj,
                          Node  node)
                   throws JAXBException

인터페이스 Marshaller 의 기술:

jaxbElement 를 루트로 하는 컨텐츠 트리를 DOM 트리에 정렬화합니다.

정의:: 인터페이스 Marshaller 내의 marshal

파라미터:: obj - 정렬화하는 컨텐츠 트리; node - DOM 노드가 이 노드의 아이로서 추가된다. 이 파라미터는, 아이 (Document , DocumentFragment , 또는 Element )를 받아들이는 노드가 아니면 안 된다
예외:: JAXBException - 정렬화의 실행중에 예상외의 문제가 발생했을 경우; MarshalException - ValidationEventHandler 의 handleEvent 메소드로부터 false 가 반환되는지, 또는 Marshaller 가 jaxbElement (또는, jaxbElement 로부터 도달 가능한 객체)를 정렬화할 수 없는 경우. 「 JAXB 요소의 정렬화」를 참조

getNode

public Node  getNode(Object  obj)
             throws JAXBException

디폴트에서는, getNode 메소드는 지원되지 않고,UnsupportedOperationException 를 throw 합니다. 이 메소드를 지원하는 것을 선택한 구현은, 이 메소드를 오버라이드(override) 할 필요가 있습니다.

정의:: 인터페이스 Marshaller 내의 getNode

파라미터:: obj - - XML 컨텐츠의 JAXB Java 표현
반환값:: 컨텐츠 트리의 DOM 트리뷰
예외:: JAXBException - 예상외의 문제가 발생했을 경우

getEncoding

protected String  getEncoding()

현재의 출력 인코딩을 취득하기 위한 편리한 메소드입니다.

반환값:: 현재의 인코딩, 또는, 설정되어 있지 않은 경우는 「UTF-8」

setEncoding

protected void setEncoding(String  encoding)

출력 인코딩을 설정하기 위한 편리한 메소드입니다.

파라미터:: encoding - Marshaller 클래스 문서로 지정된 유효한 인코딩

getSchemaLocation

protected String  getSchemaLocation()

현재의 schemaLocation 를 취득하기 위한 편리한 메소드입니다.

반환값:: 현재의 schemaLocation, 또는, 설정되어 있지 않은 경우는 null

setSchemaLocation

protected void setSchemaLocation(String  location)

schemaLocation 를 설정하기 위한 편리한 메소드입니다.

파라미터:: location - schemaLocation 치

getNoNSSchemaLocation

protected String  getNoNSSchemaLocation()

현재의 noNamespaceSchemaLocation 를 취득하기 위한 편리한 메소드입니다.

반환값:: 현재의 noNamespaceSchemaLocation, 또는, 설정되어 있지 않은 경우는 null

setNoNSSchemaLocation

protected void setNoNSSchemaLocation(String  location)

noNamespaceSchemaLocation 를 설정하기 위한 편리한 메소드입니다.

파라미터:: location - noNamespaceSchemaLocation 치

isFormattedOutput

protected boolean isFormattedOutput()

서식 설정된 출력 플래그를 취득하기 위한 편리한 메소드입니다.

반환값:: 서식 설정된 출력 플래그의 현재의 값, 또는, 설정되어 있지 않은 경우는 false

setFormattedOutput

protected void setFormattedOutput(boolean v)

서식 설정된 출력 플래그를 설정하기 위한 편리한 메소드입니다.

파라미터:: v - 서식 설정된 출력 플래그의 값

isFragment

protected boolean isFragment()

fragment 플래그를 취득하기 위한 편리한 메소드입니다.

반환값:: fragment 플래그의 현재의 값, 또는, 설정되어 있지 않은 경우는 false

setFragment

protected void setFragment(boolean v)

fragment 플래그를 설정하기 위한 편리한 메소드입니다.

파라미터:: v - fragment 플래그의 값

getJavaEncoding

protected String  getJavaEncoding(String  encoding)
                          throws UnsupportedEncodingException

IANA 명으로부터 대응하는 Java 인코딩명을 가져옵니다. 이 메소드는, 상속 클래스가 인코딩명을 변환하기 위한 헬퍼 메소드입니다.

예외:: UnsupportedEncodingException - 이 구현이 Java 인코딩명을 검출할 수 없었던 경우

setProperty

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

setProperty 메소드의 디폴트 구현에서는, Marshaller 의 4 개의 정의가 끝난 프로퍼티을 취급합니다. 프로바이더는 추가 프로퍼티을 취급할 필요가 있는 경우, 상속 클래스로 이 메소드를 오버라이드(override) 하도록 해 주세요.

정의:: 인터페이스 Marshaller 내의 setProperty

파라미터:: name - 설정하는 프로퍼티의 이름. 이 값은, 정수 필드의 1 개인가 사용자 지정 캐릭터 라인을 사용해 지정할 수 있는; value - 설정하는 프로퍼티의 값
예외:: PropertyException - 지정한 프로퍼티 또는 값의 처리중에 에러가 발생했을 경우

getProperty

public Object  getProperty(String  name)
                   throws PropertyException

getProperty 메소드의 디폴트 구현에서는, Marshaller 의 4 개의 정의가 끝난 프로퍼티을 취급합니다. 프로바이더는 프로바이더 고유의 추가 프로퍼티을 지원할 필요가 있는 경우, 상속 클래스로 이 메소드를 오버라이드(override) 하도록 해 주세요.

정의:: 인터페이스 Marshaller 내의 getProperty

파라미터:: name - 취득하는 프로퍼티의 이름
반환값:: 요구된 프로퍼티의 값
예외:: PropertyException - 지정한 프로퍼티, 또는 프로퍼티명치의 취득중에 에러가 발생 했을 경우

getEventHandler

public ValidationEventHandler  getEventHandler()
                                       throws JAXBException

인터페이스 Marshaller 의 기술:

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

정의:: 인터페이스 Marshaller 내의 getEventHandler

반환값:: 현재의 ValidationEventHandler, 또는, 그것이 설정되어 있지 않은 경우, 디폴트 이벤트 핸들러
예외:: JAXBException - 현재의 이벤트 핸들러의 취득중에 에러가 발생했을 경우
관련 항목:: Marshaller.getEventHandler()

setEventHandler

public void setEventHandler(ValidationEventHandler  handler)
                     throws JAXBException

인터페이스 Marshaller 의 기술:

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

검증 이벤트 핸들러는, 몇개의 정렬화 API 를 호출하고 있는 도중에 검증 에러가 발생했을 경우, JAXB 프로바이더에 의해 불려 갑니다. 정렬화 메소드의 어느쪽이든을 호출하기 전에, 클라이언트 어플리케이션이 검증 이벤트 핸들러를 등록하고 있지 않는 경우, 검증 이벤트는 디폴트 이벤트 핸들러에 의해 처리됩니다. 디폴트 이벤트 핸들러는, 최초의 에러 또는 치명적인 에러의 발생 후에 정렬화 조작을 종료시킵니다.

이 메소드를 null 파라미터와 함께 호출했을 경우, Marshaller 는 디폴트의 디폴트 이벤트 핸들러에 되돌려집니다.

정의:: 인터페이스 Marshaller 내의 setEventHandler

파라미터:: handler - 검증 이벤트 핸들러
예외:: JAXBException - 이벤트 핸들러의 설정중에 에러가 발생했을 경우
관련 항목:: Marshaller.setEventHandler(ValidationEventHandler)

marshal

public void marshal(Object  obj,
                    XMLEventWriter  writer)
             throws JAXBException

인터페이스 Marshaller 의 기술:

jaxbElement 를 루트로 하는 컨텐츠 트리를 XMLEventWriter 에 정렬화합니다.

정의:: 인터페이스 Marshaller 내의 marshal

파라미터:: obj - 정렬화하는 jaxbElement 를 루트로 하는 컨텐츠 트리; writer - XML 는 이 라이터에 송신된다
예외:: JAXBException - 정렬화의 실행중에 예상외의 문제가 발생했을 경우; MarshalException - ValidationEventHandler 의 handleEvent 메소드로부터 false 가 반환되는지, 또는 Marshaller 가 obj (또는, obj 로부터 도달 가능한 객체)를 정렬화할 수 없는 경우. 「 JAXB 요소의 정렬화」를 참조

marshal

public void marshal(Object  obj,
                    XMLStreamWriter  writer)
             throws JAXBException

인터페이스 Marshaller 의 기술:

jaxbElement 를 루트로 하는 컨텐츠 트리를 XMLStreamWriter 에 정렬화합니다.

정의:: 인터페이스 Marshaller 내의 marshal

파라미터:: obj - 정렬화하는 컨텐츠 트리; writer - XML 는 이 라이터에 송신된다
예외:: JAXBException - 정렬화의 실행중에 예상외의 문제가 발생했을 경우; MarshalException - ValidationEventHandler 의 handleEvent 메소드로부터 false 가 반환되는지, 또는 Marshaller 가 obj (또는, obj 로부터 도달 가능한 객체)를 정렬화할 수 없는 경우. 「 JAXB 요소의 정렬화」를 참조

setSchema

public void setSchema(Schema  schema)

인터페이스 Marshaller 의 기술:

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

이 메소드에 의해, 호출측은 정렬화의 실행시에, 정렬화 되는 XML 를 검증할 수 있습니다.

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

정의:: 인터페이스 Marshaller 내의 setSchema

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

getSchema

public Schema  getSchema()

인터페이스 Marshaller 의 기술:

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

정의:: 인터페이스 Marshaller 내의 getSchema

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

setAdapter

public void setAdapter(XmlAdapter  adapter)

인터페이스 Marshaller 의 기술:

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

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

정의:: 인터페이스 Marshaller 내의 setAdapter

관련 항목:: Marshaller.setAdapter(Class, XmlAdapter)

setAdapter

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

인터페이스 Marshaller 의 기술:

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

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

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

정의:: 인터페이스 Marshaller 내의 setAdapter

파라미터:: type - 어댑터의 형태. XmlJavaTypeAdapter.value() 하지만 이 형태를 참조하고 있는 경우, 지정한 인스턴스가 사용되는; adapter - 사용하는 어댑터의 인스턴스. null 의 경우, 이 형태의 현재의 어댑터 세트의 등록을 취소한다

getAdapter

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

인터페이스 Marshaller 의 기술:

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

정의:: 인터페이스 Marshaller 내의 getAdapter

setAttachmentMarshaller

public void setAttachmentMarshaller(AttachmentMarshaller  am)

인터페이스 Marshaller 의 기술:

XML 문서내의 바이너리 데이터를, XML 바이너리의 최적화된 첨부로서 전송 가능하게 하는 문맥을 관련짓습니다. 첨부는, XML 문서 컨텐츠 모델로부터, XML 문서내에 보존된 컨텐츠 ID URI (cid) 참조에 의해 참조됩니다.

정의:: 인터페이스 Marshaller 내의 setAttachmentMarshaller

getAttachmentMarshaller

public AttachmentMarshaller  getAttachmentMarshaller()

정의:: 인터페이스 Marshaller 내의 getAttachmentMarshaller

setListener

public void setListener(Marshaller.Listener  listener)

인터페이스 Marshaller 의 기술:

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

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

정의:: 인터페이스 Marshaller 내의 setListener

파라미터:: listener - Marshaller.Listener 를 구현하는 클래스의 인스턴스

getListener

public Marshaller.Listener  getListener()

인터페이스 Marshaller 의 기술:

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

정의:: 인터페이스 Marshaller 내의 getListener

반환값:: 등록되어 있는 Marshaller.Listener , 또는, 이 Marshaller 에 등록되어 있는 Listener 가 없는 경우,null

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM Platform
Standard Ed. 6

전의 클래스 다음의 클래스

프레임 있어 프레임 없음

개요: 상자 | 필드 | 생성자 | 메소드

상세: 필드 | 생성자 | 메소드

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

javax.xml.bind.helpers 클래스 AbstractMarshallerImpl

AbstractMarshallerImpl

marshal

marshal

marshal

marshal

getNode

getEncoding

setEncoding

getSchemaLocation

setSchemaLocation

getNoNSSchemaLocation

setNoNSSchemaLocation

isFormattedOutput

setFormattedOutput

isFragment

setFragment

getJavaEncoding

setProperty

getProperty

getEventHandler

setEventHandler

marshal

marshal

setSchema

getSchema

setAdapter

setAdapter

getAdapter

setAttachmentMarshaller

getAttachmentMarshaller

setListener

getListener

javax.xml.bind.helpers
클래스 AbstractMarshallerImpl