(七) 涉及API

涉及API

类 javax.xml.parsers.DocumentBuilderFactory
static DocumentBuilderFactory newInstance() : 获取 DocumentBuilderFactory 的新实例。
abstract  DocumentBuilder newDocumentBuilder() : 使用当前配置的参数创建一个新的 DocumentBuilder 实例。
boolean isValidating() : 指示是否将工厂配置为生成解析器，该解析器在解析时验证 XML 内容。
void setValidating(boolean validating) : 指定由此代码生成的解析器将验证被解析的文档。  
boolean isIgnoringElementContentWhitespace() : 指示是否将工厂配置为生成解析器，该解析器忽略元素内容中的可忽略空格。
void setIgnoringElementContentWhitespace(boolean whitespace) : 指定由此工厂创建的解析器在解析 XML 文档时，必须删除元素内容中的空格
boolean isNamespaceAware() : 指示是否将工厂配置为生成具有感知名称空间功能的解析器。
void setNamespaceAware(boolean awareness) : 指定由此代码生成的解析器将提供对 XML 名称空间的支持。 



类 javax.xml.parsers.DocumentBuilder
Document parse(File f) : 将给定文件的内容解析为一个 XML 文档，并且返回一个新的 DOM Document 对象。
Document parse(InputStream is) : 将给定 InputStream 的内容解析为一个 XML 文档，并且返回一个新的 DOM Document 对象。
Document parse(String uri) : 将给定 URI 的内容解析为一个 XML 文档，并且返回一个新的 DOM Document 对象。
abstract  void setEntityResolver(EntityResolver er) : 指定使用 EntityResolver 解析要解析的 XML 文档中存在的实体。
abstract  void setErrorHandler(ErrorHandler eh) : 指定解析器要使用的 ErrorHandler。 


接口 org.w3c.dom.Document
Element getDocumentElement() : 这是一种便捷属性，该属性允许直接访问文档的文档元素的子节点。用于得到根节点

接口 org.w3c.dom.Element
String getTagName() : 元素的名称。
String getAttribute(String name) : 通过名称获得属性值。 

 
接口 org.w3c.dom.Node
NodeList getChildNodes() : 包含此节点的所有子节点的 NodeList。
Node getFirstChild() : 此节点的第一个子节点。 不一定是Element
Node getLastChild() : 此节点的最后一个节点。 不一定是Element
Node getNextSibling() : 直接在此节点之后的节点。
Node getPreviousSibling() : 直接在此节点之前的节点。
Node getParentNode() : 此节点的父节点。
NamedNodeMap getAttributes() : 包含此节点的属性的 NamedNodeMap（如果它是 Element）；否则为 null。
String getNodeName() : 此节点的名称，取决于其类型；当该节点是Attr节点时，该名字就是属性名
short getNodeType() : 表示基础对象的类型的节点
String getNodeValue() : 此节点的值，取决于其类型；当该节点是Attr节点时，该值就是属性值。
String getLocalName() : 返回此节点限定名称的本地部分。
String getNamespaceURI() : 此节点的名称空间 URI；如果它未被指定，则返回 null。

接口 org.w3c.dom.CharacterData
String getData() : 实现此接口的节点的字符数据。

接口 org.w3c.dom.Text extends CharacterData

接口 org.w3c.dom.NodeList
int getLength() : 列表中的节点数。
Node item(int index) : 返回集合中的第 index 个项。

接口 org.w3c.dom.NamedNodeMap
int getLength() : 此映射中的节点数
Node item(int index) : 返回映射中第 index 个项。
Node getNamedItem(String name) : 检索通过名称指定的节点。

接口 org.xml.sax.EntityResolver
InputSource resolveEntity(String publicId, String systemId) : 允许应用程序解析外部实体。 publicId - 被引用的外部实体的公共标识符，如果未提供，则为 null。systemId - 被引用的外部实体的系统标识符。

类 org.xml.sax.InputSource
InputSource(InputStream byteStream) : 使用字节流创建新的输入源。
InputSource(Reader characterStream) : 使用字符流创建新的输入源。
InputSource(String systemId) : 使用系统标识符创建新的输入源。

接口 org.xml.sax.ErrorHandler
void error(SAXParseException exception) : 接收可恢复的错误的通知。
void fatalError(SAXParseException exception) : 接收不可恢复的错误的通知。
void warning(SAXParseException exception) : 接收警告的通知。

类 org.xml.sax.SAXParseException
int getColumnNumber() : 发生异常的文本结尾的列号。
int getLineNumber() : 发生异常的文本结尾的行号。

类 javax.xml.xpath.XPathFactory
static XPathFactory newInstance() : 获取使用默认对象模型 DEFAULT_OBJECT_MODEL_URI（即 W3C DOM）的新 XPathFactory 实例。
abstract  XPath newXPath() : 返回使用实例化 XPathFactory 时确定的底层对象模型的新 XPath。
 
接口 javax.xml.xpath.XPath
String evaluate(String expression, Object item) : 计算指定上下文中的 XPath 表达式并返回 String 形式的结果。
Object evaluate(String expression, InputSource source, QName returnType) : 计算指定 InputSource 上下文中的 XPath 表达式并返回指定类型的结果。
 
类 javax.xml.parsers.SAXParserFactory
static SAXParserFactory newInstance(String factoryClassName, ClassLoader classLoader) : 从类名称中获取新的 SAXParserFactory 实例。
abstract  SAXParser newSAXParser() : 使用当前配置的工厂参数创建 SAXParser 的一个新实例。
boolean isNamespaceAware() : 指示是否将工厂配置为生成具有感知名称空间功能的解析器。  
void setNamespaceAware(boolean awareness) : 指定由此代码生成的解析器将提供对 XML 名称空间的支持。
boolean isValidating() : 指示是否将工厂配置为生成解析器，该解析器在解析时验证 XML 内容。
void setValidating(boolean validating) : 指定由此代码生成的解析器将验证被解析的文档。  

类 javax.xml.parsers.SAXParser
void parse(File f, DefaultHandler dh) : 使用指定的 DefaultHandler 将指定文件的内容解析为 XML。
void parse(String uri, DefaultHandler dh) : 使用指定的 DefaultHandler 将给定统一资源标识符 (URI) 描述的内容解析为 XML。 
void parse(InputStream is, DefaultHandler dh) : 使用指定的 DefaultHandler 将给定的 InputStream 实例的内容解析为 XML。

接口 org.xml.sax.ContentHandler
void startDocument() : 接收文档的开始的通知。
void endDocument() : 接收文档的结尾的通知。
void startElement(String uri, String localName, String qName, Attributes atts) : 接收元素开始的通知。
void endElement(String uri, String localName, String qName) : 接收元素结束的通知。
    参数 : uri            命名空间的URI(如果解析器支持命名空间特性)
              lname      不带别名前缀的本地名(如果解析器支持命名空间特性)
              qname     元素名(如果解析器不支持命名空间特性)，或者带有别名前缀的限定名(如果解析器除了报告本地名之外还报告限定名)
void characters(char[] ch, int start, int length) : 接收字符数据的通知
    参数 : ch         字符数据数组
              start      作为被报告的字符的一部分的字符数组，它的第一个字符的索引
              length  被报告的字符串长度

接口 org.xml.sax.Attributes
int getLength() : 返回此列表中的属性个数。
String getLocalName(int index) : 通过索引查找属性的本地名称。
String getURI(int index) : 通过索引查找属性的名称空间 URI。
String getQName(int index) : 通过索引查找属性的 XML 限定（前缀）名。
String getValue(int index) : 通过索引查找属性的值。
String getValue(String qName) : 通过 XML 限定（前缀）名查找属性的值。
String getValue(String uri, String localName) : 根据名称空间的名称查找属性的值。
   
类 javax.xml.stream.XMLInputFactory
static XMLInputFactory newInstance() : 创建一个新的工厂实例。
abstract  void setProperty(String name, Object value) : 允许用户在底层实现上设置特定功能/属性。或者在要设置的属性不支持设置成给定值时，抛出IllegalArgumentException。
    参数:   XMLInputFactory.IS_VALIDATING                       为false(默认值)时，这个文档不被验证(规范不需要)
            XMLInputFactory.IS_NAMESPACE_AWARE                  为true(默认值)时，这个将处理命名空间(规范不需要)
            XMLInputFactory.IS_COALESCING                       为false(默认值)时,邻近的字符不进行连接
            XMLInputFactory.IS_REPLACING_ENTITY_REFERENCES      为true(默认值)时，实体引用将作为字符数据被替换和报告
            XMLInputFactory.IS_SUPPORTING_EXTERNAL_ENTITIES     为true(默认值)时，外部实体将被解析，规范对于这个属性没有给出默认值。
            XMLInputFactory.SUPPORT_DTD                         为true(默认值)时，DTD将作为事件被报告
abstract  XMLStreamReader createXMLStreamReader(InputStream stream) : 根据 java.io.InputStream 创建一个新 XMLStreamReader。
abstract  XMLStreamReader createXMLStreamReader(InputStream stream, String encoding) : 根据指定的流的字符编码 根据 java.io.InputStream 创建一个新 XMLStreamReader。
abstract  XMLStreamReader createXMLStreamReader(Reader reader) : 根据 reader 创建一个新 XMLStreamReader。 
abstract  XMLStreamReader createXMLStreamReader(Source source) : 根据 JAXP 源创建一个新 XMLStreamReader。

 
接口 javax.xml.stream.XMLStreamReader
boolean hasNext() : 如果有多个解析事件，则返回 true，如果不再有事件，则返回 false。
int next() : 获取下一个解析事件??处理器可以用单个存储块返回所有连续的字符数据，它也可以将其分割成几个存储块。
        每种状态及对应的有效方法 
事件类型                                        有效方法
所有状态                               
                                                getProperty()、hasNext()、require()、
                                                close()、getNamespaceURI()、isStartElement()、
                                                isEndElement()、isCharacters()、isWhiteSpace()、
                                                getNamespaceContext()、getEventType()、
                                                getLocation()、hasText()、hasName() 
START_ELEMENT         
                                                next()、getName()、getLocalName()、
                                                hasName()、getPrefix()、getAttributeXXX()、
                                                isAttributeSpecified()、getNamespaceXXX()、
                                                getElementText()、nextTag() 
ATTRIBUTE                  
                                                next()、nextTag()、getAttributeXXX()、
                                                isAttributeSpecified() 
NAMESPACE               
                                                next()、nextTag()、getNamespaceXXX() 
END_ELEMENT           
                                                next()、getName()、getLocalName()、
                                                hasName()、getPrefix()、getNamespaceXXX()、
                                                nextTag() 
CHARACTERS             
                                                next()、getTextXXX()、nextTag() 
CDATA                        
                                                next()、getTextXXX()、nextTag() 
COMMENT                 
                                                next()、getTextXXX()、nextTag() 
SPACE                         
                                                next()、getTextXXX()、nextTag() 
START_DOCUMENT               
                                                next()、getEncoding()、getVersion()、
                                                isStandalone()、standaloneSet()、getCharacterEncodingScheme()、
                                                nextTag()
END_DOCUMENT                  
                                                close()
PROCESSING_INSTRUCTION 
                                                next()、getPITarget()、getPIData()、nextTag() 
ENTITY_REFERENCE               
                                                next()、getLocalName()、getText()、nextTag() 
DTD                                        
                                                next()、getText()、nextTag() 
boolean isStartElement() : 如果光标指向开始标记，则返回 true（否则返回 false）
boolean isEndElement() : 如果光标指向结束标记，则返回 true（否则返回 false） 
boolean isCharacters() : 如果光标指向字符数据事件，则返回 true
boolean isWhiteSpace() : 如果光标指向由所有空格组成的字符数据事件，则返回 true
QName getName() : 返回当前 START_ELEMENT 或 END_ELEMENT 事件的 QName 。QName 的值包含名称空间 URI、本地部分和前缀。
String getLocalName() : 返回当前事件的（本地）名称。
String getText() : 以字符串的形式返回解析事件的当前值，此方法返回 CHARACTERS 事件的字符串值，返回 COMMENT 的值、ENTITY_REFERENCE 的替代值、CDATA 节的字符串值、SPACE 事件的字符串值、DTD 内部子集的字符串值。
int getAttributeCount() : 返回此 START_ELEMENT 中的属性计数，此方法仅对 START_ELEMENT 或 ATTRIBUTE 有效。
QName getAttributeName(int index) : 返回所提供索引处的属性的 qname
String getAttributeLocalName(int index) : 返回所提供索引处的属性的 localName
String getAttributeValue(int index) : 返回 index 处的属性值，如果不是 START_ELEMENT 或 ATTRIBUTE。抛出：IllegalStateException
String getAttributeValue(String namespaceURI, String localName) : 返回带有名称空间和 localName 的属性的规范化属性值。 如果 namespcaeURI为null，则不检查名字空间