Overview | Package | Class | Use | Tree | Deprecated | Index | Help
| Java™ Platform Standard Ed. 6
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## javax.xml.stream
Class XMLEventFactory

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

    public abstract class XMLEventFactory

extends Object

This interface defines a utility class for creating instances of XMLEvents

Since:
  1.6
See Also:
  `StartElement`, `EndElement`, `ProcessingInstruction`, `Comment`, `Characters`, `StartDocument`, `EndDocument`, `DTD`

Constructor Summary
`protected` | `XMLEventFactory()`

Method Summary
`abstract Attribute` | `createAttribute(QName name, String value)` Create a new Attribute
`abstract Attribute` | `createAttribute(String localName, String value)` Create a new Attribute
`abstract Attribute` | `createAttribute(String prefix, String namespaceURI, String localName, String value)` Create a new Attribute
`abstract Characters` | `createCData(String content)` Create a Characters event with the CData flag set to true
`abstract Characters` | `createCharacters(String content)` Create a Characters event, this method does not check if the content is all whitespace.
`abstract Comment` | `createComment(String text)` Create a comment
`abstract DTD` | `createDTD(String dtd)` Create a document type definition event This string contains the entire document type declaration that matches the doctypedecl in the XML 1.0 specification
`abstract EndDocument` | `createEndDocument()` Creates a new instance of an EndDocument event
`abstract EndElement` | `createEndElement(QName name, Iterator namespaces)` Create a new EndElement
`abstract EndElement` | `createEndElement(String prefix, String namespaceUri, String localName)` Create a new EndElement
`abstract EndElement` | `createEndElement(String prefix, String namespaceUri, String localName, Iterator namespaces)` Create a new EndElement
`abstract EntityReference` | `createEntityReference(String name, EntityDeclaration declaration)` Creates a new instance of a EntityReference event
`abstract Characters` | `createIgnorableSpace(String content)` Create an ignorable space
`abstract Namespace` | `createNamespace(String namespaceURI)` Create a new default Namespace
`abstract Namespace` | `createNamespace(String prefix, String namespaceUri)` Create a new Namespace
`abstract ProcessingInstruction` | `createProcessingInstruction(String target, String data)` Create a processing instruction
`abstract Characters` | `createSpace(String content)` Create a Characters event with the isSpace flag set to true
`abstract StartDocument` | `createStartDocument()` Creates a new instance of a StartDocument event
`abstract StartDocument` | `createStartDocument(String encoding)` Creates a new instance of a StartDocument event
`abstract StartDocument` | `createStartDocument(String encoding, String version)` Creates a new instance of a StartDocument event
`abstract StartDocument` | `createStartDocument(String encoding, String version, boolean standalone)` Creates a new instance of a StartDocument event
`abstract StartElement` | `createStartElement(QName name, Iterator attributes, Iterator namespaces)` Create a new StartElement.
`abstract StartElement` | `createStartElement(String prefix, String namespaceUri, String localName)` Create a new StartElement.
`abstract StartElement` | `createStartElement(String prefix, String namespaceUri, String localName, Iterator attributes, Iterator namespaces)` Create a new StartElement.
`abstract StartElement` | `createStartElement(String prefix, String namespaceUri, String localName, Iterator attributes, Iterator namespaces, NamespaceContext context)` Create a new StartElement.
`static XMLEventFactory` | `newInstance()` Create a new instance of the factory
`static XMLEventFactory` | `newInstance(String factoryId, ClassLoader classLoader)` Create a new instance of the factory
`abstract void` | `setLocation(Location location)` This method allows setting of the Location on each event that is created by this factory.

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

Constructor Detail

### XMLEventFactory

    protected XMLEventFactory()

Method Detail

### newInstance

    public static XMLEventFactory newInstance()
                                       throws FactoryConfigurationError

  Create a new instance of the factory

  Throws:
    `FactoryConfigurationError` - if an instance of this factory cannot be loaded

### newInstance

    public static XMLEventFactory newInstance(String factoryId,
                                              ClassLoader classLoader)
                                       throws FactoryConfigurationError

  Create a new instance of the factory

  Parameters:
    `factoryId` - Name of the factory to find, same as a property name
    `classLoader` - classLoader to use
  Returns:
    the factory implementation
  Throws:
    `FactoryConfigurationError` - if an instance of this factory cannot be loaded

### setLocation

    public abstract void setLocation(Location location)

  This method allows setting of the Location on each event that is created by this factory. The values are copied by value into the events created by this factory. To reset the location information set the location to null.

  Parameters:
    `location` - the location to set on each event created

### createAttribute

    public abstract Attribute createAttribute(String prefix,
                                              String namespaceURI,
                                              String localName,
                                              String value)

  Create a new Attribute

  Parameters:
    `prefix` - the prefix of this attribute, may not be null
    `namespaceURI` - the attribute value is set to this value, may not be null
    `localName` - the local name of the XML name of the attribute, localName cannot be null
    `value` - the attribute value to set, may not be null
  Returns:
    the Attribute with specified values

### createAttribute

    public abstract Attribute createAttribute(String localName,
                                              String value)

  Create a new Attribute

  Parameters:
    `localName` - the local name of the XML name of the attribute, localName cannot be null
    `value` - the attribute value to set, may not be null
  Returns:
    the Attribute with specified values

### createAttribute

    public abstract Attribute createAttribute(QName name,
                                              String value)

  Create a new Attribute

  Parameters:
    `name` - the qualified name of the attribute, may not be null
    `value` - the attribute value to set, may not be null
  Returns:
    the Attribute with specified values

### createNamespace

    public abstract Namespace createNamespace(String namespaceURI)

  Create a new default Namespace

  Parameters:
    `namespaceURI` - the default namespace uri
  Returns:
    the Namespace with the specified value

### createNamespace

    public abstract Namespace createNamespace(String prefix,
                                              String namespaceUri)

  Create a new Namespace

  Parameters:
    `prefix` - the prefix of this namespace, may not be null
    `namespaceUri` - the attribute value is set to this value, may not be null
  Returns:
    the Namespace with the specified values

### createStartElement

    public abstract StartElement createStartElement(QName name,
                                                    Iterator attributes,
                                                    Iterator namespaces)

  Create a new StartElement. Namespaces can be added to this StartElement by passing in an Iterator that walks over a set of Namespace interfaces. Attributes can be added to this StartElement by passing an iterator that walks over a set of Attribute interfaces.

  Parameters:
    `name` - the qualified name of the attribute, may not be null
    `attributes` - an optional unordered set of objects that implement Attribute to add to the new StartElement, may be null
    `namespaces` - an optional unordered set of objects that implement Namespace to add to the new StartElement, may be null
  Returns:
    an instance of the requested StartElement

### createStartElement

    public abstract StartElement createStartElement(String prefix,
                                                    String namespaceUri,
                                                    String localName)

  Create a new StartElement. This defaults the NamespaceContext to an empty NamespaceContext. Querying this event for its namespaces or attributes will result in an empty iterator being returned.

  Parameters:
    `namespaceUri` - the uri of the QName of the new StartElement
    `localName` - the local name of the QName of the new StartElement
    `prefix` - the prefix of the QName of the new StartElement
  Returns:
    an instance of the requested StartElement

### createStartElement

    public abstract StartElement createStartElement(String prefix,
                                                    String namespaceUri,
                                                    String localName,
                                                    Iterator attributes,
                                                    Iterator namespaces)

  Create a new StartElement. Namespaces can be added to this StartElement by passing in an Iterator that walks over a set of Namespace interfaces. Attributes can be added to this StartElement by passing an iterator that walks over a set of Attribute interfaces.

  Parameters:
    `namespaceUri` - the uri of the QName of the new StartElement
    `localName` - the local name of the QName of the new StartElement
    `prefix` - the prefix of the QName of the new StartElement
    `attributes` - an unordered set of objects that implement Attribute to add to the new StartElement
    `namespaces` - an unordered set of objects that implement Namespace to add to the new StartElement
  Returns:
    an instance of the requested StartElement

### createStartElement

    public abstract StartElement createStartElement(String prefix,
                                                    String namespaceUri,
                                                    String localName,
                                                    Iterator attributes,
                                                    Iterator namespaces,
                                                    NamespaceContext context)

  Create a new StartElement. Namespaces can be added to this StartElement by passing in an Iterator that walks over a set of Namespace interfaces. Attributes can be added to this StartElement by passing an iterator that walks over a set of Attribute interfaces.

  Parameters:
    `namespaceUri` - the uri of the QName of the new StartElement
    `localName` - the local name of the QName of the new StartElement
    `prefix` - the prefix of the QName of the new StartElement
    `attributes` - an unordered set of objects that implement Attribute to add to the new StartElement, may be null
    `namespaces` - an unordered set of objects that implement Namespace to add to the new StartElement, may be null
    `context` - the namespace context of this element
  Returns:
    an instance of the requested StartElement

### createEndElement

    public abstract EndElement createEndElement(QName name,
                                                Iterator namespaces)

  Create a new EndElement

  Parameters:
    `name` - the qualified name of the EndElement
    `namespaces` - an optional unordered set of objects that implement Namespace that have gone out of scope, may be null
  Returns:
    an instance of the requested EndElement

### createEndElement

    public abstract EndElement createEndElement(String prefix,
                                                String namespaceUri,
                                                String localName)

  Create a new EndElement

  Parameters:
    `namespaceUri` - the uri of the QName of the new StartElement
    `localName` - the local name of the QName of the new StartElement
    `prefix` - the prefix of the QName of the new StartElement
  Returns:
    an instance of the requested EndElement

### createEndElement

    public abstract EndElement createEndElement(String prefix,
                                                String namespaceUri,
                                                String localName,
                                                Iterator namespaces)

  Create a new EndElement

  Parameters:
    `namespaceUri` - the uri of the QName of the new StartElement
    `localName` - the local name of the QName of the new StartElement
    `prefix` - the prefix of the QName of the new StartElement
    `namespaces` - an unordered set of objects that implement Namespace that have gone out of scope, may be null
  Returns:
    an instance of the requested EndElement

### createCharacters

    public abstract Characters createCharacters(String content)

  Create a Characters event, this method does not check if the content is all whitespace. To create a space event use #createSpace(String)

  Parameters:
    `content` - the string to create
  Returns:
    a Characters event

### createCData

    public abstract Characters createCData(String content)

  Create a Characters event with the CData flag set to true

  Parameters:
    `content` - the string to create
  Returns:
    a Characters event

### createSpace

    public abstract Characters createSpace(String content)

  Create a Characters event with the isSpace flag set to true

  Parameters:
    `content` - the content of the space to create
  Returns:
    a Characters event

### createIgnorableSpace

    public abstract Characters createIgnorableSpace(String content)

  Create an ignorable space

  Parameters:
    `content` - the space to create
  Returns:
    a Characters event

### createStartDocument

    public abstract StartDocument createStartDocument()

  Creates a new instance of a StartDocument event

  Returns:
    a StartDocument event

### createStartDocument

    public abstract StartDocument createStartDocument(String encoding,
                                                      String version,
                                                      boolean standalone)

  Creates a new instance of a StartDocument event

  Parameters:
    `encoding` - the encoding style
    `version` - the XML version
    `standalone` - the status of standalone may be set to "true" or "false"
  Returns:
    a StartDocument event

### createStartDocument

    public abstract StartDocument createStartDocument(String encoding,
                                                      String version)

  Creates a new instance of a StartDocument event

  Parameters:
    `encoding` - the encoding style
    `version` - the XML version
  Returns:
    a StartDocument event

### createStartDocument

    public abstract StartDocument createStartDocument(String encoding)

  Creates a new instance of a StartDocument event

  Parameters:
    `encoding` - the encoding style
  Returns:
    a StartDocument event

### createEndDocument

    public abstract EndDocument createEndDocument()

  Creates a new instance of an EndDocument event

  Returns:
    an EndDocument event

### createEntityReference

    public abstract EntityReference createEntityReference(String name,
                                                          EntityDeclaration declaration)

  Creates a new instance of a EntityReference event

  Parameters:
    `name` - The name of the reference
    `declaration` - the declaration for the event
  Returns:
    an EntityReference event

### createComment

    public abstract Comment createComment(String text)

  Create a comment

  Parameters:
    `text` - The text of the comment a Comment event

### createProcessingInstruction

    public abstract ProcessingInstruction createProcessingInstruction(String target,
                                                                      String data)

  Create a processing instruction

  Parameters:
    `target` - The target of the processing instruction
    `data` - The text of the processing instruction
  Returns:
    a ProcessingInstruction event

### createDTD

    public abstract DTD createDTD(String dtd)

  Create a document type definition event This string contains the entire document type declaration that matches the doctypedecl in the XML 1.0 specification

  Parameters:
    `dtd` - the text of the document type definition
  Returns:
    a DTD event

Overview | Package | Class | Use | Tree | Deprecated | Index | Help
| Java™ Platform Standard Ed. 6
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

Submit a bug or feature
For further API reference and developer documentation, see Java SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Copyright 2008 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.