XMLEventFactory (Java Platform SE 8 )

java.lang.Object
- javax.xml.stream.XMLEventFactory

```
public abstract class XMLEventFactory
extends Object
```
该界面定义了一个用于创建XMLEvents实例的实用程序类

从以下版本开始：

1.6

Version:

1.2

另请参见：

StartElement ， EndElement ， ProcessingInstruction ， Comment ， Characters ， StartDocument ， EndDocument ， DTD

构造方法摘要

构造方法
Modifier	Constructor and Description
`protected`	`XMLEventFactory()`

方法摘要

所有方法静态方法接口方法抽象方法具体的方法弃用的方法
Modifier and Type	Method and Description
`abstract Attribute`	`createAttribute(QName name, String value)` 创建一个新的属性
`abstract Attribute`	`createAttribute(String localName, String value)` 创建一个新的属性
`abstract Attribute`	`createAttribute(String prefix, String namespaceURI, String localName, String value)` 创建一个新的属性
`abstract Characters`	`createCData(String content)` 创建一个Charata事件，CData标志设置为true
`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)` 创建一个新的默认命名空间
`abstract Namespace`	`createNamespace(String prefix, String namespaceUri)` 创建一个新的命名空间
`abstract ProcessingInstruction`	`createProcessingInstruction(String target, String data)` 创建处理指令
`abstract Characters`	`createSpace(String content)` 创建一个字符事件，将isSpace标志设置为true
`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()` 以与 `newFactory()`方法完全相同的方式创建工厂的新实例。
`static XMLEventFactory`	`newInstance(String factoryId, ClassLoader classLoader)` 已弃用该方法已被弃用，以保持API的一致性。所有newInstance方法已被替换为相应的newFactory方法。替换`newFactory(java.lang.String, java.lang.ClassLoader)`方法定义行为没有变化。
`abstract void`	`setLocation(Location location)` 该方法允许在由此工厂创建的每个事件上设置位置。

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造方法详细信息
  - XMLEventFactory
```
protected XMLEventFactory()
```
- 方法详细信息
  - newInstance
```
public static XMLEventFactory newInstance()
                                   throws FactoryConfigurationError
```
    以与 newFactory()方法完全相同的方式创建工厂的新实例。
    
    异常
    
    FactoryConfigurationError - 如果此工厂的实例无法加载
  - newFactory
```
public static XMLEventFactory newFactory()
                                  throws FactoryConfigurationError
```
    创建一个新的工厂实例。
    这个静态方法创建一个新的工厂实例。此方法使用以下有序查找过程来确定要加载的XMLEventFactory实现类：
    - 使用javax.xml.stream.XMLEventFactory系统属性。
    - 在JRE目录中使用属性文件“lib / stax.properties”。此配置文件采用标准的java.util.Properties格式，并包含实现类的完全限定名称，其中键为上面定义的系统属性。
    - 使用由ServiceLoader类定义的服务提供商加载工具尝试使用default loading mechanism定位并加载服务的实现：服务提供商加载工具将使用current thread's context class loader尝试加载服务。如果上下文类加载器为null，那么将使用system class loader 。
    - 否则，返回系统默认实现。
    一旦应用程序获得了对XMLEventFactory的引用，它可以使用工厂来配置和获取流实例。
    
    请注意，这是一种替代不推荐使用的newInstance（）方法的新方法。相对于不推荐使用的方法，此替换方法没有定义行为更改。
    异常
    
    FactoryConfigurationError -在以下情况下service configuration error或者如果实现不可用或不能被实例化。
  - 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参数为空，则使用ContextClassLoader。
    此方法使用以下有序查找过程来确定要加载的XMLEventFactory实现类：
    - 通过使用标识的系统属性的值factoryId 。
    - 在JRE目录中使用属性文件“lib / stax.properties”。此配置文件采用标准的java.util.Properties格式，并包含实现类的完全限定名称，其中键为给定的factoryId 。
    - 如果factoryId是“javax.xml.stream.XMLEventFactory”，请使用由ServiceLoader类定义的服务提供程序加载工具来尝试使用指定的ClassLoader查找和加载服务的ClassLoader 。如果classLoader为空，则将适用default loading mechanism ：即，服务提供商加载工具将使用current thread's context class loader尝试加载服务。如果上下文类加载器为null，那么将使用system class loader 。
    - 否则，抛出一个FactoryConfigurationError 。
    请注意，这是一种替代已弃用的newInstance(String factoryId, ClassLoader classLoader)方法的新方法。相对于不推荐使用的方法，此替换方法没有定义行为更改。
    API Note:
    
    这里定义的参数factoryId与其他JAXP工厂的参数factoryId不一致，其中第一个参数是提供工厂实现的完全限定的工厂类名称。
    
    参数
    
    factoryId - 找到工厂的名称，与属性名称相同
    
    classLoader - classLoader使用
    
    结果
    
    工厂实施
    
    异常
    
    FactoryConfigurationError -在以下情况下service configuration error或者如果实现不可用或不能被实例化。
  - setLocation
```
public abstract void setLocation(Location location)
```
    该方法允许在由此工厂创建的每个事件上设置位置。这些值由值复制到此工厂创建的事件中。要重置位置信息，将位置设置为null。
    
    参数
    
    location - 创建每个事件上设置的位置
  - createAttribute
```
public abstract Attribute createAttribute(String prefix,
                                          String namespaceURI,
                                          String localName,
                                          String value)
```
    创建一个新的属性
    
    参数
    
    prefix - 此属性的前缀可能不为空
    
    namespaceURI - 属性值设置为此值，可能不为空
    
    localName - 属性的XML名称的本地名称，localName不能为空
    
    value - 要设置的属性值，可能不为空
    
    结果
    
    具有指定值的属性
  - createAttribute
```
public abstract Attribute createAttribute(String localName,
                                          String value)
```
    创建一个新的属性
    
    参数
    
    localName - 属性的XML名称的本地名称，localName不能为空
    
    value - 要设置的属性值，可能不为null
    
    结果
    
    具有指定值的属性
  - createAttribute
```
public abstract Attribute createAttribute(QName name,
                                          String value)
```
    创建一个新的属性
    
    参数
    
    name - 属性的限定名称，可能不为空
    
    value - 要设置的属性值，可能不为空
    
    结果
    
    具有指定值的属性
  - createNamespace
```
public abstract Namespace createNamespace(String namespaceURI)
```
    创建一个新的默认命名空间
    
    参数
    
    namespaceURI - 默认名称空间uri
    
    结果
    
    具有指定值的命名空间
  - createNamespace
```
public abstract Namespace createNamespace(String prefix,
                                          String namespaceUri)
```
    创建一个新的命名空间
    
    参数
    
    prefix - 这个命名空间的前缀可能不为空
    
    namespaceUri - 属性值设置为此值，可能不为空
    
    结果
    
    具有指定值的Namespace
  - createStartElement
```
public abstract StartElement createStartElement(QName name,
                                                Iterator attributes,
                                                Iterator namespaces)
```
    创建一个新的StartElement。通过传入遍历一组命名空间接口的迭代器，可以将命名空间添加到此StartElement。可以通过传递遍历一组Attribute接口的迭代器将属性添加到此StartElement。
    
    参数
    
    name - 属性的限定名称，可能不为空
    
    attributes - 实现属性添加到新的StartElement的可选的无序对象组可以是空的
    
    namespaces - 实现命名空间以添加到新的StartElement的可选的无序对象组可以为空
    
    结果
    
    所请求的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。通过传入遍历一组命名空间接口的迭代器，可以将命名空间添加到此StartElement。可以通过传递遍历一组Attribute接口的迭代器将属性添加到此StartElement。
    
    参数
    
    namespaceUri - 新的StartElement的QName的uri
    
    localName - 新StartElement的QName的本地名称
    
    prefix - 新的StartElement的QName的前缀
    
    attributes - 一个无序的对象集，实现添加到新的StartElement的Attribute
    
    namespaces - 一个无序的对象集，它们实现命名空间来添加到新的StartElement
    
    结果
    
    所请求的StartElement的一个实例
  - createStartElement
```
public abstract StartElement createStartElement(String prefix,
                                                String namespaceUri,
                                                String localName,
                                                Iterator attributes,
                                                Iterator namespaces,
                                                NamespaceContext context)
```
    创建一个新的StartElement。通过传入遍历一组命名空间接口的迭代器，可以将命名空间添加到此StartElement。可以通过传递遍历一组Attribute接口的迭代器将属性添加到此StartElement。
    
    参数
    
    namespaceUri - 新的StartElement的QName的uri
    
    localName - 新StartElement的QName的本地名称
    
    prefix - 新的StartElement的QName的前缀
    
    attributes - 实现属性添加到新的StartElement的无序对象组可能为null
    
    namespaces - 实现命名空间添加到新的StartElement的无序对象组可能为null
    
    context - 此元素的命名空间上下文
    
    结果
    
    所请求的StartElement的一个实例
  - createEndElement
```
public abstract EndElement createEndElement(QName name,
                                            Iterator namespaces)
```
    创建一个新的EndElement
    
    参数
    
    name - EndElement的限定名称
    
    namespaces - 实现名称空间超出范围的可选无序对象组可能为空
    
    结果
    
    请求的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 - 实现名称空间超出范围的无序对象组可能为null
    
    结果
    
    请求的EndElement的一个实例
  - createCharacters
```
public abstract Characters createCharacters(String content)
```
    创建一个Characters事件，此方法不检查内容是否为空白。要创建一个空间事件，使用#createSpace（String）
    
    参数
    
    content - 要创建的字符串
    
    结果
    
    一个人物事件
  - createCData
```
public abstract Characters createCData(String content)
```
    创建一个Charata事件，CData标志设置为true
    
    参数
    
    content - 要创建的字符串
    
    结果
    
    一个人物事件
  - createSpace
```
public abstract Characters createSpace(String content)
```
    创建一个字符事件，将isSpace标志设置为true
    
    参数
    
    content - 要创建的空间的内容
    
    结果
    
    一个人物事件
  - createIgnorableSpace
```
public abstract Characters createIgnorableSpace(String content)
```
    创建一个可忽略的空间
    
    参数
    
    content - 要创建的空间
    
    结果
    
    一个人物事件
  - 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 - 评论文本的评论事件
  - createProcessingInstruction
```
public abstract ProcessingInstruction createProcessingInstruction(String target,
                                                                  String data)
```
    创建处理指令
    
    参数
    
    target - 处理 target的目标
    
    data - 处理 data的文本
    
    结果
    
    一个ProcessingInstruction事件
  - createDTD
```
public abstract DTD createDTD(String dtd)
```
    创建文档类型定义事件此字符串包含与XML 1.0规范中的doctypedecl匹配的整个文档类型声明
    
    参数
    
    dtd - 文档类型定义的文本
    
    结果
    
    DTD事件

Class XMLEventFactory

构造方法摘要

方法摘要

Methods inherited from class 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