Android学习笔记---15_采用Pull解析器解析和生成XML内容

15_采用Pull解析器解析和生成XML内容
--------------------------------------
使用SAX或者DOM或者pull解析XML文件
------------------------------------------------------------
1.在Android平台上可以使用Simple API for XML(SAX) 、 Document Object Model(DOM)和  


 Android附带的pull解析器解析XML文件。 pull解器是一个开源项目,既可以用于android
 也可以用于javaEE,如过在javaEE中需要把其jar文件放入类路径中,因为android已经集成了 


 Pull解析器,所以无需添加任何的jar包,android系统本身使用的各种xml文件,其内部也是采
 Pull解析器进行解析的,Pull解析器的运行方式与SAX解析器相似,它提供了类似的事件,如
 开始元素和结束元素事件,使用parser.net()可以进入下一个元素并触发相应事件,跟SAX不  


 同的是,Pull解析器产生的事件是一个数字,而非方法,因此可以使用一个switch对感兴趣的  


 事件进行处理,当元素开始解析时,调用parser.netText()方法,可以获取下一个Text类型节  


 点的值
------------------------------------------------------
2.Pull解析器的源码及文档下载网址:http://xmlpull.org/xmlpull-website/impls.shtml
--------------------------------------------------------------------
<?xml version="1.0" encoding="UTF-8"?>//在xml文档中start document
<persons>//根节点Node Type ?Element node/Textnode
<person id="23">//Element node类型节点
<name>李明</name>//Text node类型的节点
<age>30</age>
</person>
<person id="20">
<name>李向梅</name>
<age>25</age>
</person>
</persons>
//end documnet
--------------------------------------------
3.pull解析器的解析原理:
  pull解析器会把xml文件读到一个char[]数组中,当读到一个<>号的时候,会判断该<>中的
  内容是否符合xml中的某个规则,符合就解析;当解析完一段之后,也就是一个<>之后就不会
  往后解析,如果希望解析器往后解析需要调用api;
  调用api后,会继续往后解析,当再次解析的时候会触发元素类型事件
-----------------------------------------------------------
4.java.lang.IllegalStateException: End of document.
at org.apache.harmony.xml.ExpatPullParser$EndDocumentEvent.getNext


(ExpatPullParser.java:697)
at org.apache.harmony.xml.ExpatPullParser$Document.dequeue


(ExpatPullParser.java:813)
at org.apache.harmony.xml.ExpatPullParser.next(ExpatPullParser.java:303)
at com.credream.service.PersonService.getPersons(PersonService.java:53)
at com.credream.test.PersonServiceTest.testPersons(PersonServiceTest.java:17)
at java.lang.reflect.Method.invokeNative(Native Method)
at android.test.AndroidTestRunner.runTest(AndroidTestRunner.java:169)
at android.test.AndroidTestRunner.runTest(AndroidTestRunner.java:154)
at android.test.InstrumentationTestRunner.onStart


(InstrumentationTestRunner.java:520)
at android.app.Instrumentation$InstrumentationThread.run


(Instrumentation.java:1447)
在解析的时候出现的错误
----------------------------------------------
5.SAX是一个解析速度快并且占用内存少的xml解析器，非常适合用于Android等移动设备。 


SAX解析XML文件采用的是事件驱动，也就是说，它并不需要解析完整个文档，在按内容顺序


解析文档的过程中，SAX会判断当前读到的字符是否合法XML语法中的某部分，如果符合就会


触发事件。所谓事件，其实就是一些回调（callback）方法，这些方法(事件)定义在


ContentHandler接口。下面是一些ContentHandler接口常用的方法：
startDocument()
当遇到文档的开头的时候，调用这个方法，可以在其中做一些预处理的工作。
endDocument()
和上面的方法相对应，当文档结束的时候，调用这个方法，可以在其中做一些善后的工作。 
startElement(String namespaceURI, String localName, String qName, Attributes 


atts) 
当读到一个开始标签的时候，会触发这个方法。namespaceURI就是命名空间，localName是不


带命名空间前缀的标签名，qName是带命名空间前缀的标签名。通过atts可以得到所有的属性


名和相应的值。要注意的是SAX中一个重要的特点就是它的流式处理，当遇到一个标签的时候


，它并不会纪录下以前所碰到的标签，也就是说，在startElement()方法中，所有你所知道


的信息，就是标签的名字和属性，至于标签的嵌套结构，上层标签的名字，是否有子元属等


等其它与结构相关的信息，都是不得而知的，都需要你的程序来完成。这使得SAX在编程处理


上没有DOM来得那么方便。
endElement(String uri, String localName, String name)
这个方法和上面的方法相对应，在遇到结束标签的时候，调用这个方法。
characters(char[] ch, int start, int length) 
这个方法用来处理在XML文件中读到的内容，第一个参数为文件的字符串内容，后面两个参数


是读到的字符串在这个数组中的起始位置和长度，使用new String(ch,start,length)就可以


获取内容。
----------------------------------------------------
1.如何把应用中的数据存放到xml文件中:
  StringBuilder xml=....先把xml组成一个字符串
  xml.append(<xml>);然后将,xml写到文件中
  这种写法不够面向对象,生成文件的时候也容易出现语法问题
------------------------------------------------------------
2.用pull解析器读取,以及写入xml文件的代码:
  a.新建项目PullXml
/PullXml/src/com/credream/domain/Person.java
package com.credream.domain;


public class Person
{
private String name;
private Integer id;
private Integer age;
public String getName()
{
return name;
}
public void setName(String name)
{
this.name = name;
}
public Integer getId()
{
return id;
}
public void setId(Integer id)
{
this.id = id;
}
public Integer getAge()
{
return age;
}
public void setAge(Integer age)
{
this.age = age;
}
@Override
public String toString()
{
return "Person [age=" + age + ", id=" + id + ", name=" + name + 


"]";
}
public Person()
{
 
}
public Person(String name, Integer id, Integer age)
{


this.name = name;
this.id = id;
this.age = age;
}
 


}
--------------------------------------------------------------------
b.编写xml操作的java文件
/PullXml/src/com/credream/service/PersonService.java
package com.credream.service;


import java.io.InputStream;
import java.io.OutputStream;
import java.util.ArrayList;
import java.util.List;


import org.xmlpull.v1.XmlPullParser;
import org.xmlpull.v1.XmlSerializer;
 


import android.util.Xml;


import com.credream.domain.Person;


public class PersonService
{


public static List<Person> getPersons(InputStream xml)throws Exception{
List<Person> persons=null;
Person person=null;
//得到Pull解析器的两种方法//XmlPullParser 


pullParser=XmlPullParserFactory.newInstance().newPullParser();
XmlPullParser pullParser=Xml.newPullParser();
pullParser.setInput(xml,"UTF-8");//为pull解析器设置要解析的xml数据
int event =pullParser.getEventType();
while(event!=XmlPullParser.END_DOCUMENT){//如果没有到文档结尾
switch (event){
case XmlPullParser.START_DOCUMENT://如果是开始节点
persons=new ArrayList<Person>();
break;
case XmlPullParser.START_TAG:
if("person".equals(pullParser.getName())){
int id=new Integer(pullParser.getAttributeValue(0));
 person=new Person();
person.setId(id);
}
if("name".equals(pullParser.getName())){
String name=pullParser.nextText();//<name>李明</name>可以取得李明
person.setName(name);
}
if("age".equals(pullParser.getName())){
Integer age=new Integer(pullParser.nextText());//<name>李明</name>可以取


得李明
person.setAge(age);
}
break;

case XmlPullParser.END_TAG:
if("person".equals(pullParser.getName())){
persons.add(person);
person=null;
}  
break;
}

event=pullParser.next();
}
return persons;
}




public static List<Person> getPersonsTest(InputStream xml) throws Exception{
List<Person> persons = null;
Person person = null;
XmlPullParser pullParser = Xml.newPullParser();
pullParser.setInput(xml, "UTF-8");//为Pull解析器设置要解析的XML数据
int event = pullParser.getEventType();
while(event != XmlPullParser.END_DOCUMENT){
switch (event) {
case XmlPullParser.START_DOCUMENT:
persons = new ArrayList<Person>();
break;

case XmlPullParser.START_TAG:
if("person".equals(pullParser.getName())){
int id = new Integer


(pullParser.getAttributeValue(0));
person = new Person();
person.setId(id);
}
if("name".equals(pullParser.getName())){
String name = pullParser.nextText();
person.setName(name);
}
if("age".equals(pullParser.getName())){
int age = new Integer(pullParser.nextText());
person.setAge(age);
}
break;

case XmlPullParser.END_TAG:
if("person".equals(pullParser.getName())){
persons.add(person);
person = null;
}
break;
}
event = pullParser.next();
}
return persons;
}




public static void save(List<Person> persons,OutputStream out)throws Exception{
XmlSerializer serializer=Xml.newSerializer();//序列化
serializer.setOutput(out, "UTF-8");
serializer.startDocument("UTF-8", true);//true指定是否可以单独存在,而不依


赖其他xml文件
//<?xml version="1.0" encoding="UTF-8"?>//编码是和xml中的编码对应的
serializer.startTag(null, "persons");//第一个事命名空间


for(Person person:persons){
serializer.startTag(null, "person");
serializer.attribute(null, "id", person.getId().toString());
serializer.startTag(null,"name");
serializer.text(person.getName());
serializer.endTag(null, "name");

serializer.startTag(null, "age");
serializer.text(person.getAge().toString());
serializer.endTag(null, "age");
serializer.endTag(null, "person");
}


serializer.endTag(null, "persons");
serializer.endDocument();
out.flush();//如果用户传进的是个缓冲输入流,那么要flush下
out.close();
}


}
------------------------------------------------------------------
c.这个文件用来测试
  /PullXml/src/com/credream/test/PersonServiceTest.java
package com.credream.test;


import java.io.File;
import java.io.FileOutputStream;
import java.io.InputStream;
import java.util.ArrayList;
import java.util.List;


import com.credream.domain.Person;
import com.credream.service.PersonService;


import android.test.AndroidTestCase;
import android.util.Log;


public class PersonServiceTest extends AndroidTestCase
{
private static  final String TAG="PersonServiceTest";
public void testPersons()throws Exception{
InputStream xml=this.getClass().getClassLoader().getResourceAsStream


("person.xml");
//List<Person> persons=PersonService.getPersonsTest(xml);
List<Person> persons=PersonService.getPersons(xml);
 for(Person person :persons){
Log.i(TAG,person.toString() );
 }
}




public void testSave()throws Exception{

List<Person> persons=new ArrayList<Person>();
persons.add(new Person("lidewei",42,22));
persons.add(new Person("lisha",42,24));
persons.add(new Person("xiaoyue",42,26));
persons.add(new Person("mimi",42,2));
//<包>/files
File xmlFile=new File(getContext().getFilesDir(),"credream.xml");
  FileOutputStream outputStream =new FileOutputStream(xmlFile);
  PersonService.save(persons, outputStream);
}
}
--------------------------------------------------------------
d.带读取的xml文件/PullXml/src/person.xml
<?xml version="1.0" encoding="UTF-8"?>
<persons>
<person id="23">
<name>李明</name>
<age>30</age>
</person>
<person id="20">
<name>李向梅</name>
<age>25</age>
</person>
</persons>
----------------------------------------------
e.清单文件:/PullXml/AndroidManifest.xml
   <?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.credream.xml"
    android:versionCode="1"
    android:versionName="1.0" >


    <uses-sdk android:minSdkVersion="8" />


    <application
        android:icon="@drawable/ic_launcher"
        android:label="@string/app_name" >
        <activity
            android:label="@string/app_name"
            android:name=".PullXmlActivity" >
            <intent-filter >
                <action android:name="android.intent.action.MAIN" />


                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    <uses-library android:name="android.test.runner" />
        </application>
        <instrumentation android:name="android.test.InstrumentationTestRunner"
  android:targetPackage="com.credream.xml" android:label="Tests for My App" />


</manifest>
------------------------------------------------------------------