Android API学习之XmlPullParser

Android API学习之XmlPullParser

公共方法：

---

pulic abstarct int getEventType()

方法功能描述：

返回当前事件类型（事件类型包括START_TAG, END_TAG, TEXT, START_DOCUMENT，END_DOCUMENT等等）

---

public abstarct String nextText()

方法功能描述：

如果当前事件是START_TAG，并且下一个元素是TEXT，该方法将返回元素包含的内容；
如果下一个事件END_TAG，该方法将返回空字符串，另外的情况将抛出异常。如果调用方法成功解析器将被自动移动到END_TAG位置

这个方法即可以用来解析空元素也可以用来解析非空元素，例如：

1. <tag>foo</tag>（这个表示非空元素）
2. <tag></tag>（这个表示空元素，<tag/>和它相同）

它们可以用相同的代码来解析

p.nextTag();
p.requireEvent(p.START_TAG, "", "tag");
String content = p.nextText(); 
p.requireEvent(p.END_TAG, "", "tag"); 

这个方法和nextTag方法一起使用可以很容易的解析没有复杂内容的xml。

方法的内容实现原理如下：

 if(getEventType() != START_TAG) {
    throw new XmlPullParserException("parser must be on START_TAG to read next text", this, null);   
 }   
 int eventType = next();   
 if(eventType == TEXT) {      
    String result = getText();      
    eventType = next();      
    if(eventType != END_TAG) {        
        throw new XmlPullParserException("event TEXT it must be immediately followed by END_TAG", this, null);       
    }       
    return result;   
 } 
 else if(eventType == END_TAG) {
    return "";   
 } 
 else {      
    throw new XmlPullParserException("parser must be on START_TAG or TEXT to read text", this, null);   
 }  

警告：在API 14版本以前，XmlPullParser是通过android.util.Xml来获取，因此调用这个方法成功之后，解析器有可能无法被自动移动到END_TAG位置，但是你可以利用手动的方式来实现

 String text = xpp.nextText();   
 if (xpp.getEventType() != XmlPullParser.END_TAG) {
    xpp.next();   
 } 

可能抛出的异常：

XmlPullParserException
IOException

---

public abstract int next ()

方法功能描述：

获取下一个解析事件，元素内容将被合并在一起，只有一个TEXT事件必须返回所有的元素内容（注释和处理指令会被忽略，实体引用必须能够展开，否则解析器将会抛出异常），如果元素内容为空，解析器将不会上报TEXT事件

空元素（比如<tag/>) 解析过程中会上报两个分离的START_TAG, END_TAG事件，无内容元素 <tag></tag>也一样

可能抛出的异常：

XmlPullParserException
IOException

---

版权声明：原创作品版权归作者所有，转载请注明出处，未经允许禁止私自印刷及出版。一经发现作者将依法追究其法律责任。

与我联系：QQ群539225664

---