XMLEventFactory (Java Platform SE 8 )

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

```
public abstract class XMLEventFactory
extends Object
```
这个接口定义了用于创建实例的xmlevents实用工具类

从以下版本开始：

一点六

Version:

一点二

另请参见：

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)` 创建一个设置为true的CDATA标志人物事件
`abstract Characters`	`createCharacters(String content)` 创建一个人物事件，此方法不检查的内容都是空白的。
`abstract Comment`	`createComment(String text)` 创建一个注释
`abstract DTD`	`createDTD(String dtd)` 创建一个文档类型定义事件这个字符串包含整个文档类型声明相匹配的doctypedecl在XML 1规范
`abstract EndDocument`	`createEndDocument()` 创建一个专件事件的一个新实例
`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)` 创建一个设置为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)` 创建一个新的不同。
`abstract StartElement`	`createStartElement(String prefix, String namespaceUri, String localName)` 创建一个新的不同。
`abstract StartElement`	`createStartElement(String prefix, String namespaceUri, String localName, Iterator attributes, Iterator namespaces)` 创建一个新的不同。
`abstract StartElement`	`createStartElement(String prefix, String namespaceUri, String localName, Iterator attributes, Iterator namespaces, NamespaceContext context)` 创建一个新的不同。
`static XMLEventFactory`	`newFactory()` 创建工厂的一个新实例。
`static XMLEventFactory`	`newFactory(String factoryId, ClassLoader classLoader)` 创建工厂的一个新实例。
`static XMLEventFactory`	`newInstance()` 创建了一个新的工厂，以同样的方式方法的 `newFactory()`。
`static XMLEventFactory`	`newInstance(String factoryId, ClassLoader classLoader)` 过时的。此方法已被否决保持API的一致性。所有的newInstance方法已经有相应的新工厂方法所取代。更换`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

- Constructor Detail
  - XMLEventFactory
```
protected XMLEventFactory()
```
- 方法详细信息
  - newInstance
```
public static XMLEventFactory newInstance()
                                   throws FactoryConfigurationError
```
    创建了一个新的工厂，以同样的方式方法的 newFactory()。
    
    异常
    
    FactoryConfigurationError -如果该厂不能实例被加载
  - newFactory
```
public static XMLEventFactory newFactory()
                                  throws FactoryConfigurationError
```
    创建工厂的一个新实例。
    这种静态方法创建一个新的工厂实例。此方法使用以下命令查找程序来确定xmleventfactory实现类负载：
    - 使用javax.xml.stream.xmleventfactory系统性能。
    - 使用属性文件的“库/ StAX。属性”在JRE目录。这个配置文件是java.util.properties格式标准，包含实现类的完全限定名的关键是上面定义的系统性能。
    - 使用服务提供商装载设施，由ServiceLoader类定义，试图定位和加载使用default loading mechanism服务的实现：服务提供者装载设备将使用current thread's context class loader尝试加载服务。如果上下文类加载器是空的，将使用的system class loader。
    - 否则，系统默认实现返回。
    一旦申请获得参考一xmleventfactory可以使用工厂配置和获取流实例。
    
    请注意，这是一种新的方法取代了过时的newinstance()方法。在行为上没有变化是由这种方法相对于过时的方法定义。
    异常
    
    FactoryConfigurationError -的情况下， service configuration error或者执行不可用或不能被实例化。
  - newInstance
```
public static XMLEventFactory newInstance(String factoryId,
                                          ClassLoader classLoader)
                                   throws FactoryConfigurationError
```
    过时的。此方法已被否决保持API的一致性。所有的newInstance方法已经有相应的新工厂方法所取代。更换newFactory(java.lang.String, java.lang.ClassLoader)方法定义在行为上没有变化。
    
    创建工厂的一个新实例
    
    参数
    
    factoryId -工厂找到名字，相同的属性名
    
    classLoader -类装载器使用
    
    结果
    
    本厂实施
    
    异常
    
    FactoryConfigurationError -如果该厂不能实例被加载
  - newFactory
```
public static XMLEventFactory newFactory(String factoryId,
                                         ClassLoader classLoader)
                                  throws FactoryConfigurationError
```
    创建工厂的一个新实例。如果类装载器的参数为null，然后用contextclassloader。
    此方法使用以下命令查找程序来确定xmleventfactory实现类负载：
    - 利用确定的factoryId系统属性的值。
    - 使用属性文件的“库/ StAX。属性”在JRE目录。这个配置文件是java.util.properties格式标准，包含实现类的完全限定名的关键是给出的factoryId。
    - 如果factoryId“javax. XML流。xmleventfactory”，使用服务提供商的装卸设施，由ServiceLoader类定义，试图找到并加载一个服务的实现使用指定的ClassLoader。如果classLoader是无效的，将default loading mechanism：即服务提供商装载设备将使用current thread's context class loader尝试加载服务。如果上下文类加载器是空的，将使用的system class loader。
    - 否则，抛出一个FactoryConfigurationError。
    请注意，这是一种新的方法取代了过时的newInstance(String factoryId, ClassLoader classLoader)方法。在行为上没有变化是由这种方法相对于过时的方法定义。
    API Note:
    
    这里定义的参数factoryid与其他JAXP的工厂，第一个参数是完全合格的工厂类的名字，提供工厂实施不一致。
    
    参数
    
    factoryId -工厂找到名字，相同的属性名
    
    classLoader -类装载器使用
    
    结果
    
    本厂实施
    
    异常
    
    FactoryConfigurationError -的情况下， service configuration error或者执行不可用或不能被实例化。
  - setLocation
```
public abstract void setLocation(Location location)
```
    此方法允许在由该工厂创建的每个事件上设置位置。将值复制到由该工厂创建的事件中。要重置位置信息，将位置设置为零。
    
    参数
    
    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 -设置属性值，不得空
    
    结果
    
    具有指定值的属性
  - 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 -属性值设置为这个值，不可能是空的
    
    结果
    
    具有指定值的命名空间
  - createStartElement
```
public abstract StartElement createStartElement(QName name,
                                                Iterator attributes,
                                                Iterator namespaces)
```
    创建一个新的不同。命名空间可以通过传递一个迭代器，走一套接口添加到不同的命名空间。属性可以通过迭代器遍历一组属性的接口添加到这个不同。
    
    参数
    
    name -属性的名称，不得空
    
    attributes -实现属性添加到新的对象不同，一个可选的无序集合，可能是空的
    
    namespaces -实现命名空间添加到新的对象不同，一个可选的无序集合，可能是空的
    
    结果
    
    所要求的不同的实例
  - createStartElement
```
public abstract StartElement createStartElement(String prefix,
                                                String namespaceUri,
                                                String localName)
```
    创建一个新的不同。默认的namespacecontext为空namespacecontext。查询这个事件的命名空间或属性会导致一个空的迭代器返回。
    
    参数
    
    namespaceUri -新的不同将URI
    
    localName -新的不同的属性的本地名称
    
    prefix -新的startElement QName前缀
    
    结果
    
    所要求的不同的实例
  - createStartElement
```
public abstract StartElement createStartElement(String prefix,
                                                String namespaceUri,
                                                String localName,
                                                Iterator attributes,
                                                Iterator namespaces)
```
    创建一个新的不同。命名空间可以通过传递一个迭代器，走一套接口添加到不同的命名空间。属性可以通过迭代器遍历一组属性的接口添加到这个不同。
    
    参数
    
    namespaceUri -新的不同将URI
    
    localName -新的不同的属性的本地名称
    
    prefix -新的startElement QName前缀
    
    attributes -实现属性添加到新的不同对象的无序集合
    
    namespaces -实现命名空间添加到新的不同对象的无序集合
    
    结果
    
    所要求的不同的实例
  - createStartElement
```
public abstract StartElement createStartElement(String prefix,
                                                String namespaceUri,
                                                String localName,
                                                Iterator attributes,
                                                Iterator namespaces,
                                                NamespaceContext context)
```
    创建一个新的不同。命名空间可以通过传递一个迭代器，走一套接口添加到不同的命名空间。属性可以通过迭代器遍历一组属性的接口添加到这个不同。
    
    参数
    
    namespaceUri -新的不同将URI
    
    localName -新的不同的属性的本地名称
    
    prefix -新的startElement QName前缀
    
    attributes -实现属性添加到新的不同对象的无序集合，可能是空的
    
    namespaces -实现命名空间添加到新的不同对象的无序集合，可能是空的
    
    context -该元素的命名空间上下文
    
    结果
    
    所要求的不同的实例
  - 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 -新的不同将URI
    
    localName -新的不同的属性的本地名称
    
    prefix -新的startElement QName前缀
    
    结果
    
    所请求的EndElement实例
  - createEndElement
```
public abstract EndElement createEndElement(String prefix,
                                            String namespaceUri,
                                            String localName,
                                            Iterator namespaces)
```
    创建一个新的EndElement
    
    参数
    
    namespaceUri -新的不同将URI
    
    localName -新的不同的属性的本地名称
    
    prefix -新的startElement QName前缀
    
    namespaces -实现命名空间都超出范围的对象的无序集合，可能是空的
    
    结果
    
    所请求的EndElement实例
  - createCharacters
```
public abstract Characters createCharacters(String content)
```
    创建一个人物事件，此方法不检查的内容都是空白的。创建一个空间事件使用# CreateSpace（字符串）
    
    参数
    
    content -创建字符串
    
    结果
    
    一个人物事件
  - createCData
```
public abstract Characters createCData(String content)
```
    创建一个设置为true的CDATA标志人物事件
    
    参数
    
    content -创建字符串
    
    结果
    
    一个人物事件
  - createSpace
```
public abstract Characters createSpace(String content)
```
    创建一个设置为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 -独立的状态可以设置为“真”或“假”
    
    结果
    
    一个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()
```
    创建一个专件事件的一个新实例
    
    结果
    
    一个专件事件
  - 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 -处理指令的目标
    
    data -处理指令文本
    
    结果
    
    一个ProcessingInstruction事件
  - createDTD
```
public abstract DTD createDTD(String dtd)
```
    创建一个文档类型定义事件这个字符串包含整个文档类型声明相匹配的doctypedecl在XML 1规范
    
    参数
    
    dtd -文档类型定义的文本
    
    结果
    
    DTD事件

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class XMLEventFactory

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

Constructor Detail

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