- java.lang.Object
-
- javax.xml.stream.XMLEventFactory
-
public abstract class XMLEventFactory extends Object
このインタフェースは、XMLEventのインスタンスを作成するためのユーティリティ・クラスを定義します。- 導入されたバージョン:
- 1.6
- 関連項目:
StartElement
,EndElement
,ProcessingInstruction
,Comment
,Characters
,StartDocument
,EndDocument
,DTD
-
-
コンストラクタのサマリー
コンストラクタ 修飾子 コンストラクタ 説明 protected
XMLEventFactory()
-
メソッドのサマリー
修飾子と型 メソッド 説明 abstract Attribute
createAttribute(String localName, String value)
新しいAttributeを作成します。abstract Attribute
createAttribute(String prefix, String namespaceURI, String localName, String value)
新しいAttributeを作成します。abstract Attribute
createAttribute(QName name, String value)
新しいAttributeを作成します。abstract Characters
createCData(String content)
CDataフラグがtrueに設定されているCharactersイベントを作成します。abstract Characters
createCharacters(String content)
Charactersイベントを作成します。このメソッドは、内容がすべて空白文字であるかどうかをチェックしません。abstract Comment
createComment(String text)
コメントを作成します。abstract DTD
createDTD(String dtd)
文書型定義イベントを作成します。この文字列には、XML 1.0仕様のdoctypedeclに一致する文書型宣言のすべてが含まれます。abstract EndDocument
createEndDocument()
EndDocumentイベントの新しいインスタンスを作成します。abstract EndElement
createEndElement(String prefix, String namespaceUri, String localName)
新しいEndElementを作成します。abstract EndElement
createEndElement(String prefix, String namespaceUri, String localName, Iterator<? extends Namespace> namespaces)
新しいEndElementを作成します。abstract EndElement
createEndElement(QName name, Iterator<? extends Namespace> namespaces)
新しいEndElementを作成します。abstract EntityReference
createEntityReference(String name, EntityDeclaration declaration)
EntityReferenceイベントの新しいインスタンスを作成します。abstract Characters
createIgnorableSpace(String content)
無視できる空白を作成します。abstract Namespace
createNamespace(String namespaceURI)
新しいデフォルトのNamespaceを作成します。abstract Namespace
createNamespace(String prefix, String namespaceUri)
新しいNamespaceを作成します。abstract ProcessingInstruction
createProcessingInstruction(String target, String data)
処理命令を作成します。abstract Characters
createSpace(String content)
isSpaceフラグがtrueに設定されているCharactersイベントを作成します。abstract StartDocument
createStartDocument()
StartDocumentイベントの新しいインスタンスを作成します。abstract StartDocument
createStartDocument(String encoding)
StartDocumentイベントの新しいインスタンスを作成します。abstract StartDocument
createStartDocument(String encoding, String version)
StartDocumentイベントの新しいインスタンスを作成します。abstract StartDocument
createStartDocument(String encoding, String version, boolean standalone)
StartDocumentイベントの新しいインスタンスを作成します。abstract StartElement
createStartElement(String prefix, String namespaceUri, String localName)
新しいStartElementを作成します。abstract StartElement
createStartElement(String prefix, String namespaceUri, String localName, Iterator<? extends Attribute> attributes, Iterator<? extends Namespace> namespaces)
新しいStartElementを作成します。abstract StartElement
createStartElement(String prefix, String namespaceUri, String localName, Iterator<? extends Attribute> attributes, Iterator<? extends Namespace> namespaces, NamespaceContext context)
新しいStartElementを作成します。abstract StartElement
createStartElement(QName name, Iterator<? extends Attribute> attributes, Iterator<? extends Namespace> namespaces)
新しいStartElementを作成します。static XMLEventFactory
newDefaultFactory()
XMLEventFactory
組み込みシステムのデフォルト実装の新しいインスタンスを作成します。static XMLEventFactory
newFactory()
ファクトリの新しいインスタンスを作成します。static XMLEventFactory
newFactory(String factoryId, ClassLoader classLoader)
ファクトリの新しいインスタンスを作成します。static XMLEventFactory
newInstance()
newFactory()
メソッドとまったく同様にファクトリの新しいインスタンスを作成します。static XMLEventFactory
newInstance(String factoryId, ClassLoader classLoader)
非推奨。APIの整合性を維持するために、このメソッドは非推奨になりました。abstract void
setLocation(Location location)
このメソッドを使用すると、このファクトリによって作成された各イベントでLocationを設定できます。
-
-
-
メソッドの詳細
-
newDefaultFactory
public static XMLEventFactory newDefaultFactory()
XMLEventFactory
組み込みシステムのデフォルト実装の新しいインスタンスを作成します。- 戻り値:
XMLEventFactory
組み込みシステムのデフォルト実装の新しいインスタンス。- 導入されたバージョン:
- 9
-
newInstance
public static XMLEventFactory newInstance() throws FactoryConfigurationError
newFactory()
メソッドとまったく同様にファクトリの新しいインスタンスを作成します。- 例外:
FactoryConfigurationError
- このファクトリのインスタンスをロードできない場合
-
newFactory
public static XMLEventFactory newFactory() throws FactoryConfigurationError
ファクトリの新しいインスタンスを作成します。このstaticメソッドは新しいファクトリ・インスタンスを作成します。 このメソッドは次の順序の検索手順で、ロードするXMLEventFactory実装クラスを決定します。
- javax.xml.stream.XMLEventFactoryシステム・プロパティを使用する。
-
構成ファイル"stax.properties"を使用します。 このファイルは標準の
Properties
形式であり、通常Javaインストールのconf
ディレクトリにあります。 これには、実装クラスの完全修飾名が格納されています。stax.propertiesファイルは実装によって一度だけ読み込まれ、その値は将来の使用のためにキャッシュされます。 最初の読込み時にファイルが存在しないと、そのあとにその存在がチェックされることはない。 stax.propertiesが最初に読み込まれた後に、そのプロパティの値を変更することはできません。
jaxp構成ファイル"jaxp.properties"を使用します。 このファイルはstax.propertiesと同じ形式であり、stax.propertiesが存在しない場合にのみ読み込まれます。
-
ServiceLoader
クラスで定義されているサービス・プロバイダ・ローディング機能を使用して、デフォルトのロード・メカニズムを使用してサービスの実装を特定してロード: サービス・プロバイダ・ローディング機能は、現在のスレッド・コンテキスト・クラス・ローダーを使用してサービスをロードしようとします。 コンテキスト・クラス・ローダーがnullの場合、システム・クラス・ローダーが使用されます。 -
それ以外の場合は、system-default実装が返されます。
アプリケーションがXMLEventFactoryへの参照を取得すると、ファクトリを使用してストリームのインスタンスを構成および取得することができます。
- 例外:
FactoryConfigurationError
- サービス構成エラーが発生した場合、または実装が使用できないかインスタンス化できない場合。
-
newInstance
@Deprecated(since="1.7") public static XMLEventFactory newInstance(String factoryId, ClassLoader classLoader) throws FactoryConfigurationError
非推奨。APIの整合性を維持するために、このメソッドは非推奨になりました。 すべてのnewInstanceメソッドが、対応するnewFactoryメソッドに置き換えられています。 代替のnewFactory(java.lang.String, java.lang.ClassLoader)
メソッドでは、動作の変更は定義されていません。ファクトリの新しいインスタンスを作成します。- パラメータ:
factoryId
- 検索するファクトリの名前。プロパティ名と同一classLoader
- 使用するclassLoader- 戻り値:
- ファクトリの実装
- 例外:
FactoryConfigurationError
- このファクトリのインスタンスをロードできない場合
-
newFactory
public static XMLEventFactory newFactory(String factoryId, ClassLoader classLoader) throws FactoryConfigurationError
ファクトリの新しいインスタンスを作成します。 classLoader引数がnullの場合、ContextClassLoaderが使用されます。このメソッドは次の順序の検索手順で、ロードするXMLEventFactory実装クラスを決定します。
-
factoryId
によって識別されるシステム・プロパティの値を使用する。 -
構成ファイル"stax.properties"を使用します。 このファイルは標準の
Properties
形式であり、通常Javaインストールのconfディレクトリにあります。 これには、実装クラスの完全修飾名が格納されています。stax.propertiesファイルは実装によって一度だけ読み込まれ、その値は将来の使用のためにキャッシュされます。 最初の読込み時にファイルが存在しないと、そのあとにその存在がチェックされることはない。 stax.propertiesが最初に読み込まれた後に、そのプロパティの値を変更することはできません。
jaxp構成ファイル"jaxp.properties"を使用します。 このファイルはstax.propertiesと同じ形式であり、stax.propertiesが存在しない場合にのみ読み込まれます。
-
factoryId
が"javax.xml.stream.XMLEventFactory"の場合は、ServiceLoader
クラスで定義されているサービス・プロバイダ・ロード機能を使用して、指定されたClassLoader
を使用してサービスの実装を「見つけて読み込む」しようとします。classLoader
がnullである場合、デフォルトのロード・メカニズムが適用される。つまり、サービス・プロバイダのロード機能は、現在のスレッドのコンテキスト・クラス・ローダーを使用してサービスのロードを試みる。 コンテキスト・クラス・ローダーがnullの場合、システム・クラス・ローダーが使用されます。 -
それ以外の場合は、
FactoryConfigurationError
をスローする。
これは非推奨の
newInstance(String factoryId、ClassLoader classLoader)
メソッドを置き換える新しいメソッドです。 非推奨のメソッドに関連して、この置換メソッドによって定義されている動作に変更はありません。- APIの注:
- ここで定義されているパラメータfactoryIdは、最初のパラメータがファクトリの実装を提供する完全修飾ファクトリ・クラス名である、他のJAXPファクトリのfactoryIdとは一致しません。
- パラメータ:
factoryId
- 検索するファクトリの名前。プロパティ名と同一classLoader
- 使用するclassLoader- 戻り値:
- ファクトリの実装
- 例外:
FactoryConfigurationError
- サービス構成エラーが発生した場合、または実装が使用できないかインスタンス化できない場合。
-
-
setLocation
public abstract void setLocation(Location location)
このメソッドを使用すると、このファクトリによって作成された各イベントでLocationを設定できます。 これらの値は、このファクトリによって作成されたイベントに値コピーされます。 位置情報をリセットするには、位置をnullに設定します。- パラメータ:
location
- 作成されるイベントごとに設定する位置
-
createAttribute
public abstract Attribute createAttribute(String prefix, String namespaceURI, String localName, String value)
新しいAttributeを作成します。- パラメータ:
prefix
- この属性の接頭辞。null以外namespaceURI
- 属性値はこの値に設定される。null以外localName
- 属性のXML名のローカル名。localNameをnullにすることはできないvalue
- 設定される属性値。null以外- 戻り値:
- 指定した値を持つAttribute
-
createAttribute
public abstract Attribute createAttribute(String localName, String value)
新しいAttributeを作成します。- パラメータ:
localName
- 属性のXML名のローカル名。localNameをnullにすることはできないvalue
- 設定される属性値。null以外- 戻り値:
- 指定した値を持つAttribute
-
createAttribute
public abstract Attribute createAttribute(QName name, String value)
新しいAttributeを作成します。- パラメータ:
name
- 属性の修飾名。null以外value
- 設定される属性値。null以外- 戻り値:
- 指定した値を持つAttribute
-
createNamespace
public abstract Namespace createNamespace(String namespaceURI)
新しいデフォルトのNamespaceを作成します。- パラメータ:
namespaceURI
- デフォルトの名前空間URI- 戻り値:
- 指定された値を持つNamespace
-
createNamespace
public abstract Namespace createNamespace(String prefix, String namespaceUri)
新しいNamespaceを作成します。- パラメータ:
prefix
- この名前空間の接頭辞。null以外namespaceUri
- 属性値はこの値に設定される。null以外- 戻り値:
- 指定された値を持つNamespace
-
createStartElement
public abstract StartElement createStartElement(QName name, Iterator<? extends Attribute> attributes, Iterator<? extends Namespace> namespaces)
新しいStartElementを作成します。 Namespaceインタフェースのセットを順次処理するイテレータを渡すことで、NamespaceをこのStartElementに追加できます。 Attributeインタフェースのセットを順次処理するイテレータを渡すことで、AttributeをこのStartElementに追加できます。- パラメータ:
name
- 属性の修飾名。null以外attributes
- 新しいStartElementに追加するAttributeを実装するオブジェクトの順序付けされていないオプション・セット。nullの場合もあるnamespaces
- 新しいStartElementに追加するNamespaceを実装するオブジェクトの順序付けされていないオプション・セット。nullの場合もある- 戻り値:
- 要求されたStartElementのインスタンス
-
createStartElement
public abstract StartElement createStartElement(String prefix, String namespaceUri, String localName)
新しいStartElementを作成します。 NamespaceContextのデフォルトを空のNamespaceContextに設定します。 このイベントを名前空間または属性で照会すると、空のイテレータが返されます。- パラメータ:
namespaceUri
- 新しいStartElementのQNameのURIlocalName
- 新しいStartElementのQNameのローカル名prefix
- 新しいStartElementのQNameの接頭辞- 戻り値:
- 要求されたStartElementのインスタンス
-
createStartElement
public abstract StartElement createStartElement(String prefix, String namespaceUri, String localName, Iterator<? extends Attribute> attributes, Iterator<? extends Namespace> namespaces)
新しいStartElementを作成します。 Namespaceインタフェースのセットを順次処理するイテレータを渡すことで、NamespaceをこのStartElementに追加できます。 Attributeインタフェースのセットを順次処理するイテレータを渡すことで、AttributeをこのStartElementに追加できます。- パラメータ:
namespaceUri
- 新しいStartElementのQNameのURIlocalName
- 新しいStartElementのQNameのローカル名prefix
- 新しいStartElementのQNameの接頭辞attributes
- 新しいStartElementに追加するAttributeを実装するオブジェクトの順序付けされていないセットnamespaces
- 新しいStartElementに追加するNamespaceを実装するオブジェクトの順序付けされていないセット- 戻り値:
- 要求されたStartElementのインスタンス
-
createStartElement
public abstract StartElement createStartElement(String prefix, String namespaceUri, String localName, Iterator<? extends Attribute> attributes, Iterator<? extends Namespace> namespaces, NamespaceContext context)
新しいStartElementを作成します。 Namespaceインタフェースのセットを順次処理するイテレータを渡すことで、NamespaceをこのStartElementに追加できます。 Attributeインタフェースのセットを順次処理するイテレータを渡すことで、AttributeをこのStartElementに追加できます。- パラメータ:
namespaceUri
- 新しいStartElementのQNameのURIlocalName
- 新しいStartElementのQNameのローカル名prefix
- 新しいStartElementのQNameの接頭辞attributes
- 新しいStartElementに追加するAttributeを実装するオブジェクトの順序付けされていないセット。nullの場合もあるnamespaces
- 新しいStartElementに追加するNamespaceを実装するオブジェクトの順序付けされていないセット。nullの場合もあるcontext
- この要素の名前空間コンテキスト- 戻り値:
- 要求されたStartElementのインスタンス
-
createEndElement
public abstract EndElement createEndElement(QName name, Iterator<? extends Namespace> namespaces)
新しいEndElementを作成します。- パラメータ:
name
- EndElementの修飾名namespaces
- 範囲外になったNamespaceを実装するオブジェクトの順序付けされていないオプション・セット。nullの場合もある- 戻り値:
- 要求されたEndElementのインスタンス
-
createEndElement
public abstract EndElement createEndElement(String prefix, String namespaceUri, String localName)
新しいEndElementを作成します。- パラメータ:
namespaceUri
- 新しいStartElementのQNameのURIlocalName
- 新しいStartElementのQNameのローカル名prefix
- 新しいStartElementのQNameの接頭辞- 戻り値:
- 要求されたEndElementのインスタンス
-
createEndElement
public abstract EndElement createEndElement(String prefix, String namespaceUri, String localName, Iterator<? extends Namespace> namespaces)
新しいEndElementを作成します。- パラメータ:
namespaceUri
- 新しいStartElementのQNameのURIlocalName
- 新しいStartElementのQNameのローカル名prefix
- 新しいStartElementのQNameの接頭辞namespaces
- 範囲外になったNamespaceを実装するオブジェクトの順序付けされていないセット。nullの場合もある- 戻り値:
- 要求されたEndElementのインスタンス
-
createCharacters
public abstract Characters createCharacters(String content)
Charactersイベントを作成します。このメソッドは、内容がすべて空白文字であるかどうかをチェックしません。 空白イベントを作成するには、#createSpace(String)を使用します- パラメータ:
content
- 作成する文字列- 戻り値:
- Charactersイベント
-
createCData
public abstract Characters createCData(String content)
CDataフラグがtrueに設定されているCharactersイベントを作成します。- パラメータ:
content
- 作成する文字列- 戻り値:
- Charactersイベント
-
createSpace
public abstract Characters createSpace(String content)
isSpaceフラグがtrueに設定されているCharactersイベントを作成します。- パラメータ:
content
- 作成する空白の内容- 戻り値:
- Charactersイベント
-
createIgnorableSpace
public abstract Characters createIgnorableSpace(String content)
無視できる空白を作成します。- パラメータ:
content
- 作成する空白- 戻り値:
- Charactersイベント
-
createStartDocument
public abstract StartDocument createStartDocument()
StartDocumentイベントの新しいインスタンスを作成します。- 戻り値:
- StartDocumentイベント
-
createStartDocument
public abstract StartDocument createStartDocument(String encoding, String version, boolean standalone)
StartDocumentイベントの新しいインスタンスを作成します。- パラメータ:
encoding
- エンコーディング形式version
- XMLバージョンstandalone
- スタンドアロンの状態はtrueまたはfalseに設定される- 戻り値:
- StartDocumentイベント
-
createStartDocument
public abstract StartDocument createStartDocument(String encoding, String version)
StartDocumentイベントの新しいインスタンスを作成します。- パラメータ:
encoding
- エンコーディング形式version
- XMLバージョン- 戻り値:
- StartDocumentイベント
-
createStartDocument
public abstract StartDocument createStartDocument(String encoding)
StartDocumentイベントの新しいインスタンスを作成します。- パラメータ:
encoding
- エンコーディング形式- 戻り値:
- StartDocumentイベント
-
createEndDocument
public abstract EndDocument createEndDocument()
EndDocumentイベントの新しいインスタンスを作成します。- 戻り値:
- EndDocumentイベント
-
createEntityReference
public abstract EntityReference createEntityReference(String name, EntityDeclaration declaration)
EntityReferenceイベントの新しいインスタンスを作成します。- パラメータ:
name
- 参照の名前declaration
- イベントの宣言- 戻り値:
- EntityReferenceイベント
-
createComment
public abstract Comment createComment(String text)
コメントを作成します。- パラメータ:
text
- コメントのテキストCommentイベント
-
createProcessingInstruction
public abstract ProcessingInstruction createProcessingInstruction(String target, String data)
処理命令を作成します。- パラメータ:
target
- 処理命令のターゲットdata
- 処理命令のテキスト- 戻り値:
- ProcessingInstructionイベント
-
-