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.
StAXSources are consumed during processing and are not reusable.

Since:

1.6

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

Field Summary

Fields
Modifier and Type	Field and Description
`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

Constructors
Constructor and Description
`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

Methods
Modifier and Type	Method and Description
`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.

Traduction non disponible

Les API Java ne sont pas encore traduites en français sur l'infobrol. Seule la version anglaise est disponible pour l'instant.

Document créé le 11/06/2005, dernière modification le 04/03/2020
Source du document imprimé : https://www.gaudry.be/java-api-rf-javax/xml/transform/stax/StAXSource.html

L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.

Références

Manuel PHP : https://docs.oracle.com

Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.

Table des matières Haut

Class StAXSource

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

FEATURE

Constructor Detail

StAXSource

StAXSource

Method Detail

getXMLEventReader

getXMLStreamReader

setSystemId

getSystemId

Références