模块  java.xml
软件包  org.xml.sax.ext

Interface Locator2

  • All Superinterfaces:
    Locator
    所有已知实现类:
    Locator2Impl

    public interface Locator2
    extends Locator
    SAX2扩展以增加通过Locator提供的实体信息。 如果实现支持此扩展,则ContentHandler.setDocumentLocator() 提供的定位器将实现此接口,并且http://xml.org/sax/features/use-locator2功能标志将具有值true
    This module, both source code and documentation, is in the Public Domain, and comes with NO WARRANTY.

    XMLReader实现不需要支持此信息,并且它不是仅核心SAX2分发的一部分。

    从以下版本开始:
    1.5,SAX 2.0(扩展1.1 alpha)
    • 方法详细信息

      • getXMLVersion

        String getXMLVersion()
        返回用于实体的XML版本。 这通常是当前实体的<?xml version =' ...'... ?>声明中的标识符,或者由解析器默认。
        结果
        用于解释实体文本的XML版本的标识符,如果该信息在当前解析状态中尚不可用,则为null。
      • getEncoding

        String getEncoding()
        返回实体的字符编码名称。 如果编码是在外部声明的(例如,在MIME Content-Type标头中),那将是返回的名称。 否则,如果在文档的开头有<?xml ... encoding ='...'?>声明,则将返回该编码名称。 否则将推断编码(通常为UTF-8或某些UTF-16变体),并返回推断的名称。

        当使用InputSource提供实体的字符流时,此方法返回该输入流中提供的编码。

        请注意,最近的一些W3C规范要求在处理之前使用Unicode规范化表C对某些编码中的文本进行规范化。 这种规范化必须由应用程序执行,并且通常会根据此方法返回的值触发。

        编码名称可以是底层JVM使用的名称,并且比较应该不区分大小写。

        结果
        用于解释*实体文本的字符编码的名称,如果没有为通过InputSource传递的*字符流提供,或者在当前解析状态下尚不可用,则返回null。