Locator

Locator

org.xml.sax

---

Java 1.4

A XMLReader may pass an object that implements this interface to the application by calling the setDocumentLocator( ) method of the application's ContentHandler object before it invokes any other methods of that ContentHandler . The ContentHandler can use methods of this Locator object from within any of the other methods called by the parser in order to determine what document the parser is parsing and what line number and column number it is parsing at. This information is particularly useful when displaying error or warning messages, for example. getSystemId( ) and getPublicId( ) return the system and public identifiers of the document being parsed, if this information is available to the parser, and otherwise return null . getLineNumber( ) and getColumnNumber( ) return the line number and column number of the next character that the parser will read (line and column numbers are numbered starting at 1, not at 0). The parser is allowed to return an approximate value from these methods, or to return -1 if it does not track line and column numbers .

 public interface  Locator  {  // Public Instance Methods  int  getColumnNumber  ( );        int  getLineNumber  ( );        String  getPublicId  ( );        String  getSystemId  ( );   } 

Implementations

org.xml.sax.ext.Locator2 , org.xml.sax.helpers.LocatorImpl

Passed To

org.xml.sax.ContentHandler.setDocumentLocator( ) , DocumentHandler.setDocumentLocator( ) , HandlerBase.setDocumentLocator( ) , SAXParseException.SAXParseException( ) , org.xml.sax.ext.Locator2Impl.Locator2Impl( ) , org.xml.sax.helpers.DefaultHandler.setDocumentLocator( ) , org.xml.sax.helpers.LocatorImpl.LocatorImpl( ) , org.xml.sax.helpers.ParserAdapter.setDocumentLocator( ) , org.xml.sax.helpers.XMLFilterImpl.setDocumentLocator( ) , org.xml.sax.helpers.XMLReaderAdapter.setDocumentLocator( )