Pull解析方法给应用程序完全的控制文档该怎么样被解析。Android中对Pull方法提供了支持的API,主要是
org.xmlpull.v1.XmlPullParser;
org.xmlpull.v1.XmlPullParserFactory;
二个类,其中主要使用的是XmlPullParser,XmlPullParserFactory是一个工厂,用于构建XmlPullParser对象。
应用程序通过调用XmlPullParser.next()等方法来产生Event,然后再处理Event。可以看到它与Push方法的不同,Push方法是由Parser自己主动产生Event,回调给应用程序。而Pull方法是主动的调用Parser的方法才能产生事件。
假如XML中的语句是这样的:
<author country="United States">James Elliott</author>author是TAG,country是ATTRIBUTE,"James Elliott"是TEXT
要想解析文档先要构建一个XmlPullParser对象
final XmlPullParserFactory factory = XmlPullParserFactory.newInstance(); factory.setNamespaceAware(true); final XmlPullParser parser = factory.newPullParser();
Pull解析是一个遍历文档的过程,每次调用next(),nextTag(),nextToken()和nextText()都会向前推进文档,并使Parser停留在某些事件上面,但是不能倒退。
然后把文档设置给Parser
parser.setInput(new StringReader("<author country=\"United States\">James Elliott</author>");
这时,文档刚被初始化,所以它应该位于文档的开始,事件应该是START_DOCUMENT,可以通过XmlPullParser.getEventType()来获取。
然后调用next()会产生START_TAG,这个事件告诉应用程序一个标签已经开始了,调用getName()会返回"author";
再next(),会产生TEXT事件,调用getText()会返回"James Elliott",
END_TAG,这个告诉你一个标签已经处理完了,
END_DOCUMENT,它告诉你整个文档已经处理完成了。
除了next()外,nextToken()也可以使用,只不过它会返回更加详细的事件,比如COMMENT,CDSECT,DOCDECL,ENTITY等等非常详细的信息。如果程序得到比较底层的信息,可以用nextToken()来驱动并处理详细的事件。需要注意一点的是TEXT事件是有可能返回空白的White Spaces比如换行符或空格等。
另外有二个非常实用的方法nextTag()和nextText()
nextTag()--首先它会忽略White Spaces,如果可以确定下一个是START_TAG或END_TAG,就可以调用nextTag()直接跳过去。通常它有二个用处:当START_TAG时,如果能确定这个TAG含有子TAG,那么就可以调用nextTag()产生子标签的START_TAG事件;当END_TAG时,如果确定不是文档结尾,就可以调用nextTag()产生下一个标签的START_TAG。在这二种情况下如果用next()会有TEXT事件,但返回的是换行符或空白符。
nextText()--它只能在START_TAG时调用。当下一个元素是TEXT时,TEXT的内容会返回;当下一个元素是END_TAG时,也就是说这个标签的内容为空,那么空字串返回;这个方法返回后,Parser会停在END_TAG上。比如:
<author>James Elliott</author> <author></author> <author/>
当START_TAG时,调用nextText(),依次返回:
"James Elliott"
""(empty)
<title>What Is Hibernate</title>
<author>James Elliott</author>
<category>Web</category>
就可以用以下代码来处理:
while (eventType != XmlPullParser.END_TAG) { switch (eventType) { case XmlPullParser.START_TAG: tag = parser.getName(); final String content = parser.nextText(); Log.e(TAG,tag + ": [" + content + "]"); eventType = parser.nextTag(); break; default: break; } }
这就要比用next()来处理方便多了,可读性也大大的加强了。