モジュール java.xml

パッケージ 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 final String	ALLOCATOR	アロケータの実装の設定/取得に使用するプロパティです。
static final String	IS_COALESCING	隣接する文字データ・セクションの合体をパーサーに要求するプロパティです。
static final String	IS_NAMESPACE_AWARE	名前空間サポートのオン/オフの切替えに使用するプロパティです。これはXML 1.0文書をサポートするためのものです。trueの設定のみサポートされます。
static final String	IS_REPLACING_ENTITY_REFERENCES	内部エンティティ参照を置換テキストに置き換え、それらを文字として報告することをパーサーに要求します。
static final String	IS_SUPPORTING_EXTERNAL_ENTITIES	外部の解析対象エンティティの解決をパーサーに要求するプロパティです。
static final String	IS_VALIDATING	実装に固有の検証のオン/オフを切り替えるために使用するプロパティです。
static final String	REPORTER	XMLReporterインタフェースの実装の設定/取得に使用するプロパティです。
static final String	RESOLVER	XMLResolverの実装の設定/取得に使用するプロパティです。
static final String	SUPPORT_DTD	DTDのサポートをパーサーに要求するプロパティです。

コンストラクタのサマリー

コンストラクタ

修飾子	コンストラクタ	説明
protected	XMLInputFactory()	インスタンス化を妨げるprotectedコンストラクタです。

メソッドのサマリー

修飾子と型	メソッド	説明
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(String systemId, InputStream stream)	java.io.InputStreamから新しいXMLEventReaderを作成します。
abstract XMLEventReader	createXMLEventReader(String systemId, Reader reader)	リーダーから新しいXMLEventReaderを作成します。
abstract XMLEventReader	createXMLEventReader(XMLStreamReader reader)	XMLStreamReaderから新しいXMLEventReaderを作成します。
abstract XMLEventReader	createXMLEventReader(Source source)	JAXPソースから新しい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(String systemId, InputStream stream)	java.io.InputStreamから新しいXMLStreamReaderを作成します。
abstract XMLStreamReader	createXMLStreamReader(String systemId, Reader reader)	java.io.InputStreamから新しいXMLStreamReaderを作成します。
abstract XMLStreamReader	createXMLStreamReader(Source source)	JAXPソースから新しいXMLStreamReaderを作成します。
abstract XMLEventAllocator	getEventAllocator()	このファクトリを使用して作成されるストリームが使用するアロケータを取得します。
abstract Object	getProperty(String name)	ベースとなる実装から機能またはプロパティの値を取得します。
abstract XMLReporter	getXMLReporter()	任意のXMLStreamReaderまたはXMLEventReaderにレポータを設定します。このファクトリ・インスタンスによって作成されます。
abstract XMLResolver	getXMLResolver()	任意のXMLStreamReaderまたはXMLEventReaderにリゾルバを設定します。このファクトリ・インスタンスによって作成されます。
abstract boolean	isPropertySupported(String name)	このファクトリがサポートするプロパティ・セットを照会します。
static XMLInputFactory	newDefaultFactory()	XMLInputFactory組込みシステム・デフォルト実装の新しいインスタンスを作成します。
static XMLInputFactory	newFactory()	ファクトリの新しいインスタンスを作成します。
static XMLInputFactory	newFactory(String factoryId, ClassLoader classLoader)	ファクトリの新しいインスタンスを作成します。
static XMLInputFactory	newInstance()	newFactory()メソッドとまったく同様にファクトリの新しいインスタンスを作成します。
static XMLInputFactory	newInstance(String factoryId, ClassLoader classLoader)	非推奨。 APIの整合性を維持するために、このメソッドは非推奨になりました。
abstract void	setEventAllocator(XMLEventAllocator allocator)	イベント用のユーザー定義のイベント・アロケータを設定します。
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

アロケータの実装の設定/取得に使用するプロパティです。

関連項目:

• 定数フィールド値

コンストラクタの詳細

XMLInputFactory

protected XMLInputFactory()

インスタンス化を妨げるprotectedコンストラクタです。 代わりにnewFactory()を使用してください。

メソッドの詳細

newDefaultFactory

public static XMLInputFactory newDefaultFactory()

XMLInputFactory組込みシステム・デフォルト実装の新しいインスタンスを作成します。

戻り値:

XMLInputFactory組込みシステム・デフォルト実装の新しいインスタンス。

導入されたバージョン:

9

newInstance

public static XMLInputFactory newInstance() throws FactoryConfigurationError

newFactory()メソッドとまったく同様にファクトリの新しいインスタンスを作成します。

戻り値:

XMLInputFactoryのインスタンス

例外:

FactoryConfigurationError - このファクトリのインスタンスをロードできない場合

newFactory

public static XMLInputFactory newFactory() throws FactoryConfigurationError

ファクトリの新しいインスタンスを作成します。 このメソッドは、「JAXPルックアップ・メカニズム」を使用して、ロードするXMLInputFactory実装クラスを決定します。

アプリケーションがXMLInputFactoryへの参照を取得すると、ファクトリを使用してストリーム・インスタンスを構成および取得できます。

戻り値:

XMLInputFactoryのインスタンス

例外:

FactoryConfigurationError - サービス構成エラーが発生した場合、または実装が使用できないかインスタンス化できない場合。

newInstance

@Deprecated(since="1.7") public static XMLInputFactory newInstance(String factoryId, ClassLoader classLoader) throws FactoryConfigurationError

非推奨。

APIの整合性を維持するために、このメソッドは非推奨になりました。 すべてのnewInstanceメソッドが、対応するnewFactoryメソッドに置き換えられています。 代替のnewFactory(java.lang.String, java.lang.ClassLoader)メソッドでは、動作の変更は定義されていません。

ファクトリの新しいインスタンスを作成します。

パラメータ:

factoryId - 検索するファクトリの名前。プロパティ名と同一

classLoader - 使用するclassLoader

戻り値:

ファクトリの実装

例外:

FactoryConfigurationError - このファクトリのインスタンスをロードできない場合

newFactory

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

ファクトリの新しいインスタンスを作成します。 classLoader引数がnullの場合、ContextClassLoaderが使用されます。

このメソッドは次の順序の検索手順で、ロードするXMLInputFactory実装クラスを決定します。

• factoryIdによって識別されるシステム・プロパティの値を使用する。

• デフォルトでは、「構成ファイル」、jaxp.propertiesに設定されたプロパティfactoryIdの値を使用します。 ファイルが存在し、ファイル内にプロパティfactoryIdが指定されている場合は、その値が実装クラスとして使用されます。

• factoryIdが"javax.xml.stream.XMLInputFactory"の場合は、ServiceLoaderクラスで定義されたサービス・プロバイダのロード機能を使用して、指定されたClassLoaderを使用してサービスの実装を「見つけて読み込む」しようとします。 classLoaderがnullである場合、デフォルトのロード・メカニズムが適用される。つまり、サービス・プロバイダのロード機能は、現在のスレッドのコンテキスト・クラス・ローダーを使用してサービスのロードを試みる。 コンテキスト・クラス・ローダーがnullの場合、システム・クラス・ローダーが使用されます。

• それ以外の場合は、FactoryConfigurationErrorをスローする。

これは非推奨のnewInstance(String factoryId、ClassLoader classLoader)メソッドを置き換える新しいメソッドです。 非推奨のメソッドに関連して、この置換メソッドによって定義されている動作に変更はありません。

APIのノート:

ここで定義されているパラメータfactoryIdは、最初のパラメータがファクトリの実装を提供する完全修飾ファクトリ・クラス名である、他のJAXPファクトリのfactoryIdとは一致しません。

パラメータ:

factoryId - 検索するファクトリの名前。プロパティ名と同一

classLoader - 使用するclassLoader

戻り値:

ファクトリの実装

例外:

FactoryConfigurationError - サービス構成エラーが発生した場合、または実装が使用できないかインスタンス化できない場合。

FactoryConfigurationError - このファクトリのインスタンスをロードできない場合

createXMLStreamReader

public abstract XMLStreamReader createXMLStreamReader(Reader reader) throws XMLStreamException

リーダーから新しいXMLStreamReaderを作成します。

パラメータ:

reader - 読込み元のXMLデータ

戻り値:

XMLStreamReaderのインスタンス

例外:

XMLStreamException - エラーが発生した場合

createXMLStreamReader

public abstract XMLStreamReader createXMLStreamReader(Source source) throws XMLStreamException

JAXPソースから新しいXMLStreamReaderを作成します。 このメソッドはオプションです。

パラメータ:

source - 読込み元のソース

戻り値:

XMLStreamReaderのインスタンス

例外:

UnsupportedOperationException - このXMLInputFactoryでこのメソッドがサポートされていない場合

XMLStreamException - エラーが発生した場合

createXMLStreamReader

public abstract XMLStreamReader createXMLStreamReader(InputStream stream) throws XMLStreamException

java.io.InputStreamから新しいXMLStreamReaderを作成します。

パラメータ:

stream - 読込み元のInputStream

戻り値:

XMLStreamReaderのインスタンス

例外:

XMLStreamException - エラーが発生した場合

createXMLStreamReader

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

java.io.InputStreamから新しいXMLStreamReaderを作成します。

パラメータ:

stream - 読込み元のInputStream

encoding - ストリームの文字エンコーディング

戻り値:

XMLStreamReaderのインスタンス

例外:

XMLStreamException - エラーが発生した場合

createXMLStreamReader

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

java.io.InputStreamから新しいXMLStreamReaderを作成します。

パラメータ:

systemId - ストリームのシステムID

stream - 読込み元のInputStream

戻り値:

XMLStreamReaderのインスタンス

例外:

XMLStreamException - エラーが発生した場合

createXMLStreamReader

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

java.io.InputStreamから新しいXMLStreamReaderを作成します。

パラメータ:

systemId - ストリームのシステムID

reader - 読込み元のInputStream

戻り値:

XMLStreamReaderのインスタンス

例外:

XMLStreamException - エラーが発生した場合

createXMLEventReader

public abstract XMLEventReader createXMLEventReader(Reader reader) throws XMLStreamException

リーダーから新しいXMLEventReaderを作成します。

パラメータ:

reader - 読込み元のXMLデータ

戻り値:

XMLEventReaderのインスタンス

例外:

XMLStreamException - エラーが発生した場合

createXMLEventReader

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

リーダーから新しいXMLEventReaderを作成します。

パラメータ:

systemId - 入力のシステムID

reader - 読込み元のXMLデータ

戻り値:

XMLEventReaderのインスタンス

例外:

XMLStreamException - エラーが発生した場合

createXMLEventReader

public abstract XMLEventReader createXMLEventReader(XMLStreamReader reader) throws XMLStreamException

XMLStreamReaderから新しいXMLEventReaderを作成します。 このメソッドから返されたXMLEventReaderインスタンスの構築に使用されたあとは、そのXMLStreamReaderを使用してはいけません。

パラメータ:

reader - 読込み元のXMLStreamReader (変更されていない)

戻り値:

新しいXMLEventReader

例外:

XMLStreamException - エラーが発生した場合

createXMLEventReader

public abstract XMLEventReader createXMLEventReader(Source source) throws XMLStreamException

JAXPソースから新しいXMLEventReaderを作成します。 このメソッドのサポートはオプションです。

パラメータ:

source - 読込み元のソース

戻り値:

XMLEventReaderのインスタンス

例外:

XMLStreamException - エラーが発生した場合

UnsupportedOperationException - このXMLInputFactoryでこのメソッドがサポートされていない場合

createXMLEventReader

public abstract XMLEventReader createXMLEventReader(InputStream stream) throws XMLStreamException

java.io.InputStreamから新しいXMLEventReaderを作成します。

パラメータ:

stream - 読込み元のInputStream

戻り値:

XMLEventReaderのインスタンス

例外:

XMLStreamException - エラーが発生した場合

createXMLEventReader

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

java.io.InputStreamから新しいXMLEventReaderを作成します。

パラメータ:

stream - 読込み元のInputStream

encoding - ストリームの文字エンコーディング

戻り値:

XMLEventReaderのインスタンス

例外:

XMLStreamException - エラーが発生した場合

createXMLEventReader

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

java.io.InputStreamから新しいXMLEventReaderを作成します。

パラメータ:

systemId - ストリームのシステムID

stream - 読込み元のInputStream

戻り値:

XMLEventReaderのインスタンス

例外:

XMLStreamException - エラーが発生した場合

createFilteredReader

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

リーダーをフィルタでラップするフィルタ処理されたリーダーを作成します。

パラメータ:

reader - フィルタ処理するリーダー

filter - リーダーに適用するフィルタ

戻り値:

XMLEventReaderのインスタンス

例外:

XMLStreamException - エラーが発生した場合

createFilteredReader

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

イベント・リーダーをフィルタでラップするフィルタ処理されたイベント・リーダーを作成します。

パラメータ:

reader - ラップするイベント・リーダー

filter - イベント・リーダーに適用するフィルタ

戻り値:

XMLEventReaderのインスタンス

例外:

XMLStreamException - エラーが発生した場合

getXMLResolver

public abstract XMLResolver getXMLResolver()

任意のXMLStreamReaderまたはXMLEventReaderにリゾルバを設定します。このファクトリ・インスタンスによって作成されます。

戻り値:

XMLResolverのインスタンス

setXMLResolver

public abstract void setXMLResolver(XMLResolver resolver)

任意のXMLStreamReaderまたはXMLEventReaderにリゾルバを設定します。このファクトリ・インスタンスによって作成されます。

パラメータ:

resolver - 参照の解決に使用されるリゾルバ

getXMLReporter

public abstract XMLReporter getXMLReporter()

任意のXMLStreamReaderまたはXMLEventReaderにレポータを設定します。このファクトリ・インスタンスによって作成されます。

戻り値:

XMLReporterのインスタンス

setXMLReporter

public abstract void setXMLReporter(XMLReporter reporter)

任意のXMLStreamReaderまたはXMLEventReaderにレポータを設定します。このファクトリ・インスタンスによって作成されます。

パラメータ:

reporter - 重大ではないエラーの報告に使用されるリゾルバ

setProperty

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

ユーザーがベースとなる実装に特定の機能とプロパティを設定できるようにします。 ベースとなる実装では、仕様にあるすべてのプロパティの設定をすべてサポートすることは要求されません。また、ベースとなる実装ではIllegalArgumentExceptionを使用して、サポートされないプロパティに指定値を設定できないことを通知できます。

JAXP 1.5またはそれ以降を実装する実装はすべて、XMLConstants.ACCESS_EXTERNAL_DTDプロパティをサポートしている必要があります。

• 外部DTDおよび外部エンティティ参照へのアクセスが、そのプロパティで指定されたプロトコルに制限されます。 このプロパティの制限が原因で構文解析中にアクセスが拒否された場合は、XMLStreamReader.next()またはXMLEventReader.nextEvent()メソッドによってXMLStreamExceptionがスローされます。

パラメータ:

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)

イベント用のユーザー定義のイベント・アロケータを設定します。

パラメータ:

allocator - ユーザー定義のアロケータ

getEventAllocator

public abstract XMLEventAllocator getEventAllocator()

このファクトリを使用して作成されるストリームが使用するアロケータを取得します。

戻り値:

XMLEventAllocatorのインスタンス