net.sf.saxon.event

Interface LocationProvider

All Known Subinterfaces:

SourceLocationProvider

All Known Implementing Classes:

DOMSender, LocationCopier, LocationMap, StaxBridge, StaxToEventBridge, TinyTree, XPathParser.TemporaryContainer

public interface LocationProvider

LocationProvider: this interface represents an object that provides the location of elements in a source document or instructions in a stylesheet or query. A locationProvider may be passed down the Receiver pipeline as part of the PipelineConfiguration object.

A LocationProvider that represents locations in the source document from which the events are derived (as distinct from locations in a query or stylesheet of the instructions causing the events) will also implement the marker interface SourceLocationProvider

Method Summary

Methods

Modifier and Type	Method and Description
int	getColumnNumber(int locationId) Get the column number within the document, entity, or module containing a particular location
int	getLineNumber(int locationId) Get the line number within the document, entity or module containing a particular location
String	getSystemId(int locationId) Get the URI of the document, entity, or module containing a particular location

Method Detail

getSystemId

String getSystemId(int locationId)

Get the URI of the document, entity, or module containing a particular location

Parameters:

locationId - identifier of the location in question (as passed down the Receiver pipeline)

Returns:

the URI of the document, XML entity or module. For a SourceLocationProvider this will be the URI of the document or entity (the URI that would be the base URI if there were no xml:base attributes). In other cases it may identify the query or stylesheet module currently being executed.

getLineNumber

int getLineNumber(int locationId)

Get the line number within the document, entity or module containing a particular location

Parameters:

locationId - identifier of the location in question (as passed down the Receiver pipeline)

Returns:

the line number within the document, entity or module, or -1 if no information is available.

getColumnNumber

int getColumnNumber(int locationId)

Get the column number within the document, entity, or module containing a particular location

Parameters:

locationId - identifier of the location in question (as passed down the Receiver pipeline)

Returns:

the column number within the document, entity, or module, or -1 if this is not available