compact2, compact3

org.xml.sax

Interface Locator

All Known Subinterfaces:

Locator2

所有已知实现类：

Locator2Impl， LocatorImpl

public interface Locator

关联的SAX事件和文档位置界面。

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.

如果一个SAX解析器提供位置信息的SAX应用程序，它通过实现此接口，然后通过一个实例来使用内容处理程序的setDocumentLocator方法的应用。应用程序可以使用对象获取XML源文档中任何其他的SAX事件的位置。

请注意，对象返回的结果将只在每个回调方法的范围内有效：应用程序将收到不可预知的结果，如果它试图在任何其他时间使用定位器，或解析完成后。

SAX解析器并不需要提供一个定位器，但他们是非常鼓励这样做。如果解析器提供了一个定位器，它必须在报告任何其他文档事件之前这样做。如果没有定位已经由应用程序接收startDocument事件时，应用程序应该假设一个定位器是不可用的。

从以下版本开始：

萨克斯1

另请参见：

ContentHandler.setDocumentLocator(org.xml.sax.Locator)

方法摘要

Modifier and Type	Method and Description
int	getColumnNumber() 返回当前文档事件结束的列号。
int	getLineNumber() 返回当前文档事件结束的行数。
String	getPublicId() 返回当前文档事件的公共标识符。
String	getSystemId() 返回当前文档事件的系统标识符。

方法详细信息

getPublicId

String getPublicId()

返回当前文档事件的公共标识符。

返回值是文档实体的公共标识符或外部解析实体的公共标识符，其中标记触发事件的出现。

结果

包含公共标识符或空的字符串，如果没有可用的。

另请参见：

getSystemId()

getSystemId

String getSystemId()

返回当前文档事件的系统标识符。

返回值是文档实体的系统标识符或外部分析的实体，在该实体中，标记触发事件的出现。

如果系统标识符是一个链接，解析器必须完全解析它，才将它传递给应用程序。例如，一个文件名必须始终提供为一个文件：…URL和其他种类的相对URI也解决了对他们的基地。

结果

如果没有可用的字符串，则包含该系统标识符的字符串或。

另请参见：

getPublicId()

getLineNumber

int getLineNumber()

返回当前文档事件结束的行数。行分隔的行结束，这是在XML规范中定义的。

警告：返回值的方法，只是作为一个近似的诊断起见；它不打算编辑原始XML文档的字符内容提供足够的信息。在某些情况下，这些“行”号匹配将显示为列，而在其他情况下，他们可能不匹配源文本由于内部实体扩展。

返回值是文档实体或外部解析实体的行数的近似值，在该实体中，出现了标记触发的标记。

如果可能的话，萨克斯司机应与事件相关的文本文件后提供的第一个字符的位置线。第一行是1号线。

结果

该行数，或- 1如果没有可用。

另请参见：

getColumnNumber()

getColumnNumber

int getColumnNumber()

返回当前文档事件结束的列号。这是一个基于java的一些 char值最后一行结束以来。

警告：返回值的方法，只是作为一个近似的诊断起见；它不打算编辑原始XML文档的字符内容提供足够的信息。例如，当行包含组合字符序列、宽字符、替代对或双向文本时，值可能不对应于文本编辑器显示中的列。

返回值是文档实体或外部解析实体中的列号的近似值，其中出现了标记触发事件的标记。

如果可能的话，萨克斯司机应与事件相关的文本文件后提供的第一个字符的位置线。在每行的第一列是列1。

结果

列数，或-如果没有可用的则为1。

另请参见：

getLineNumber()