javax.xml.stream
클래스 XMLInputFactory

java.lang.Object 
  javax.xml.stream.XMLInputFactory

public abstract class XMLInputFactory
extends Object 

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

구성 파라미터
프로퍼티명	동작	귀가형	디폴트 값	필수
javax.xml.stream.isValidating	구현에 고유의 DTD 검증의 온/오프를 바꾸는	Boolean	False	없음
javax.xml.stream.isNamespaceAware	XML 1.0 지원의 이름 공간 처리의 온/오프를 바꾸는	Boolean	True	True (필수) / False (옵션)
javax.xml.stream.isCoalescing	인접하는 문자 데이터의 합체를 프로세서에 요구하는	Boolean	False	있어
javax.xml.stream.isReplacingEntityReferences	내부 엔티티 참조를 치환 텍스트에 옮겨놓아 그것들을 문자로서 보고하는	Boolean	True	있어
javax.xml.stream.isSupportingExternalEntities	외부의 해석 대상 엔티티를 해결하는	Boolean	지정 서로 이루어
javax.xml.stream.supportDTD	DTD 를 지원하지 않는 프로세서를 요구하는 경우는, 이 프로퍼티을 사용하는	Boolean	True	있어
javax.xml.stream.reporter	XMLReporter 의 구현을 설정/취득하는	javax.xml.stream.XMLReporter	Null	있어
javax.xml.stream.resolver	XMLResolver 인터페이스의 구현을 설정/취득하는	javax.xml.stream.XMLResolver	Null	있어
javax.xml.stream.allocator	XMLEventAllocator 인터페이스의 구현을 설정/취득하는	javax.xml.stream.util.XMLEventAllocator	Null	있어

도입된 버젼:

1.6

관련 항목:

XMLOutputFactory , XMLEventReader , XMLStreamReader , EventFilter , XMLReporter , XMLResolver , XMLEventAllocator

필드의 개요

static String	ALLOCATOR allocater의 구현의 설정/취득에 사용하는 프로퍼티입니다.
static String	IS_COALESCING 인접하는 문자 데이터 섹션의 합체를 퍼서에게 요구하는 프로퍼티입니다.
static String	IS_NAMESPACE_AWARE 이름 공간 지원의 온/오프의 바꾸어에 사용하는 프로퍼티입니다.
static String	IS_REPLACING_ENTITY_REFERENCES 내부 엔티티 참조를 치환 텍스트에 옮겨놓아 그것들을 문자로서 보고하는 것을 퍼서에게 요구합니다.
static String	IS_SUPPORTING_EXTERNAL_ENTITIES 외부의 해석 대상 엔티티의 해결을 퍼서에게 요구하는 프로퍼티입니다.
static String	IS_VALIDATING 구현에 고유의 검증의 온/오프를 바꾸기 위해서(때문에) 사용하는 프로퍼티입니다.
static String	REPORTER XMLReporter 인터페이스의 구현의 설정/취득에 사용하는 프로퍼티입니다.
static String	RESOLVER XMLResolver 의 구현의 설정/취득에 사용하는 프로퍼티입니다.
static String	SUPPORT_DTD DTD 의 지원를 퍼서에게 요구하는 프로퍼티입니다.

생성자 의 개요

protected

XMLInputFactory ()

메소드의 개요

abstract XMLEventReader	createFilteredReader (XMLEventReader reader, EventFilter filter) 이벤트 리더를 필터로 랩 하는 필터 처리된 이벤트 리더를 작성합니다.
abstract XMLStreamReader	createFilteredReader (XMLStreamReader reader, StreamFilter filter) 리더를 필터로 랩 하는 필터 처리된 리더를 작성합니다.
abstract XMLEventReader	createXMLEventReader (InputStream stream) java.io.InputStream 로부터 새로운 XMLEventReader 를 작성합니다.
abstract XMLEventReader	createXMLEventReader (InputStream stream, String encoding) java.io.InputStream 로부터 새로운 XMLEventReader 를 작성합니다.
abstract XMLEventReader	createXMLEventReader (Reader reader) 리더로부터 새로운 XMLEventReader 를 작성합니다.
abstract XMLEventReader	createXMLEventReader (Source source) JAXP 소스로부터 새로운 XMLEventReader 를 작성합니다.
abstract XMLEventReader	createXMLEventReader (String systemId, InputStream stream) java.io.InputStream 로부터 새로운 XMLEventReader 를 작성합니다.
abstract XMLEventReader	createXMLEventReader (String systemId, Reader reader) 리더로부터 새로운 XMLEventReader 를 작성합니다.
abstract XMLEventReader	createXMLEventReader (XMLStreamReader reader) XMLStreamReader 로부터 새로운 XMLEventReader 를 작성합니다.
abstract XMLStreamReader	createXMLStreamReader (InputStream stream) java.io.InputStream 로부터 새로운 XMLStreamReader 를 작성합니다.
abstract XMLStreamReader	createXMLStreamReader (InputStream stream, String encoding) java.io.InputStream 로부터 새로운 XMLStreamReader 를 작성합니다.
abstract XMLStreamReader	createXMLStreamReader (Reader reader) 리더로부터 새로운 XMLStreamReader 를 작성합니다.
abstract XMLStreamReader	createXMLStreamReader (Source source) JAXP 소스로부터 새로운 XMLStreamReader 를 작성합니다.
abstract XMLStreamReader	createXMLStreamReader (String systemId, InputStream stream) java.io.InputStream 로부터 새로운 XMLStreamReader 를 작성합니다.
abstract XMLStreamReader	createXMLStreamReader (String systemId, Reader reader) java.io.InputStream 로부터 새로운 XMLStreamReader 를 작성합니다.
abstract XMLEventAllocator	getEventAllocator () 이 팩토리를 사용해 작성되는 스트림이 사용하는 allocater를 가져옵니다.
abstract Object	getProperty (String name) 기본이 되는 구현으로부터 기능 또는 프로퍼티의 값을 가져옵니다.
abstract XMLReporter	getXMLReporter () 임의의 XMLStreamReader 또는 XMLEventReader 로 설정되어 있는 레포타를 가져옵니다.
abstract XMLResolver	getXMLResolver () 임의의 XMLStreamReader 또는 XMLEventReader 로 설정되어 있는 리절버를 가져옵니다.
abstract boolean	isPropertySupported (String name) 이 팩토리가 지원하는 프로퍼티세트를 조회합니다.
static XMLInputFactory	newInstance () 팩토리의 새로운 인스턴스를 작성합니다.
static XMLInputFactory	newInstance (String factoryId, ClassLoader classLoader) 팩토리의 새로운 인스턴스를 작성합니다.
abstract void	setEventAllocator (XMLEventAllocator allocator) 이벤트용의 사용자 정의의 이벤트 allocater를 설정합니다.
abstract void	setProperty (String name, Object value) 사용자가 기본이 되는 구현에 특정의 기능과 프로퍼티을 설정할 수 있도록(듯이) 합니다.
abstract void	setXMLReporter (XMLReporter reporter) 임의의 XMLStreamReader 또는 XMLEventReader 에 레포타를 설정합니다.
abstract void	setXMLResolver (XMLResolver resolver) 임의의 XMLStreamReader 또는 XMLEventReader 에 리절버를 설정합니다.

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

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

필드의 상세

IS_NAMESPACE_AWARE

public static final String  IS_NAMESPACE_AWARE

이름 공간 지원의 온/오프의 바꾸어에 사용하는 프로퍼티입니다. 이것은 XML 1.0 문서를 지원하기 위한의 것입니다. true 의 설정만 지원됩니다.

관련 항목:

정수 필드치

IS_VALIDATING

public static final String  IS_VALIDATING

구현에 고유의 검증의 온/오프를 바꾸기 위해서(때문에) 사용하는 프로퍼티입니다.

관련 항목:

정수 필드치

IS_COALESCING

public static final String  IS_COALESCING

인접하는 문자 데이터 섹션의 합체를 퍼서에게 요구하는 프로퍼티입니다.

관련 항목:

정수 필드치

IS_REPLACING_ENTITY_REFERENCES

public static final String  IS_REPLACING_ENTITY_REFERENCES

내부 엔티티 참조를 치환 텍스트에 옮겨놓아 그것들을 문자로서 보고하는 것을 퍼서에게 요구합니다.

관련 항목:

정수 필드치

IS_SUPPORTING_EXTERNAL_ENTITIES

public static final String  IS_SUPPORTING_EXTERNAL_ENTITIES

외부의 해석 대상 엔티티의 해결을 퍼서에게 요구하는 프로퍼티입니다.

관련 항목:

정수 필드치

SUPPORT_DTD

public static final String  SUPPORT_DTD

DTD 의 지원를 퍼서에게 요구하는 프로퍼티입니다.

관련 항목:

정수 필드치

REPORTER

public static final String  REPORTER

XMLReporter 인터페이스의 구현의 설정/취득에 사용하는 프로퍼티입니다.

관련 항목:

정수 필드치

RESOLVER

public static final String  RESOLVER

XMLResolver 의 구현의 설정/취득에 사용하는 프로퍼티입니다.

관련 항목:

정수 필드치

ALLOCATOR

public static final String  ALLOCATOR

allocater의 구현의 설정/취득에 사용하는 프로퍼티입니다.

관련 항목:

정수 필드치

생성자 의 상세

XMLInputFactory

protected XMLInputFactory()

메소드의 상세

newInstance

public static XMLInputFactory  newInstance()
                                   throws FactoryConfigurationError 

팩토리의 새로운 인스턴스를 작성합니다. 이 static 메소드는 새로운 팩토리 인스턴스를 작성합니다. 이 메소드는 다음의 순서의 검색 순서로, 로드하는 XMLInputFactory 구현 클래스를 결정합니다. javax.xml.stream.XMLInputFactory system 프로퍼티을 사용한다. JRE 디렉토리내의 프로퍼티 파일 lib/stax.properties 를 사용한다. 이 구성 파일은 표준의 java.util.Properties 형식이며, 상기와 같이 정의된 시스템 프로퍼티인 키를 가지는 구현 클래스의 완전 지정의 이름을 포함한다. 가능하면, JAR 스펙으로 상세하게 설명되고 있는 서비스 API 를 사용해, 클래스명을 판정한다. 서비스 API 는, 실행시에 사용할 수 있는 jar 내의 META-INF/services/javax.xml.stream.XMLInputFactory 파일로부터 클래스명을 검색한다. 디폴트의 XMLInputFactory 인스턴스를 플랫폼으로 한다. 어플리케이션이 XMLInputFactory 에의 참조를 취득하면(자), 팩토리를 사용해 스트림의 인스턴스를 설정 및 취득할 수가 있습니다.

예외:

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

newInstance

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

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

파라미터:

factoryId - 검색하는 팩토리의 이름. 프로퍼티명과 동일

classLoader - 사용하는 classLoader

반환값:

팩토리의 구현

예외:

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

createXMLStreamReader

public abstract XMLStreamReader  createXMLStreamReader(Reader  reader)
                                               throws XMLStreamException 

리더로부터 새로운 XMLStreamReader 를 작성합니다.

파라미터:

reader - read원의 XML 데이터

예외:

XMLStreamException

createXMLStreamReader

public abstract XMLStreamReader  createXMLStreamReader(Source  source)
                                               throws XMLStreamException 

JAXP 소스로부터 새로운 XMLStreamReader 를 작성합니다. 이 메소드는 옵션입니다.

파라미터:

source - read원의 소스

예외:

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

XMLStreamException

createXMLStreamReader

public abstract XMLStreamReader  createXMLStreamReader(InputStream  stream)
                                               throws XMLStreamException 

java.io.InputStream 로부터 새로운 XMLStreamReader 를 작성합니다.

파라미터:

stream - read원의 InputStream

예외:

XMLStreamException

createXMLStreamReader

public abstract XMLStreamReader  createXMLStreamReader(InputStream  stream,
                                                      String  encoding)
                                               throws XMLStreamException 

java.io.InputStream 로부터 새로운 XMLStreamReader 를 작성합니다.

파라미터:

stream - read원의 InputStream

encoding - 스트림의 문자 인코딩

예외:

XMLStreamException

createXMLStreamReader

public abstract XMLStreamReader  createXMLStreamReader(String  systemId,
                                                      InputStream  stream)
                                               throws XMLStreamException 

java.io.InputStream 로부터 새로운 XMLStreamReader 를 작성합니다.

파라미터:

systemId - 스트림의 시스템 ID

stream - read원의 InputStream

예외:

XMLStreamException

createXMLStreamReader

public abstract XMLStreamReader  createXMLStreamReader(String  systemId,
                                                      Reader  reader)
                                               throws XMLStreamException 

java.io.InputStream 로부터 새로운 XMLStreamReader 를 작성합니다.

파라미터:

systemId - 스트림의 시스템 ID

reader - read원의 XML 데이터

예외:

XMLStreamException

createXMLEventReader

public abstract XMLEventReader  createXMLEventReader(Reader  reader)
                                             throws XMLStreamException 

리더로부터 새로운 XMLEventReader 를 작성합니다.

파라미터:

reader - read원의 XML 데이터

예외:

XMLStreamException

createXMLEventReader

public abstract XMLEventReader  createXMLEventReader(String  systemId,
                                                    Reader  reader)
                                             throws XMLStreamException 

리더로부터 새로운 XMLEventReader 를 작성합니다.

파라미터:

systemId - 입력의 시스템 ID

reader - read원의 XML 데이터

예외:

XMLStreamException

createXMLEventReader

public abstract XMLEventReader  createXMLEventReader(XMLStreamReader  reader)
                                             throws XMLStreamException 

XMLStreamReader 로부터 새로운 XMLEventReader 를 작성합니다. 이 메소드로부터 반환된 XMLEventReader 인스턴스의 구축에 사용된 뒤는, 그 XMLStreamReader 를 사용 해서는 안됩니다.

파라미터:

reader - read원의 XMLStreamReader (변경되어 있지 않다)

반환값:

새로운 XMLEventReader

예외:

XMLStreamException

createXMLEventReader

public abstract XMLEventReader  createXMLEventReader(Source  source)
                                             throws XMLStreamException 

JAXP 소스로부터 새로운 XMLEventReader 를 작성합니다. 이 메소드의 지원는 옵션입니다.

파라미터:

source - read원의 소스

예외:

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

XMLStreamException

createXMLEventReader

public abstract XMLEventReader  createXMLEventReader(InputStream  stream)
                                             throws XMLStreamException 

java.io.InputStream 로부터 새로운 XMLEventReader 를 작성합니다.

파라미터:

stream - read원의 InputStream

예외:

XMLStreamException

createXMLEventReader

public abstract XMLEventReader  createXMLEventReader(InputStream  stream,
                                                    String  encoding)
                                             throws XMLStreamException 

java.io.InputStream 로부터 새로운 XMLEventReader 를 작성합니다.

파라미터:

stream - read원의 InputStream

encoding - 스트림의 문자 인코딩

예외:

XMLStreamException

createXMLEventReader

public abstract XMLEventReader  createXMLEventReader(String  systemId,
                                                    InputStream  stream)
                                             throws XMLStreamException 

java.io.InputStream 로부터 새로운 XMLEventReader 를 작성합니다.

파라미터:

systemId - 스트림의 시스템 ID

stream - read원의 InputStream

예외:

XMLStreamException

createFilteredReader

public abstract XMLStreamReader  createFilteredReader(XMLStreamReader  reader,
                                                     StreamFilter  filter)
                                              throws XMLStreamException 

리더를 필터로 랩 하는 필터 처리된 리더를 작성합니다.

파라미터:

reader - 필터 처리하는 리더

filter - 리더에게 적용하는 필터

예외:

XMLStreamException

createFilteredReader

public abstract XMLEventReader  createFilteredReader(XMLEventReader  reader,
                                                    EventFilter  filter)
                                             throws XMLStreamException 

이벤트 리더를 필터로 랩 하는 필터 처리된 이벤트 리더를 작성합니다.

파라미터:

reader - 랩 하는 이벤트 리더

filter - 이벤트 리더에게 적용하는 필터

예외:

XMLStreamException

getXMLResolver

public abstract XMLResolver  getXMLResolver()

임의의 XMLStreamReader 또는 XMLEventReader 로 설정되어 있는 리절버를 가져옵니다.

setXMLResolver

public abstract void setXMLResolver(XMLResolver  resolver)

임의의 XMLStreamReader 또는 XMLEventReader 에 리절버를 설정합니다. 이 팩토리 인스턴스에 의해 작성됩니다.

파라미터:

resolver - 참조의 해결에 사용되는 리절버

getXMLReporter

public abstract XMLReporter  getXMLReporter()

임의의 XMLStreamReader 또는 XMLEventReader 로 설정되어 있는 레포타를 가져옵니다.

setXMLReporter

public abstract void setXMLReporter(XMLReporter  reporter)

임의의 XMLStreamReader 또는 XMLEventReader 에 레포타를 설정합니다. 이 팩토리 인스턴스에 의해 작성됩니다.

파라미터:

reporter - 중대하지 않는 에러의 보고에 사용되는 리절버

setProperty

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

사용자가 기본이 되는 구현에 특정의 기능과 프로퍼티을 설정할 수 있도록(듯이) 합니다. 기본이 되는 구현에서는, 스펙에 있는 모든 프로퍼티의 설정을 모두 지원하는 것은 요구되지 않습니다. 또, 기본이 되는 구현에서는 IllegalArgumentException 를 사용해, 지원되지 않는 프로퍼티으로 지정치를 설정할 수 없는 것을 통지할 수 있습니다.

파라미터:

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

value - 프로퍼티의 값

예외:

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

getProperty

public abstract Object  getProperty(String  name)
                            throws IllegalArgumentException 

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

파라미터:

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

반환값:

프로퍼티의 값

예외:

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

isPropertySupported

public abstract boolean isPropertySupported(String  name)

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

파라미터:

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

반환값:

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

setEventAllocator

public abstract void setEventAllocator(XMLEventAllocator  allocator)

이벤트용의 사용자 정의의 이벤트 allocater를 설정합니다.

파라미터:

allocator - 사용자 정의의 allocater

getEventAllocator

public abstract XMLEventAllocator  getEventAllocator()

이 팩토리를 사용해 작성되는 스트림이 사용하는 allocater를 가져옵니다.