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

Interface Attributes2

  • All Superinterfaces:
    Attributes
    所有已知实现类:
    Attributes2Impl

    public interface Attributes2
    extends Attributes
    SAX2扩展,用于扩充通过Attributes提供的每个属性信息。 如果实现支持此扩展,则ContentHandler.startElement() 提供的属性将实现此接口,并且http://xml.org/sax/features/use-attributes2功能标志将具有值true
    This module, both source code and documentation, is in the Public Domain, and comes with NO WARRANTY.

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

    请注意,如果属性是默认的( !isSpecified() ),则必须在DTD中声明( isDeclared() )。 类似地,如果属性的类型是除CDATA之外的任何类型,则必须已声明它。

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

      • isDeclared

        boolean isDeclared​(int index)
        除非在DTD中声明了属性,否则返回false。 这有助于区分SAX报告为CDATA的两种属性:已声明的(因此通常是有效的),以及那些不是(并且永远无效)的属性。
        参数
        index - 属性索引(从零开始)。
        结果
        如果属性在DTD中声明,则返回true,否则返回false。
        异常
        ArrayIndexOutOfBoundsException - 提供的索引未标识属性时。
      • isDeclared

        boolean isDeclared​(String qName)
        除非在DTD中声明了属性,否则返回false。 这有助于区分SAX报告为CDATA的两种属性:已声明的(因此通常是有效的),以及那些不是(并且永远无效)的属性。
        参数
        qName - XML限定(加前缀)名称。
        结果
        如果属性在DTD中声明,则返回true,否则返回false。
        异常
        IllegalArgumentException - 提供的名称未标识属性时。
      • isDeclared

        boolean isDeclared​(String uri,
                           String localName)
        除非在DTD中声明了属性,否则返回false。 这有助于区分SAX报告为CDATA的两种属性:已声明的(因此通常是有效的),以及那些不是(并且永远无效)的属性。

        请记住,由于DTD不“理解”命名空间,因此与属性关联的命名空间URI可能不是来自DTD。 声明将应用于属性的qName

        参数
        uri - 名称空间URI,如果名称没有名称空间URI,则为空字符串。
        localName - 属性的本地名称。
        结果
        如果属性在DTD中声明,则返回true,否则返回false。
        异常
        IllegalArgumentException - 提供的名称未标识属性时。
      • isSpecified

        boolean isSpecified​(int index)
        除非DTD默认提供属性值,否则返回true。
        参数
        index - 属性索引(从零开始)。
        结果
        如果在XML文本中找到该值,则返回true;如果该值由DTD默认值提供,则返回false。
        异常
        ArrayIndexOutOfBoundsException - 当提供的索引未标识属性时。
      • isSpecified

        boolean isSpecified​(String uri,
                            String localName)
        除非DTD默认提供属性值,否则返回true。

        请记住,由于DTD不“理解”命名空间,因此与属性关联的命名空间URI可能不是来自DTD。 声明将应用于属性的qName

        参数
        uri - 名称空间URI,如果名称没有名称空间URI,则为空字符串。
        localName - 属性的本地名称。
        结果
        如果在XML文本中找到该值,则返回true;如果该值由DTD默认值提供,则返回false。
        异常
        IllegalArgumentException - 提供的名称未标识属性时。
      • isSpecified

        boolean isSpecified​(String qName)
        除非DTD默认提供属性值,否则返回true。
        参数
        qName - XML限定(加前缀)名称。
        结果
        如果在XML文本中找到该值,则返回true;如果该值由DTD默认值提供,则返回false。
        异常
        IllegalArgumentException - 提供的名称未标识属性时。