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.transform.stax
Class StAXSource

    java.lang.Object
      javax.xml.transform.stax.StAXSource

All Implemented Interfaces:
  Source

    public class StAXSource

extends Object
implements Source

Acts as a holder for an XML `Source` in the form of a StAX reader,i.e. `XMLStreamReader` or `XMLEventReader`. `StAXSource` can be used in all cases that accept a `Source`, e.g. `Transformer`, `Validator` which accept `Source` as input.

`StAXSource`s are consumed during processing and are not reusable.

Since:
  1.6
See Also:
  JSR 173: Streaming API for XML, `XMLStreamReader`, `XMLEventReader`

Field Summary
`static String` | `FEATURE` If `TransformerFactory.getFeature(String name)` returns true when passed this value as an argument, the Transformer supports Source input of this type.

Constructor Summary
`StAXSource(XMLEventReader xmlEventReader)` Creates a new instance of a `StAXSource` by supplying an `XMLEventReader`.
`StAXSource(XMLStreamReader xmlStreamReader)` Creates a new instance of a `StAXSource` by supplying an `XMLStreamReader`.

Method Summary
`String` | `getSystemId()` Get the system identifier used by this `StAXSource`.
`XMLEventReader` | `getXMLEventReader()` Get the `XMLEventReader` used by this `StAXSource`.
`XMLStreamReader` | `getXMLStreamReader()` Get the `XMLStreamReader` used by this `StAXSource`.
`void` | `setSystemId(String systemId)` In the context of a `StAXSource`, it is not appropriate to explicitly set the system identifier.

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

Field Detail

### FEATURE

    public static final String FEATURE

  If `TransformerFactory.getFeature(String name)` returns true when passed this value as an argument, the Transformer supports Source input of this type.

  See Also:
    Constant Field Values

Constructor Detail

### StAXSource

    public StAXSource(XMLEventReader xmlEventReader)
               throws XMLStreamException

  Creates a new instance of a `StAXSource` by supplying an `XMLEventReader`.

  `XMLEventReader` must be a non-`null` reference.

  `XMLEventReader` must be in `XMLStreamConstants.START_DOCUMENT` or `XMLStreamConstants.START_ELEMENT` state.

  Parameters:
    `xmlEventReader` - `XMLEventReader` used to create this `StAXSource`.
  Throws:
    `XMLStreamException` - If `xmlEventReader` access throws an `Exception`.
    `IllegalArgumentException` - If `xmlEventReader` == `null`.
    `IllegalStateException` - If `xmlEventReader` is not in `XMLStreamConstants.START_DOCUMENT` or `XMLStreamConstants.START_ELEMENT` state.

### StAXSource

    public StAXSource(XMLStreamReader xmlStreamReader)

  Creates a new instance of a `StAXSource` by supplying an `XMLStreamReader`.

  `XMLStreamReader` must be a non-`null` reference.

  `XMLStreamReader` must be in `XMLStreamConstants.START_DOCUMENT` or `XMLStreamConstants.START_ELEMENT` state.

  Parameters:
    `xmlStreamReader` - `XMLStreamReader` used to create this `StAXSource`.
  Throws:
    `IllegalArgumentException` - If `xmlStreamReader` == `null`.
    `IllegalStateException` - If `xmlStreamReader` is not in `XMLStreamConstants.START_DOCUMENT` or `XMLStreamConstants.START_ELEMENT` state.

Method Detail

### getXMLEventReader

    public XMLEventReader getXMLEventReader()

  Get the `XMLEventReader` used by this `StAXSource`.

  `XMLEventReader` will be `null`. if this `StAXSource` was created with a `XMLStreamReader`.

  Returns:
    `XMLEventReader` used by this `StAXSource`.

### getXMLStreamReader

    public XMLStreamReader getXMLStreamReader()

  Get the `XMLStreamReader` used by this `StAXSource`.

  `XMLStreamReader` will be `null` if this `StAXSource` was created with a `XMLEventReader`.

  Returns:
    `XMLStreamReader` used by this `StAXSource`.

### setSystemId

    public void setSystemId(String systemId)

  In the context of a `StAXSource`, it is not appropriate to explicitly set the system identifier. The `XMLStreamReader` or `XMLEventReader` used to construct this `StAXSource` determines the system identifier of the XML source.

  An `UnsupportedOperationException` is always thrown by this method.

  Specified by:
    `setSystemId` in interface `Source`
  Parameters:
    `systemId` - Ignored.
  Throws:
    `UnsupportedOperationException` - Is always thrown by this method.

### getSystemId

    public String getSystemId()

  Get the system identifier used by this `StAXSource`.

  The `XMLStreamReader` or `XMLEventReader` used to construct this `StAXSource` is queried to determine the system identifier of the XML source.

  The system identifier may be `null` or an empty `""` `String`.

  Specified by:
    `getSystemId` in interface `Source`
  Returns:
    System identifier used by this `StAXSource`.

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 © 1993, 2011, Oracle and/or its affiliates. All rights reserved.