java.applet

java.awt

java.awt.color

java.awt.datatransfer

java.awt.dnd

java.awt.event

java.awt.font

java.awt.geom

java.awt.im

java.awt.im.spi

java.awt.image

java.awt.image.renderable

java.awt.print

java.beans

java.beans.beancontext

java.io

java.lang

java.lang.annotation

java.lang.instrument

java.lang.management

java.lang.ref

java.lang.reflect

java.math

java.net

java.nio

java.nio.channels

java.nio.channels.spi

java.nio.charset

java.nio.charset.spi

java.rmi

java.rmi.activation

java.rmi.dgc

java.rmi.registry

java.rmi.server

java.security

java.security.acl

java.security.cert

java.security.interfaces

java.security.spec

java.sql

java.text

java.util

java.util.concurrent

java.util.concurrent.atomic

java.util.concurrent.locks

java.util.jar

java.util.logging

java.util.prefs

java.util.regex

java.util.zip

javax.accessibility

javax.activity

javax.crypto

javax.crypto.interfaces

javax.crypto.spec

javax.imageio

javax.imageio.event

javax.imageio.metadata

javax.imageio.plugins.bmp

javax.imageio.plugins.jpeg

javax.imageio.spi

javax.imageio.stream

javax.management

javax.management.loading

javax.management.modelmbean

javax.management.monitor

javax.management.openmbean

javax.management.relation

javax.management.remote

javax.management.remote.rmi

javax.management.timer

javax.naming

javax.naming.directory

javax.naming.event

javax.naming.ldap

javax.naming.spi

javax.net

javax.net.ssl

javax.print

javax.print.attribute

javax.print.attribute.standard

javax.print.event

javax.rmi

javax.rmi.CORBA

javax.rmi.ssl

javax.security.auth

javax.security.auth.callback

javax.security.auth.kerberos

javax.security.auth.login

javax.security.auth.spi

javax.security.auth.x500

javax.security.cert

javax.security.sasl

javax.sound.midi

javax.sound.midi.spi

javax.sound.sampled

javax.sound.sampled.spi

javax.sql

javax.sql.rowset

javax.sql.rowset.serial

javax.sql.rowset.spi

javax.swing

javax.swing.border

javax.swing.colorchooser

javax.swing.event

javax.swing.filechooser

javax.swing.plaf

javax.swing.plaf.basic

javax.swing.plaf.metal

javax.swing.plaf.multi

javax.swing.plaf.synth

javax.swing.table

javax.swing.text

javax.swing.text

javax.swing.text.parser

javax.swing.text.rtf

javax.swing.tree

javax.swing.undo

javax.transaction

javax.transaction.xa

javax.xml

javax.xml.datatype

javax.xml.namespace

javax.xml.parsers

javax.xml.transform

javax.xml.transform.dom

javax.xml.transform.sax

javax.xml.transform.stream

javax.xml.validation

javax.xml.xpath

org.ietf.jgss

org.omg.CORBA

org.omg.CORBA_2_3

org.omg.CORBA_2_3.portable

org.omg.CORBA.DynAnyPackage

org.omg.CORBA.ORBPackage

org.omg.CORBA.portable

org.omg.CORBA.TypeCodePackage

org.omg.CosNaming

org.omg.CosNaming.NamingContextExtPackage

org.omg.CosNaming.NamingContextPackage

org.omg.Dynamic

org.omg.DynamicAny

org.omg.DynamicAny.DynAnyFactoryPackage

org.omg.DynamicAny.DynAnyPackage

org.omg.IOP

org.omg.IOP.CodecFactoryPackage

org.omg.IOP.CodecPackage

org.omg.Messaging

org.omg.PortableInterceptor

org.omg.PortableInterceptor.ORBInitInfoPackage

org.omg.PortableServer

org.omg.PortableServer.CurrentPackage

org.omg.PortableServer.POAManagerPackage

org.omg.PortableServer.POAPackage

org.omg.PortableServer.portable

org.omg.PortableServer.ServantLocatorPackage

org.omg.SendingContext

org.omg.stub.java.rmi

org.w3c.dom

org.w3c.dom.bootstrap

org.w3c.dom.events

org.w3c.dom.ls

org.xml.sax

org.xml.sax.ext

org.xml.sax.helpers

allclasses-frame

allclasses-noframe

constant-values

deprecated-list

help-doc

JavaTM 2 Platform
Standard Ed. 5.0

org.xml.sax
接口 Locator

所有已知子接口:
Locator2
所有已知实现类:
Locator2Impl, LocatorImpl

public interface Locator

用来将 SAX 事件与文档位置关联的接口。

此模块(包括源代码和文档)在公共域中,同时 没有担保有关更多信息,请参阅http://www.saxproject.org

如果 SAX 解析器为 SAX 应用程序提供位置信息,要实现这一点,则需要先实现此接口,然后使用内容处理程序的 setDocumentLocator 方法将一个实例传递给应用程序。应用程序可以使用此对象获取 XML 源文档中其他任何 SAX 事件的位置。

注意,由该对象返回的结果仅在每个回调方法内有效:如果应用程序尝试在其他任何时间,或在完成解析后使用定位器,则将接收到不可预知的结果。

不要求 SAX 解析器提供定位器,但强烈建议它提供定位器。如果解析器提供定位器,则必须在报告任何其他文档事件之前提供它。如果在应用程序接收 startDocument 事件之前尚未设置定位器,则应用程序必须假定定位器不可用。

从以下版本开始:
SAX 1.0
另请参见:
ContentHandler.setDocumentLocator(org.xml.sax.Locator)

方法摘要
 int getColumnNumber()
          返回当前文档事件结束处的列号。
 int getLineNumber()
          返回当前文档事件结束处的行号。
 String getPublicId()
          返回当前文档事件的公共标识符。
 String getSystemId()
          返回当前文档事件的系统标识符。
 

方法详细信息

getPublicId

String getPublicId()
返回当前文档事件的公共标识符。

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

返回:
包含公共标识符的字符串,如果没有可用的,则返回 null。
另请参见:
getSystemId()

getSystemId

String getSystemId()
返回当前文档事件的系统标识符。

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

如果系统标识符是 URL,则解析器必须在将它传递给应用程序之前完整解析它。例如,必须始终以 file:... 的形式提供文件。URL 和其他类型的相对 URI 也将根据它们的基来解析。

返回:
包含系统标识符的字符串,如果没有可用的,则返回 null。
另请参见:
getPublicId()

getLineNumber

int getLineNumber()
返回当前文档事件结束处的行号。行由行尾分隔,这在 XML 规范中定义。

警告:从该方法返回的值只是供诊断用的近似值;并不提供编辑源 XML 文档的字符内容所需的充足信息。在某些情况下,这些“行”号与将显示为列的号匹配,而在其他一些情况下,因内部实体扩展它们可以与源文本不匹配。

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

如有可能,SAX 驱动器应该提供与文档事件相关的文本之后的第一个字符的行位置。第一行就是 "line 1"。

返回:
行号,如果没有可用的,则返回 -1。
另请参见:
getColumnNumber()

getColumnNumber

int getColumnNumber()
返回当前文档事件结束处的列号。这是自最后一行结束后,从一开始的 Java char 值号。

警告:从该方法返回的值只是供诊断用的近似值;并不提供编辑源 XML 文档的字符内容所需的充足信息。例如,当行包括组合字符序列、宽字符、代理项对或双向文本组合时,该值可能与文本编辑器中所显示的列不一致。

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

如有可能,SAX 驱动器应该提供与文档事件相关的文本之后的第一个字符的行位置。每行中的第一列就是 "column 1"。

返回:
列号,如果没有可用的,则返回 -1。
另请参见:
getLineNumber()

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策