javax.xml.stream
클래스 XMLOutputFactory

java.lang.Object 
  javax.xml.stream.XMLOutputFactory

public abstract class XMLOutputFactory
extends Object 

XMLEventWriter 및 XMLStreamWriter 를 취득하기 위한 팩토리의 추상 구현을 정의합니다. 다음의 겉(표)에, 이 스펙의 표준 프로퍼티의 정의를 나타냅니다. 각 프로퍼티은, 구현 마다 필요한 지원의 레벨이 다릅니다. 필요한 지원 레벨은, 「필수」의 열에 나타나고 있습니다.

구성 파라미터
프로퍼티명	동작	귀가형	디폴트 값	필수
javax.xml.stream.isRepairingNamespaces	출력측의 접두사의 디폴트를 설정하는	Boolean	False	있어

　

다음에, 이름 공간과 접두사의 수복 알고리즘에 대해 설명합니다.

　

프로퍼티은,setProperty("javax.xml.stream.isRepairingNamespaces", new Boolean(true|false)); 의 코드행을 사용해 설정할 수 있습니다.

　

이 프로퍼티은, 라이터의 디폴트의 이름 공간 접두사의 선언을 지정합니다. 디폴트 값는 false 입니다.

　

라이터가 이름 공간을 보수하는 경우, 라이터는 범위내에 이름 공간 선언을 현재 가지지 않는 모든 속성에 대해서, 현재의 StartElement 에 이름 공간 선언을 작성합니다. StartElement 에 URI 가 지정되고 있지만, 접두사가 지정되어 있지 않은 경우, 접두사를 할당할 수 있습니다. 현재의 StartElement 의 부모로 접두사가 선언되어 있지 않은 경우, 접두사는 현재의 StartElement 로 선언됩니다. defaultNamespace 가 바인드 되고 있어 범위내에 있어, 디폴트의 이름 공간이 속성의 URI 또는 StartElement QName 에 일치하는 경우, 접두사는 할당할 수 없습니다.

　

요소명 또는 속성명에 접두사가 포함되지만, 어느 이름 공간 URI 에도 바인드되어 있지 않은 경우, 직렬화중에 접두사가 삭제됩니다.

　

같은 개시 태그 또는 빈 상태(empty)의 요소 태그내의 요소명이나 속성명이 다른 이름 공간 URI 에 바인드 되고 있어, 같은 접두사를 사용하고 있는 경우, 요소 또는 최초로 나타나는 속성은 원의 접두사를 보관 유지해, 후속의 속성은 접두사를 속성의 이름 공간 URI 에 바인드 된 새로운 접두사로 옮겨놓습니다.

　

요소명 또는 속성명이, 요소의 부모의 이름 공간 문맥으로부터 상속한 것과는 다른 URI 에 바인드 되고 있는 접두사를 사용해, 현재의 요소의 문맥에 이름 공간 선언이 존재하지 않는 경우, 그러한 이름 공간 선언이 추가됩니다.

　

요소명 또는 속성명이 접두사에 바인드 되고 있어, 접두사를 다른 URI 에 바인드 하는 이름 공간 선언이 존재하는 경우, 그 이름 공간 선언은, 올바른 매핑이 그 요소의 친문맥으로부터 상속되고 있는 경우는 삭제되어 그 이외의 경우는 그 접두사를 사용하는 요소 또는 속성의 이름 공간 URI 로 변경됩니다.

도입된 버젼:

1.6

관련 항목:

XMLInputFactory , XMLEventWriter , XMLStreamWriter

필드의 개요

static String

IS_REPAIRING_NAMESPACES 접두사를 출력측에서 디폴트 설정하기 위해서 사용되는 프로퍼티.

생성자 의 개요

protected

XMLOutputFactory ()

메소드의 개요

abstract XMLEventWriter	createXMLEventWriter (OutputStream stream) 스트림에의 기입을 실시하는 새로운 XMLEventWriter 를 작성합니다.
abstract XMLEventWriter	createXMLEventWriter (OutputStream stream, String encoding) 스트림에의 기입을 실시하는 새로운 XMLEventWriter 를 작성합니다.
abstract XMLEventWriter	createXMLEventWriter (Result result) JAXP 결과에의 기입을 실시하는 새로운 XMLEventWriter 를 작성합니다.
abstract XMLEventWriter	createXMLEventWriter (Writer stream) 라이터에의 기입을 실시하는 새로운 XMLEventWriter 를 작성합니다.
abstract XMLStreamWriter	createXMLStreamWriter (OutputStream stream) 스트림에의 기입을 실시하는 새로운 XMLStreamWriter 를 작성합니다.
abstract XMLStreamWriter	createXMLStreamWriter (OutputStream stream, String encoding) 스트림에의 기입을 실시하는 새로운 XMLStreamWriter 를 작성합니다.
abstract XMLStreamWriter	createXMLStreamWriter (Result result) JAXP 결과에의 기입을 실시하는 새로운 XMLStreamWriter 를 작성합니다.
abstract XMLStreamWriter	createXMLStreamWriter (Writer stream) 라이터에의 기입을 실시하는 새로운 XMLStreamWriter 를 작성합니다.
abstract Object	getProperty (String name) 기본이 되는 구현으로부터 기능 또는 프로퍼티을 가져옵니다.
abstract boolean	isPropertySupported (String name) 이 팩토리가 지원하는 프로퍼티 세트를 조회합니다.
static XMLOutputFactory	newInstance () 팩토리의 새로운 인스턴스를 작성합니다.
static XMLInputFactory	newInstance (String factoryId, ClassLoader classLoader) Create a new instance of the factory.
abstract void	setProperty (String name, Object value) 사용자가 기본이 되는 구현에 특정의 기능과 프로퍼티을 설정할 수 있도록(듯이) 합니다.

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

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

필드의 상세

IS_REPAIRING_NAMESPACES

public static final String  IS_REPAIRING_NAMESPACES

접두사를 출력측에서 디폴트 설정하기 위해서 사용되는 프로퍼티.

관련 항목:

정수 필드치

생성자 의 상세

XMLOutputFactory

protected XMLOutputFactory()

메소드의 상세

newInstance

public static XMLOutputFactory  newInstance()
                                    throws FactoryConfigurationError 

팩토리의 새로운 인스턴스를 작성합니다.

예외:

FactoryConfigurationError - 이 팩토리의 인스턴스를 로드할 수 없는 경우

newInstance

public static XMLInputFactory  newInstance(String  factoryId,
                                          ClassLoader  classLoader)
                                   throws FactoryConfigurationError 

Create a new instance of the factory.

파라미터:

factoryId - Name of the factory to find, same as a property name

classLoader - classLoader to use

반환값:

the factory implementation

예외:

FactoryConfigurationError - if an instance of this factory cannot be loaded

createXMLStreamWriter

public abstract XMLStreamWriter  createXMLStreamWriter(Writer  stream)
                                               throws XMLStreamException 

라이터에의 기입을 실시하는 새로운 XMLStreamWriter 를 작성합니다.

파라미터:

stream - 기입처의 라이터

예외:

XMLStreamException

createXMLStreamWriter

public abstract XMLStreamWriter  createXMLStreamWriter(OutputStream  stream)
                                               throws XMLStreamException 

스트림에의 기입을 실시하는 새로운 XMLStreamWriter 를 작성합니다.

파라미터:

stream - 기입처의 스트림

예외:

XMLStreamException

createXMLStreamWriter

public abstract XMLStreamWriter  createXMLStreamWriter(OutputStream  stream,
                                                      String  encoding)
                                               throws XMLStreamException 

스트림에의 기입을 실시하는 새로운 XMLStreamWriter 를 작성합니다.

파라미터:

stream - 기입처의 스트림

encoding - 사용하는 인코딩

예외:

XMLStreamException

createXMLStreamWriter

public abstract XMLStreamWriter  createXMLStreamWriter(Result  result)
                                               throws XMLStreamException 

JAXP 결과에의 기입을 실시하는 새로운 XMLStreamWriter 를 작성합니다. 이 메소드는 옵션입니다.

파라미터:

result - 기입처의 결과

예외:

UnsupportedOperationException - 이 메소드가 이 XMLOutputFactory 그리고 지원되어 있지 않은 경우

XMLStreamException

createXMLEventWriter

public abstract XMLEventWriter  createXMLEventWriter(Result  result)
                                             throws XMLStreamException 

JAXP 결과에의 기입을 실시하는 새로운 XMLEventWriter 를 작성합니다. 이 메소드는 옵션입니다.

파라미터:

result - 기입처의 결과

예외:

UnsupportedOperationException - 이 메소드가 이 XMLOutputFactory 그리고 지원되어 있지 않은 경우

XMLStreamException

createXMLEventWriter

public abstract XMLEventWriter  createXMLEventWriter(OutputStream  stream)
                                             throws XMLStreamException 

스트림에의 기입을 실시하는 새로운 XMLEventWriter 를 작성합니다.

파라미터:

stream - 기입처의 스트림

예외:

XMLStreamException

createXMLEventWriter

public abstract XMLEventWriter  createXMLEventWriter(OutputStream  stream,
                                                    String  encoding)
                                             throws XMLStreamException 

스트림에의 기입을 실시하는 새로운 XMLEventWriter 를 작성합니다.

파라미터:

stream - 기입처의 스트림

encoding - 사용하는 인코딩

예외:

XMLStreamException

createXMLEventWriter

public abstract XMLEventWriter  createXMLEventWriter(Writer  stream)
                                             throws XMLStreamException 

라이터에의 기입을 실시하는 새로운 XMLEventWriter 을 작성합니다.

파라미터:

stream - 기입처의 스트림

예외:

XMLStreamException

setProperty

public abstract void setProperty(String  name,
                                 Object  value)
                          throws IllegalArgumentException 

사용자가 기본이 되는 구현에 특정의 기능과 프로퍼티을 설정할 수 있도록(듯이) 합니다.

파라미터:

name - 프로퍼티의 이름

value - 프로퍼티의 값

예외:

IllegalArgumentException - 프로퍼티이 지원되어 있지 않은 경우

getProperty

public abstract Object  getProperty(String  name)
                            throws IllegalArgumentException 

기본이 되는 구현으로부터 기능 또는 프로퍼티을 가져옵니다.

파라미터:

name - 프로퍼티의 이름

반환값:

프로퍼티의 값

예외:

IllegalArgumentException - 프로퍼티이 지원되어 있지 않은 경우

isPropertySupported

public abstract boolean isPropertySupported(String  name)

이 팩토리가 지원하는 프로퍼티 세트를 조회합니다.

파라미터:

name - 프로퍼티의 이름 (null 이외)

반환값:

프로퍼티이 지원되고 있는 경우는 true, 그렇지 않은 경우는 false