The org.xml.sax.Locator Interface

All Known Implementing Classes: org.xml.sax.helpers.LocatorImpl

Members

Overview

This interface is a complement to an XML document or other parsed constructs, as it provides the document’s system ID and public ID as well as information about the location within the file being processed. This is particularly helpful for use in IDE applications and for identifying where errors occur in parsing

Method Overviews

The first method you need to define is one that sets an org.xml.sax.Locator for use within any other sax events. When callback event occurs, the class implanting a handler often needs access to location of the SAX parser within an XML file. This is used to help the application make decision about the event and its location within the XML document, such as determining the line on which an error occur. The Locator class has several usefull methods such as getLineNumber() and getColumnNumber() that return the current location for the parsing process within an XML file when invoked. Because this location is only valid for the current parsing lifecycle, the Locator should be used only within the scope of the ContentHandler Implementation. Since this might be handy to use later, the code shown here saves the provided Locator instance to a member variable.

public class ContentHandlerImpl implements ContentHandler{

            /** Hold onto the locator for location information*/

            private Locator locator;

            public void setDocumentLocator(Locator locator){

            this.locator = locator;

}

}