Added in API level 1

LocatorImpl

public class LocatorImpl
extends Object implements Locator

java.lang.Object
   ↳ org.xml.sax.helpers.LocatorImpl


Provide an optional convenience implementation of 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.

See also:

Summary

Public constructors

LocatorImpl()

Zero-argument constructor.

LocatorImpl(Locator locator)

Copy constructor.

Public methods

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.

Inherited methods

Public constructors

LocatorImpl

Added in API level 1
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

Added in API level 1
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).

Parameters
locator Locator: The locator to copy.

Public methods

getColumnNumber

Added in API level 1
public int getColumnNumber ()

Return the saved column number (1-based).

Returns
int The column number as an integer, or -1 if none is available.

getLineNumber

Added in API level 1
public int getLineNumber ()

Return the saved line number (1-based).

Returns
int The line number as an integer, or -1 if none is available.

getPublicId

Added in API level 1
public String getPublicId ()

Return the saved public identifier.

Returns
String The public identifier as a string, or null if none is available.

getSystemId

Added in API level 1
public String getSystemId ()

Return the saved system identifier.

Returns
String The system identifier as a string, or null if none is available.

setColumnNumber

Added in API level 1
public void setColumnNumber (int columnNumber)

Set the column number for this locator (1-based).

Parameters
columnNumber int: The column number, or -1 if none is available.

See also:

setLineNumber

Added in API level 1
public void setLineNumber (int lineNumber)

Set the line number for this locator (1-based).

Parameters
lineNumber int: The line number, or -1 if none is available.

See also:

setPublicId

Added in API level 1
public void setPublicId (String publicId)

Set the public identifier for this locator.

Parameters
publicId String: The new public identifier, or null if none is available.

See also:

setSystemId

Added in API level 1
public void setSystemId (String systemId)

Set the system identifier for this locator.

Parameters
systemId String: The new system identifier, or null if none is available.

See also: