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.