XMLEventFactory (Java Platform SE 7)

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()

コンストラクタ
修飾子	コンストラクタと説明
`protected`	`XMLEventFactory()`

メソッドのサマリー

メソッド
修飾子と型	メソッドと説明
`abstract Attribute`	`createAttribute(QName name, String value)` 新しい Attribute を作成します。
`abstract Attribute`	`createAttribute(String localName, String value)` 新しい Attribute を作成します。
`abstract Attribute`	`createAttribute(String prefix, String namespaceURI, String localName, 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(QName name, Iterator namespaces)` 新しい EndElement を作成します。
`abstract EndElement`	`createEndElement(String prefix, String namespaceUri, String localName)` 新しい EndElement を作成します。
`abstract EndElement`	`createEndElement(String prefix, String namespaceUri, String localName, Iterator 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(QName name, Iterator attributes, Iterator namespaces)` 新しい StartElement を作成します。
`abstract StartElement`	`createStartElement(String prefix, String namespaceUri, String localName)` 新しい StartElement を作成します。
`abstract StartElement`	`createStartElement(String prefix, String namespaceUri, String localName, Iterator attributes, Iterator namespaces)` 新しい StartElement を作成します。
`abstract StartElement`	`createStartElement(String prefix, String namespaceUri, String localName, Iterator attributes, Iterator namespaces, NamespaceContext context)` 新しい StartElement を作成します。
`static XMLEventFactory`	`newFactory()` ファクトリの新しいインスタンスを作成します。
`static XMLEventFactory`	`newFactory(String factoryId, ClassLoader classLoader)` ファクトリの新しいインスタンスを作成します。
`static XMLEventFactory`	`newInstance()` ファクトリの新しいインスタンスを作成します。
`static XMLEventFactory`	`newInstance(String factoryId, ClassLoader classLoader)` 非推奨。 API の整合性を維持するために、このメソッドは非推奨になりました。すべての newInstance メソッドが、対応する newFactory メソッドに置き換えられています。代替の `newFactory(java.lang.String, java.lang.ClassLoader)` メソッドでは、動作の変更は定義されていません。
`abstract void`	`setLocation(Location location)` このメソッドを使用すると、このファクトリによって作成された各イベントで Location を設定できます。

クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- コンストラクタの詳細
  - XMLEventFactory
```
protected XMLEventFactory()
```
- メソッドの詳細
  - newInstance
```
public static XMLEventFactory newInstance()
                                   throws FactoryConfigurationError
```
    ファクトリの新しいインスタンスを作成します。
    
    例外:
    
    FactoryConfigurationError - このファクトリのインスタンスをロードできない場合
  - newFactory
```
public static XMLEventFactory newFactory()
                                  throws FactoryConfigurationError
```
    ファクトリの新しいインスタンスを作成します。この static メソッドは新しいファクトリインスタンスを作成します。このメソッドは次の順序の検索手順で、ロードする XMLEventFactory 実装クラスを決定します: javax.xml.stream.XMLEventFactory システムプロパティーを使用する。JRE ディレクトリ内のプロパティーファイル lib/stax.properties を使用する。この構成ファイルは標準の java.util.Properties 形式であり、上記のように定義されたシステムプロパティーであるキーを持つ実装クラスの完全指定の名前を含む。可能であれば、JAR 仕様で詳細に説明されているサービス API を使用して、クラス名を判定する。サービス API は、実行時に使用できる jar 内の META-INF/services/javax.xml.stream.XMLEventFactory ファイルからクラス名を検索する。デフォルトの XMLEventFactory インスタンスをプラットフォームとする。アプリケーションが XMLEventFactory への参照を取得すると、ファクトリを使用してストリームのインスタンスを構成および取得することができます。これは非推奨の newInstance() メソッドを置き換える新しいメソッドです。非推奨のメソッドに関連して、この置換メソッドによって定義されている動作に変更はありません。
    
    例外:
    
    FactoryConfigurationError - このファクトリのインスタンスをロードできない場合
  - newInstance
```
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 が使用されます。これは非推奨の newInstance(String factoryId、ClassLoader classLoader) メソッドを置き換える新しいメソッドです。非推奨のメソッドに関連して、この置換メソッドによって定義されている動作に変更はありません。
    
    パラメータ:
    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 attributes,
                              Iterator 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 の URI
    localName - 新しい StartElement の QName のローカル名
    prefix - 新しい StartElement の QName の接頭辞
    
    戻り値:
    要求された StartElement のインスタンス
  - createStartElement
```
public abstract StartElement createStartElement(String prefix,
                              String namespaceUri,
                              String localName,
                              Iterator attributes,
                              Iterator namespaces)
```
    新しい StartElement を作成します。Namespace インタフェースのセットを順次処理するイテレータを渡すことで、Namespace をこの StartElement に追加できます。Attribute インタフェースのセットを順次処理するイテレータを渡すことで、Attribute をこの StartElement に追加できます。
    
    パラメータ:
    namespaceUri - 新しい StartElement の QName の URI
    localName - 新しい StartElement の QName のローカル名
    prefix - 新しい StartElement の QName の接頭辞
    attributes - 新しい StartElement に追加する Attribute を実装するオブジェクトの順序付けされていないセット
    namespaces - 新しい StartElement に追加する Namespace を実装するオブジェクトの順序付けされていないセット
    
    戻り値:
    要求された StartElement のインスタンス
  - createStartElement
```
public abstract StartElement createStartElement(String prefix,
                              String namespaceUri,
                              String localName,
                              Iterator attributes,
                              Iterator namespaces,
                              NamespaceContext context)
```
    新しい StartElement を作成します。Namespace インタフェースのセットを順次処理するイテレータを渡すことで、Namespace をこの StartElement に追加できます。Attribute インタフェースのセットを順次処理するイテレータを渡すことで、Attribute をこの StartElement に追加できます。
    
    パラメータ:
    namespaceUri - 新しい StartElement の QName の URI
    localName - 新しい StartElement の QName のローカル名
    prefix - 新しい StartElement の QName の接頭辞
    attributes - 新しい StartElement に追加する Attribute を実装するオブジェクトの順序付けされていないセット。null の場合もある
    namespaces - 新しい StartElement に追加する Namespace を実装するオブジェクトの順序付けされていないセット。null の場合もある
    context - この要素の名前空間コンテキスト
    
    戻り値:
    要求された StartElement のインスタンス
  - createEndElement
```
public abstract EndElement createEndElement(QName name,
                          Iterator namespaces)
```
    新しい EndElement を作成します。
    
    パラメータ:
    name - EndElement の修飾名
    namespaces - 範囲外になった Namespace を実装するオブジェクトの順序付けされていないオプションセット。null の場合もある
    
    戻り値:
    要求された EndElement のインスタンス
  - createEndElement
```
public abstract EndElement createEndElement(String prefix,
                          String namespaceUri,
                          String localName)
```
    新しい EndElement を作成します。
    
    パラメータ:
    namespaceUri - 新しい StartElement の QName の URI
    localName - 新しい StartElement の QName のローカル名
    prefix - 新しい StartElement の QName の接頭辞
    
    戻り値:
    要求された EndElement のインスタンス
  - createEndElement
```
public abstract EndElement createEndElement(String prefix,
                          String namespaceUri,
                          String localName,
                          Iterator namespaces)
```
    新しい EndElement を作成します。
    
    パラメータ:
    namespaceUri - 新しい StartElement の QName の URI
    localName - 新しい 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 イベント
  - createDTD
```
public abstract DTD createDTD(String dtd)
```
    文書型定義イベントを作成します。この文字列には、XML 1.0 仕様の doctypedecl に一致する文書型宣言のすべてが含まれます。
    
    パラメータ:
    dtd - 文書型定義のテキスト
    
    戻り値:
    DTD イベント

バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.

クラス XMLEventFactory

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

メソッドのサマリー

クラス java.lang.Object から継承されたメソッド

コンストラクタの詳細

XMLEventFactory

メソッドの詳細

newInstance

newFactory

newInstance

newFactory

setLocation

createAttribute

createAttribute

createAttribute

createNamespace

createNamespace

createStartElement

createStartElement

createStartElement

createStartElement

createEndElement

createEndElement

createEndElement

createCharacters

createCData

createSpace

createIgnorableSpace

createStartDocument

createStartDocument

createStartDocument

createStartDocument

createEndDocument

createEntityReference

createComment

createProcessingInstruction

createDTD