org.xml.sax.helpers
public class LocatorImpl extends Object implements Locator
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.
Since: SAX 1.0
Version: 2.0.1 (sax2r2)
See Also: Locator
| Constructor Summary | |
|---|---|
| LocatorImpl()
Zero-argument constructor.
| |
| LocatorImpl(Locator locator)
Copy constructor.
| |
| Method Summary | |
|---|---|
| int | getColumnNumber()
Return the saved column number (1-based).
|
| int | getLineNumber()
Return the saved line number (1-based).
|
| String | getPublicId()
Return the saved public identifier.
|
| String | getSystemId()
Return the saved system identifier.
|
| void | setColumnNumber(int columnNumber)
Set the column number for this locator (1-based).
|
| void | setLineNumber(int lineNumber)
Set the line number for this locator (1-based).
|
| void | setPublicId(String publicId)
Set the public identifier for this locator.
|
| void | setSystemId(String systemId)
Set the system identifier for this locator.
|
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).
Parameters: locator The locator to copy.
Returns: The column number as an integer, or -1 if none is available.
See Also: Locator LocatorImpl
Returns: The line number as an integer, or -1 if none is available.
See Also: Locator LocatorImpl
Returns: The public identifier as a string, or null if none is available.
See Also: Locator LocatorImpl
Returns: The system identifier as a string, or null if none is available.
See Also: Locator LocatorImpl
Parameters: columnNumber The column number, or -1 if none is available.
See Also: LocatorImpl
Parameters: lineNumber The line number, or -1 if none is available.
See Also: LocatorImpl
Parameters: publicId The new public identifier, or null if none is available.
See Also: LocatorImpl
Parameters: systemId The new system identifier, or null if none is available.
See Also: LocatorImpl