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:

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final String
    FEATURE
    If TransformerFactory.getFeature(String name) returns true when passed this value as an argument, the Transformer supports Result output of this type.

    Fields declared in interface Result

    PI_DISABLE_OUTPUT_ESCAPING, PI_ENABLE_OUTPUT_ESCAPING
    Modifier and Type
    Field
    Description
    static final String
    PI_DISABLE_OUTPUT_ESCAPING
    The name of the processing instruction that is sent if the result tree disables output escaping.
    static final String
    PI_ENABLE_OUTPUT_ESCAPING
    The name of the processing instruction that is sent if the result tree enables output escaping at some point after having received a PI_DISABLE_OUTPUT_ESCAPING processing instruction.

  • Constructor Summary

    Constructors
    Constructor
    Description
    StAXResult(XMLEventWriter xmlEventWriter)
    Creates a new instance of a StAXResult by supplying an XMLEventWriter.
    StAXResult(XMLStreamWriter xmlStreamWriter)
    Creates a new instance of a StAXResult by supplying an XMLStreamWriter.

  • Method Summary

    Modifier and Type
    Method
    Description
    String
    getSystemId()
    The returned system identifier is always null.
    XMLEventWriter
    getXMLEventWriter()
    Get the XMLEventWriter used by this StAXResult.
    XMLStreamWriter
    getXMLStreamWriter()
    Get the XMLStreamWriter used by this StAXResult.
    void
    setSystemId(String systemId)
    In the context of a StAXResult, it is not appropriate to explicitly set the system identifier.

    Methods declared in class Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    Modifier and Type
    Method
    Description
    protected Object
    clone()
    Answers a new instance of the same class as the receiver, whose slots have been filled in with the values in the slots of the receiver.
    boolean
    equals(Object o)
    Compares the argument to the receiver, and answers true if they represent the same object using a class specific comparison.
    protected void
    finalize()
    Deprecated, for removal: This API element is subject to removal in a future version.
    May cause performance issues, deadlocks and hangs.
    final Class<? extends Object>
    getClass()
    Answers the unique instance of java.lang.Class which represents the class of the receiver.
    int
    hashCode()
    Answers an integer hash code for the receiver.
    final void
    notify()
    Causes one thread which is waiting on the receiver to be made ready to run.
    final void
    notifyAll()
    Causes all threads which are waiting on the receiver to be made ready to run.
    String
    toString()
    Answers a string containing a concise, human-readable description of the receiver.
    final void
    wait()
    Causes the thread which sent this message to be made not ready to run pending some change in the receiver (as indicated by notify or notifyAll).
    final void
    wait(long time)
    Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.
    final void
    wait(long time, int frac)
    Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.

  • 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.