org.codehaus.stax2
Interface XMLStreamLocation2

All Superinterfaces:
javax.xml.stream.Location
All Known Implementing Classes:
WstxInputLocation

public interface XMLStreamLocation2
extends javax.xml.stream.Location

Extension of Location that adds accessor to retrieve nested location information.


Method Summary
 XMLStreamLocation2 getContext()
          Method that can be used to traverse nested locations, like ones created when expanding entities (especially external entities).
 
Methods inherited from interface javax.xml.stream.Location
getCharacterOffset, getColumnNumber, getLineNumber, getPublicId, getSystemId
 

Method Detail

getContext

XMLStreamLocation2 getContext()
Method that can be used to traverse nested locations, like ones created when expanding entities (especially external entities). If so, single location object only contains information about specific offsets and ids, and a link to its context. Outermost location will return null to indicate there is no more information to retrieve.

Returns:
Location in the context (parent input source), if any; null for locations in the outermost known context