Module java.xml

Class StAXResult

java.lang.Object
javax.xml.transform.stax.StAXResult
All Implemented Interfaces:
Result

public class StAXResult
extends Object
implements Result

Acts as a holder for an XML Result in the form of a StAX writer,i.e. XMLStreamWriter or XMLEventWriter. StAXResult can be used in all cases that accept a Result, e.g. Transformer, Validator which accept Result as input.

Since:
1.6
See Also:
JSR 173: Streaming API for XML, XMLStreamWriter, XMLEventWriter
  • Field Details

  • Constructor Details

    • StAXResult

      public StAXResult​(XMLEventWriter xmlEventWriter)

      Creates a new instance of a StAXResult by supplying an XMLEventWriter.

      XMLEventWriter must be a non-null reference.

      Parameters:
      xmlEventWriter - XMLEventWriter used to create this StAXResult.
      Throws:
      IllegalArgumentException - If xmlEventWriter == null.
    • StAXResult

      public StAXResult​(XMLStreamWriter xmlStreamWriter)

      Creates a new instance of a StAXResult by supplying an XMLStreamWriter.

      XMLStreamWriter must be a non-null reference.

      Parameters:
      xmlStreamWriter - XMLStreamWriter used to create this StAXResult.
      Throws:
      IllegalArgumentException - If xmlStreamWriter == null.
  • Method Details

    • getXMLEventWriter

      public XMLEventWriter getXMLEventWriter()

      Get the XMLEventWriter used by this StAXResult.

      XMLEventWriter will be null if this StAXResult was created with a XMLStreamWriter.

      Returns:
      XMLEventWriter used by this StAXResult.
    • getXMLStreamWriter

      public XMLStreamWriter getXMLStreamWriter()

      Get the XMLStreamWriter used by this StAXResult.

      XMLStreamWriter will be null if this StAXResult was created with a XMLEventWriter.

      Returns:
      XMLStreamWriter used by this StAXResult.
    • setSystemId

      public void setSystemId​(String systemId)

      In the context of a StAXResult, it is not appropriate to explicitly set the system identifier. The XMLEventWriter or XMLStreamWriter used to construct this StAXResult determines the system identifier of the XML result.

      An UnsupportedOperationException is always thrown by this method.

      Specified by:
      setSystemId in interface Result
      Parameters:
      systemId - Ignored.
      Throws:
      UnsupportedOperationException - Is always thrown by this method.
    • getSystemId

      public String getSystemId()

      The returned system identifier is always null.

      Specified by:
      getSystemId in interface Result
      Returns:
      The returned system identifier is always null.