Driver

APACHE_DYNAMIC_VALIDATION_FEATURE

String APACHE_DYNAMIC_VALIDATION_FEATURE

常量值：“http://apache.org/xml/features/validation/dynamic”

APACHE_SCHEMA_VALIDATION_FEATURE

String APACHE_SCHEMA_VALIDATION_FEATURE

常量值：“http://apache.org/xml/features/validation/schema”

DECLARATION_HANDLER_PROPERTY

String DECLARATION_HANDLER_PROPERTY

常量值：“http://xml.org/sax/properties/declaration-handler”

LEXICAL_HANDLER_PROPERTY

String LEXICAL_HANDLER_PROPERTY

常量值：“http://xml.org/sax/properties/lexical-handler”

NAMESPACES_FEATURE

String NAMESPACES_FEATURE

常量值：“http://xml.org/sax/features/namespaces”

NAMESPACE_PREFIXES_FEATURE

String NAMESPACE_PREFIXES_FEATURE

常量值：“http://xml.org/sax/features/namespace-prefixes”

VALIDATION_FEATURE

String VALIDATION_FEATURE

常量值：“http://xml.org/sax/features/validation”

contentHandler

ContentHandler contentHandler

errorHandler

ErrorHandler errorHandler

pp

XmlPullParser pp

systemId

String systemId

Driver

Driver ()

Driver

Driver (XmlPullParser pp)

getColumnNumber

int getColumnNumber ()

返回当前文档事件结束的列号。 这是自上一行结束以来Java char值的一个数字。

警告：该方法的返回值仅用于诊断的近似值; 它并不打算提供足够的信息来编辑原始XML文档的字符内容。 例如，当行包含组合字符序列，宽字符，代理对或双向文本时，该值可能不对应于文本编辑器显示中的列。

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

如果可能，SAX驱动程序应在与文档事件关联的文本之后提供第一个字符的行位置。 每行的第一列是第1列。

getContentHandler

ContentHandler getContentHandler ()

返回当前的内容处理程序。

getDTDHandler

DTDHandler getDTDHandler ()

返回当前的DTD处理程序。

getEntityResolver

EntityResolver getEntityResolver ()

返回当前的实体解析器。

getErrorHandler

ErrorHandler getErrorHandler ()

返回当前的错误处理程序。

getFeature

boolean getFeature (String name)

查找功能标志的值。

功能名称是任何完全限定的URI。 XMLReader可能会识别功能名称，但暂时无法返回其值。 某些功能值只能在特定的上下文中使用，例如在解析之前，之中或之后。 此外，某些功能值可能无法通过编程访问。 （对于SAX1 Parser的适配器，没有独立于实现的方式来显示底层解析器是否执行验证，扩展外部实体等等。）

所有XMLReader都需要识别http://xml.org/sax/features/namespaces和http://xml.org/sax/features/namespace-prefixes功能名称。

典型的用法是这样的：

 XMLReader r = new MySAXDriver();

                         // try to activate validation
 try {
   r.setFeature("http://xml.org/sax/features/validation", true);
 } catch (SAXException e) {
   System.err.println("Cannot activate validation.");
 }

                         // register event handlers
 r.setContentHandler(new MyContentHandler());
 r.setErrorHandler(new MyErrorHandler());

                         // parse the first document
 try {
   r.parse("http://www.foo.com/mydoc.xml");
 } catch (IOException e) {
   System.err.println("I/O exception reading XML document");
 } catch (SAXException e) {
   System.err.println("XML exception reading document.");
 }
 

实现者可以免费（并鼓励）使用构建在他们自己的URI上的名称来创建自己的特性。

getIndex

int getIndex (String qName)

通过XML限定（前缀）名称查找属性的索引。

getIndex

int getIndex (String uri, 
                String localName)

按名称空间名称查找属性的索引。

getLength

int getLength ()

返回列表中的属性数量。

Once you know the number of attributes, you can iterate through the list.

getLineNumber

int getLineNumber ()

返回当前文档事件结束的行号。 行由行结束符定义，这些行结束符在XML规范中定义。

警告：该方法的返回值仅用于诊断的近似值; 它并不打算提供足够的信息来编辑原始XML文档的字符内容。 在某些情况下，这些“行”号与显示为列的内容匹配，而在其他情况下，由于内部实体扩展，这些号可能与源文本不匹配。

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

如果可能，SAX驱动程序应在与文档事件关联的文本之后提供第一个字符的行位置。 第一行是第一行。

getLocalName

String getLocalName (int index)

通过索引查找属性的本地名称。

getProperty

Object getProperty (String name)

查找一个属性的值。

属性名称是任何完全限定的URI。 XMLReader可能会识别属性名称，但暂时无法返回其值。 某些属性值可能仅在特定上下文中可用，例如在解析之前，之中或之后。

XMLReaders不需要识别任何特定的属性名称，但是初始核心集合记录在SAX2中。

Implementors are free (and encouraged) to invent their own properties, using names built on their own URIs.

getPublicId

String getPublicId ()

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

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

getQName

String getQName (int index)

按索引查找属性的XML限定（前缀）名称。

getSystemId

String getSystemId ()

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

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

如果系统标识符是URL，则解析器必须在将其传递给应用程序之前将其完全解析。 例如，一个文件名必须总是作为一个文件提供：... URL，其他类型的相对URI也将根据它们的基础进行解析。

getType

String getType (int index)

按索引查找属性的类型。

属性类型是字符串“CDATA”，“ID”，“IDREF”，“IDREFS”，“NMTOKEN”，“NMTOKENS”，“ENTITY”，“ENTITIES”或“NOTATION”中的一个（始终为大写） 。

如果解析器没有读取属性声明，或者解析器没有报告属性类型，那么它必须按照XML 1.0建议书（第3.3.3节“属性值标准化”）中的规定返回值“CDATA” ）。

对于不是符号的枚举属性，解析器将报告类型为“NMTOKEN”。

getType

String getType (String uri, 
                String localName)

按名称空间名称查找属性的类型。

有关可能的类型的说明，请参阅 getType(int) 。

getType

String getType (String qName)

按XML限定（前缀）名称查找属性的类型。

有关可能的类型的说明，请参阅 getType(int) 。

getURI

String getURI (int index)

通过索引查找属性的名称空间URI。

getValue

String getValue (int index)

按索引查找属性值。

如果属性值是标记列表（IDREFS，ENTITIES或NMTOKENS），则令牌将连接成单个字符串，每个令牌由一个空格分隔。

getValue

String getValue (String qName)

按XML限定（前缀）名称查找属性的值。

有关可能值的说明，请参阅 getValue(int) 。

getValue

String getValue (String uri, 
                String localName)

按名称空间名称查找属性值。

有关可能值的说明，请参阅 getValue(int) 。

parse

void parse (String systemId)

从系统标识符（URI）解析XML文档。

此方法是从系统标识符中读取文档的常见情况的快捷方式。 这与以下内容完全相同：

 parse(new InputSource(systemId));
 

If the system identifier is a URL, it must be fully resolved by the application before it is passed to the parser.

parse

void parse (InputSource source)

解析一个XML文档。

应用程序可以使用此方法来指示XML阅读器开始从任何有效的输入源（字符流，字节流或URI）解析XML文档。

应用程序可能不会在解析过程中调用此方法（它们应该为每个嵌套的XML文档创建一个新的XMLReader）。 解析完成后，应用程序可能会重用相同的XMLReader对象，可能会使用不同的输入源。 除非配置的该方面的定义明确指定了其他行为，否则XMLReader对象的配置（例如为功能标志和属性建立的处理程序绑定和值）不会改变。 （例如，特征标志或属性暴露了正在分析的文档的特征。）

在解析过程中，XMLReader将通过注册的事件处理程序提供有关XML文档的信息。

这种方法是同步的：直到解析结束才会返回。 如果客户端应用程序想要尽早终止解析，它应该抛出异常。

parseSubTree

void parseSubTree (XmlPullParser pp)

setContentHandler

void setContentHandler (ContentHandler handler)

允许应用程序注册内容事件处理程序。

如果应用程序未注册内容处理程序，则SAX解析器报告的所有内容事件都将被忽略。

应用程序可以在解析中注册新的或不同的处理程序，并且SAX解析器必须立即开始使用新的处理程序。

setDTDHandler

void setDTDHandler (DTDHandler handler)

允许应用程序注册DTD事件处理程序。

如果应用程序未注册DTD处理程序，则SAX解析器报告的所有DTD事件都将被忽略。

应用程序可以在解析中注册新的或不同的处理程序，并且SAX解析器必须立即开始使用新的处理程序。

setEntityResolver

void setEntityResolver (EntityResolver resolver)

允许应用程序注册实体解析器。

如果应用程序未注册实体解析器，则XMLReader将执行其自己的默认解析。

应用程序可以在解析中注册一个新的或不同的解析器，并且SAX解析器必须立即开始使用新的解析器。

setErrorHandler

void setErrorHandler (ErrorHandler handler)

允许应用程序注册错误事件处理程序。

如果应用程序没有注册错误处理程序，则SAX解析器报告的所有错误事件将被忽略; 但是，正常的处理可能不会继续。 强烈建议所有SAX应用程序实施错误处理程序以避免意外的错误。

应用程序可以在解析中注册新的或不同的处理程序，并且SAX解析器必须立即开始使用新的处理程序。

setFeature

void setFeature (String name, 
                boolean value)

设置功能标志的值。

功能名称是任何完全限定的URI。 XMLReader可能公开一个特征值，但无法更改当前值。 某些特征值只能在特定上下文中不可变或可变，例如在解析之前，之中或之后。

All XMLReaders are required to support setting http://xml.org/sax/features/namespaces to true and http://xml.org/sax/features/namespace-prefixes to false.

setProperty

void setProperty (String name, 
                Object value)

设置属性的值。

属性名称是任何完全限定的URI。 XMLReader可能会识别属性名称，但无法更改当前值。 某些属性值只有在特定的上下文中才可以是不可变的或可变的，例如在解析之前，之中或之后。

XMLReaders不需要识别设置任何特定的属性名称，但核心集由SAX2定义。

该方法也是设置扩展处理程序的标准机制。

startElement

void startElement (String namespace, 
                String localName, 
                String qName)

呼吁startElement上ContentHandler与this驱动程序对象为Attributes的实现。 在默认实现Attributes对象仅在此方法调用期间有效并且可能不存储。 子类可以覆盖此方法来缓存属性。