Interface DelegatingXMLStreamReader

  • All Superinterfaces:
    XMLStreamConstants, XMLStreamReader

    public interface DelegatingXMLStreamReader
    extends XMLStreamReader
    Deprecated.
    Interface implemented by XMLStreamReader classes that delegate to another stream reader and that can be safely unwrapped.

    This interface gives access to the parent reader, i.e. it allows to unwrap a stream reader wrapper. It should be noted that in general, unwrapping a wrapper and accessing the parent object is not a safe operation because it may invalidate the state of the wrapper (which may still be used later). Therefore this interface must only be implemented by XMLStreamReader classes for which unwrapping is a safe operation. In particular, this interface should not be implemented by wrappers that alter the sequence of events produced by the stream reader.

    This interface is used by XMLStreamReaderUtils.getOriginalXMLStreamReader(XMLStreamReader) to get access to the original parser.