Java Doc for LocatorImpl.java in  » Web-Server » Rimfaxe-Web-Server » org » xml » sax » helpers » Java Source Code / Java DocumentationJava Source Code and Java Documentation

This module, both source code and documentation, is in the Public Domain, and comes with NO WARRANTY. See http://www.saxproject.org for further information.

This class is available mainly for application writers, who can use it to make a persistent snapshot of a locator at any point during a document parse:

 Locator locator;
 Locator startloc;
 public void setLocator (Locator locator)
 {
 // note the locator
 this.locator = locator;
 }
 public void startDocument ()
 {
 // save the location of the start of the document
 // for future use.
 Locator startloc = new LocatorImpl(locator);
 }
 

Normally, parser writers will not use this class, since it is more efficient to provide location information only when requested, rather than constantly updating a Locator object.

This will not normally be useful, since the main purpose of this class is to make a snapshot of an existing Locator.

Create a persistent copy of the current state of a locator. When the original locator changes, this copy will still keep the original values (and it can be used outside the scope of DocumentHandler methods).