Module java.xml

Class LocatorImpl

All Implemented Interfaces:
Direct Known Subclasses:

public class LocatorImpl
extends Object
implements Locator
Provide an optional convenience implementation of Locator.

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.

1.4, SAX 1.0
See Also:
  • Constructor Details

    • LocatorImpl

      public LocatorImpl()
      Zero-argument constructor.

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

    • LocatorImpl

      public LocatorImpl​(Locator locator)
      Copy constructor.

      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).

      locator - The locator to copy.
  • Method Details