DOMLocator

AI-generated Key Takeaways

• DOMLocator helps pinpoint the location of a node within a source DOM, mainly for error reporting in XML transformations.

• It allows access to the node where an event occurred and inherits methods to identify the line and column number, public identifier, and system identifier of the event location.

• A Transformer can use DOMLocator for purposes beyond error reporting, such as tracking the source of result nodes.

public interface DOMLocator implements SourceLocator

Indicates the position of a node in a source DOM, intended primarily for error reporting. To use a DOMLocator, the receiver of an error must downcast the SourceLocator object returned by an exception. A Transformer may use this object for purposes other than error reporting, for instance, to indicate the source node that originated a result node.

Public Method Summary

abstract Node

getOriginatingNode() Return the node where the event occurred.

Inherited Method Summary

From interface javax.xml.transform.SourceLocator

abstract int	getColumnNumber() Return the character position where the current document event ends.
abstract int	getLineNumber() Return the line number where the current document event ends.
abstract String	getPublicId() Return the public identifier for the current document event.
abstract String	getSystemId() Return the system identifier for the current document event.

Public Methods

public abstract Node getOriginatingNode ()

Return the node where the event occurred.

Returns

• The node that is the location for the event.