1 XML资源文件简介
android程序自带的xml文件一般放在values/xml/xml_name.xml处,这里需要使用new->file创建一个新的xml文件。xml文件的版本代码如下:
<?xml version="1.0" encoding="utf-8"?>
java代码中引用:R.xml.xml_name来表示xml资源文件,获取xml属性方法如下:
//获取一个解析器对象,返回的是一个XmlResourceParser对象
Resources.getXml(int resid );
//获取xml文档对应的输入流,返回的是一个InputStream对象
Resources.openRawResource(int resid);
有很多解析xml的方式,同时Android官方推荐使用Pull解析技术。虽然Pull解析技术是第三方开发的开源技术。但PULL解析器非常适合在Android移动设备中使用,在Android系统内部在解析各种XML时也是用PULL解析器。那么为什么会使用PULL解析适合Android设备呢?
- 于Android的移动设备而言,因为设备资源有限,所以我们需要选择适合的技术来解析XML,这样有利于提高访问的速度。
- XML PULL解析并未像SAX解析那样监听元素的结束,而是在开始就完成了大部分的处理。这有利于提早读取XML文件,可以极大的减少解析时间,这种优化对于连接速度较慢的移动设备而言尤为重要。对于XML文档较大但只需要文档的一部分时,XML Pull解析器则是更为有效的方法。
2 Pull解析基础
PULL 的工作原理:
- XML pull提供了开始元素和结束元素。
- 当某个元素开始时,可以调用parser.nextText从XML文档中提取所有字符数据。
- 当解析到一个文档结束时,自动生成EndDocument事件。
常用的XML pull的接口和类:
- XmlPullParser:该解析器是一个在org.xmlpull.v1中定义的解析功能的接口。
- XmlSerializer:它是一个接口,定义了XML信息集的序列。
- XmlPullParserFactory:这个类用于在XMPULL V1 API中创建XML Pull解析器。
- XmlPullParserException:抛出单一的XML pull解析器相关的错误。
@4 PULL解析与SAX解析模式的区别
PULL解析器的运行方式和SAX类似,都是基于事件模式。不同的是,在PULL解析过程中返回的是数字,且我们需要自己获取产生的事件然后做相应的操作,而不像SAX那样由处理器触发一种事件的方法。
@5 执行我们的代码会判断以下几个标签:
- 读取到xml的声明返回START_DOCUMENT。
- 结束返回 END_DOCUMENT。
- 开始标签返回 START_TAG。
- 结束标签返回 END_TAG; 文本返回 TEXT。
3 PULL解析实例
在asset定义了books.xml文件,只要是一份格式良好的xml文档即可,具体内容根据需要定义。
- 读取XML:从定义好的books.xml文件解析并显示出来;
- 写入XML:将解析后的内容再写入到本地,这里也保存为名字为books.xml的文件。
@1 books.xml定义如下:
<?xml version="1.0" encoding="utf-8"?>
<books>
<book>
<id>1001</id>
<name>Thinking In Java</name>
<price>80.00</price>
</book>
<book>
<id>1002</id>
<name>Hello, Java</name>
<price>95.00</price>
</book>
<book>
<id>1003</id>
<name>Hello, Android</name>
<price>100.00</price>
</book>
</books>
@2 book 基础类的定义:
public class Book {
private int id;
private String name;
private float price;
public int getId() {
return id;
}
public void setId(int id) {
this.id = id;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public float getPrice() {
return price;
}
public void setPrice(float price) {
this.price = price;
}
@Override
public String toString() {
return "id:" + id + "\nname:" + name + "\nprice:" + price + "\n";
}
}
@3 BookParser解析器接口的定义:
public interface BookParser {
//解析输入流 得到Book对象集合
public List<Book> parse(InputStream is) throws Exception;
//序列化Book对象集合 得到XML形式的字符串
public String serialize(List<Book> books) throws Exception;
}
@4 解析器的定义:
public class PULLBookParser implements BookParser {
@Override
public List<Book> parse(InputStream is) throws Exception {
List<Book> booksList = null;
Book book = null;
// 由android.util.Xml创建一个XmlPullParser实例
XmlPullParser parser = Xml.newPullParser();
// 设置输入流 并指明编码方式
parser.setInput(is, "UTF-8");
// 产生第一个事件
int eventType = parser.getEventType();
while (eventType != XmlPullParser.END_DOCUMENT) {
switch (eventType) {
// 判断当前事件是否为文档开始事件
case XmlPullParser.START_DOCUMENT:
booksList = new ArrayList<Book>(); // 初始化books集合
break;
// 判断当前事件是否为标签元素开始事件
case XmlPullParser.START_TAG:
if (parser.getName().equals("book")) { // 判断开始标签元素是否是book
book = new Book();
} else if (parser.getName().equals("id")) {
eventType = parser.next();
// 得到book标签的属性值,并设置book的id
book.setId(Integer.parseInt(parser.getText()));
} else if (parser.getName().equals("name")) { // 判断开始标签元素是否是book
eventType = parser.next();
book.setName(parser.getText());
} else if (parser.getName().equals("price")) { // 判断开始标签元素是否是price
eventType = parser.next();
book.setPrice(Float.parseFloat(parser.getText()));
}
break;
// 判断当前事件是否为标签元素结束事件
case XmlPullParser.END_TAG:
if (parser.getName().equals("book")) { // 判断结束标签元素是否是book
booksList.add(book); // 将book添加到books集合
book = null;
}
break;
}
// 进入下一个元素并触发相应事件
eventType = parser.next();
}
return booksList;
}
@Override
public String serialize(List<Book> books) throws Exception {
// 由android.util.Xml创建一个XmlSerializer实例
XmlSerializer serializer = Xml.newSerializer();
StringWriter writer = new StringWriter();
// 设置输出方向为writer
serializer.setOutput(writer);
serializer.startDocument("UTF-8", true);
serializer.startTag("", "books");
for (Book book : books) {
serializer.startTag("", "book");
serializer.attribute("", "id", book.getId() + "");
serializer.startTag("", "name");
serializer.text(book.getName());
serializer.endTag("", "name");
serializer.startTag("", "price");
serializer.text(book.getPrice() + "");
serializer.endTag("", "price");
serializer.endTag("", "book");
}
serializer.endTag("", "books");
serializer.endDocument();
return writer.toString();
}
}
@5 界面UI布局与程序实现
PULLParserActivity的实现,代码如下所示:
public class PULLParserActivity extends Activity {
private static final String TAG = "PULLParserActivity";
private TextView textView = null;
private Button readBtn = null;
private Button writeBtn = null;
private BookParser parser;
private List<Book> booksList;
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.main);
textView = (TextView) findViewById(R.id.txt);
readBtn = (Button) findViewById(R.id.read_btn);
writeBtn = (Button) findViewById(R.id.write_btn);
readBtn.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
try {
InputStream is = getAssets().open("books.xml");
parser = new PULLBookParser();
booksList = parser.parse(is);
for (Book book : booksList) {
Log.i(TAG, book.toString());
}
for (Book book : booksList) {
textView.setText(textView.getText() + book.toString());
}
} catch (Exception e) {
Log.e(TAG, e.getMessage());
}
}
});
writeBtn.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
try {
String xmlString = parser.serialize(booksList); // 序列化
FileOutputStream fos = openFileOutput("books.xml",
Context.MODE_PRIVATE);
fos.write(xmlString.getBytes("UTF-8"));
} catch (Exception e) {
Log.e(TAG, e.getMessage());
}
}
});
}
}
主界面main.xml布局文件 配置如下所示:
<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
>
<TextView
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:id="@+id/txt"
/>
<RelativeLayout
android:layout_width="match_parent"
android:layout_height="60dp"
android:layout_below="@id/txt"
>
<Button
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="read_btn"
android:id="@+id/read_btn"
android:layout_alignParentLeft="true"
android:layout_gravity="center_horizontal" />
<Button
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_alignParentRight="true"
android:text="write_btn"
android:id="@+id/write_btn" />
</RelativeLayout>
</RelativeLayout>
4 其他XML解析方式简介
@1 DOM生成和解析XML文档(基本解析方式)
为XML文档的已解析版本定义了一组接口。解析器读入整个文档,然后构建一个驻留内存的树结构,然后代码就可以使用 DOM 接口来操作这个树结构。
- 优点:整个文档树在内存中,便于操作;支持删除、修改、重新排列等多种功能。
- 缺点:将整个文档调入内存(包括无用的节点),浪费时间和空间。
- 使用场合:一旦解析了文档还需多次访问这些数据;需要硬件资源充足(内存、CPU)。
@2 SAX生成和解析XML文档(基本解析方式)
为解决DOM的问题,出现了SAX。SAX解析是事件驱动。当解析器发现元素开始、元素结束、文本、文档的开始或结束等时,发送事件,程序员编写响应这些事件的代码,保存数据。
- 优点:不用事先调入整个文档,占用资源少;SAX解析器代码比DOM解析器代码小,适于Applet,下载。
- 缺点:不持久,事件过后,若没保存数据,那么数据就丢了;无状态性,从事件中只能得到文本,但不知该文本属于哪个元素。
- 使用场合:Applet,只需XML文档的少量内容,很少回头访问;机器内存少,对于有限的Android内存SAX解析更有效,且Android提供了一种传统的SAX使用方法以及一个便捷的SAX包装器。使用Android.util.Xml类,会比使用SAX来得简单。
@3 关于DOM4J和JDOM
DOM和SAX都是java的标准,也就是java本身就提供标准的API,不需要下载其他包,但是它的API都是一些底层的实现,不是很好用。所以有人在它们的基础上封装了一下,就有了DOM4j和JDOM。也就是说,DOM4J 和JDOM 都包含了前面两种方式DOM和SAX,DOM4J性能最好。