iOS 详解NSXMLParser方法解析XML数据方法

时间:2022-07-30 15:16:58

前一篇文章已经介绍了如何通过URL从网络上获取xml数据。下面介绍如何将获取到的数据进行解析。

下面先看看xml的数据格式吧!

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <Books>
  3. <Book id="1">
  4. <title>Circumference</title>
  5. <author>Nicholas Nicastro</author>
  6. <summary>Eratosthenes and the Ancient</summary>
  7. </Book>
  8. <Book id="2">
  9. <title>Copernicus Secret</title>
  10. <author>Jack Repcheck</author>
  11. <summary>How the scientific revolution began</summary>
  12. </Book>
  13. <Book id="3">
  14. <title>Angels and Demons</title>
  15. <author>Dan Brown</author>
  16. <summary>Robert Langdon is summoned to a Swiss</summary>
  17. </Book>
  18. </Books>

显然在这个xml中包括三本书的一些基本数据:id   title   author   summary  解析的过程就是将这些数据提取出来。

先简单介绍一下xml数据解析吧。xml数据的解析一般有两种方式:SAX(Simple API for XML)和DOM (Document Object Model),事件和文档。

dom实现的原理是把整个xml文档一次性读出,放在一个树型结构里。在需要的时候,查找特定节点,然后对节点进行读或写。他的主要优势是实现简单,读写平衡;缺点是比较占内存,因为他要把整个xml文档都读入内存,文件越大,这种缺点就越明显。
 

sax的实现方法和dom不同。他只在xml文档中查找特定条件的内容,并且只提取需要的内容。这样做占用内存小,灵活。

NSXMLParser 实现的是sax方法解析xml文件。

下面进入主题介绍如何对xml进行解析:

一、将上面的xml数据保存为Books.xml作为本地xml数据,并导入项目中。

二、由于book中含有几个属性,所以这里第一个book类。

Book.h文件:

  1. #import <Foundation/Foundation.h>
  2. @interface Book : NSObject
  3. @property (nonatomic, readwrite) NSInteger bookID;
  4. @property (nonatomic, retain) NSString  *title;
  5. @property (nonatomic, retain) NSString  *author;
  6. @property (nonatomic, retain) NSString  *summary;
  7. @end

Book.m文件

  1. #import "Book.h"
  2. @implementation Book
  3. @synthesize bookID;
  4. @synthesize title;
  5. @synthesize author;
  6. @synthesize summary;
  7. @end

三、要实现对xml数据的解析实际上是通过实现NSXMLParserDelegate委托中的几个方法。

  1. #pragma mark xmlparser
  2. //step 1 :准备解析
  3. - (void)parserDidStartDocument:(NSXMLParser *)parser
  4. {
  5. }
  6. //step 2:准备解析节点
  7. - (void)parser:(NSXMLParser *)parser didStartElement:(NSString *)elementName namespaceURI:(NSString *)namespaceURI qualifiedName:(NSString *)qName attributes:(NSDictionary *)attributeDict
  8. {
  9. }
  10. //step 3:获取首尾节点间内容
  11. - (void)parser:(NSXMLParser *)parser foundCharacters:(NSString *)string
  12. {
  13. }
  14. //step 4 :解析完当前节点
  15. - (void)parser:(NSXMLParser *)parser didEndElement:(NSString *)elementName namespaceURI:(NSString *)namespaceURI qualifiedName:(NSString *)qName
  16. {
  17. }
  18. //step 5:解析结束
  19. - (void)parserDidEndDocument:(NSXMLParser *)parser
  20. {
  21. }
  22. //step 6:获取cdata块数据
  23. - (void)parser:(NSXMLParser *)parser foundCDATA:(NSData *)CDATABlock
  24. {
  25. }

在实现xml解析过程以上方法中的step3 、4、5是必须的,而step1、5可选。

下面分别介绍:

Step 1: 在开始解析之前的一些准备工作,例如初始化一些存储变量。在我的这个例子中,使用了一个Book实例变量来存储一本书(也即是一组信息),一个可变数组来存储这三本书(即每一组信息都当成这个数组中的一个元素),(此次要注意理解数据变量之间的关系),其他变量就暂不介绍啦(待会看源代码就可以了)。

Step 2: 当解析器遇到xml的根标签和一组信息的开始标签时就开始调用这个方法,在这个xml文件中,遇到Books(xml文件的根标签),Book(一组信息的开始标签)时就会调用这个方法。那么也就可以知道这个方法在程序运行过程中被调用了多次。那么就可以用 if 语句判断遇到的是Books还是Book,然后做一些相应的操作(具体的话待会看源代码)。

  1. - (void)parser:(NSXMLParser *)parser didStartElement:(NSString *)elementName namespaceURI:(NSString *)namespaceURI qualifiedName:(NSString *)qName attributes:(NSDictionary *)attributeDict
  2. {
  3. }

注意其中的参数:elementName表示遇到的标签,在这个程序中会遇到的是Books和Book;  解析到一个标签时,开始的 标签可能会有一些属性,例如在这里<Book id="1">

那么id就是属性啦,在这个方法中他是用一个字典来保存的即(NSDictionary *)attributeDict,那么对这个字典操作就可以得到你要的value和key啦。

Step 3:当解析器找到开始标签和结束标签之间的字符时,就调用这个方法,读取其中的内容。 注意:这里读取到的string在这个函数里面我们并不知道是那个属性的内容,意思就是假如string的内容是Circumference(Book 的title),但是我们不知道这个是title的内容;那么在哪里才知道,然后对它进行存储操作呢,不要着急,就是Step4啦!

Step 4:当解析器读到结束标签时,就会调用这个方法。例如读到Books,Book,title等。那么对读到的标签进行判断后就可以进行存储操作啦!

  1. - (void)parser:(NSXMLParser *)parser didEndElement:(NSString *)elementName namespaceURI:(NSString *)namespaceURI qualifiedName:(NSString *)qName
  2. {
  3. }

这里标签参数就是elementName。

Step 5:对整个xml文件解析结束后的一些操作。

Step 6:这个暂不解释(我还没有用到)。

四、下面就是上代码的时候啦

.h文件

  1. #import <UIKit/UIKit.h>
  2. @class AppDelegate,Book;
  3. @interface ViewController : UIViewController <NSXMLParserDelegate> {
  4. NSMutableString *currentElementValue;  //用于存储元素标签的值
  5. NSMutableArray *books;  //用于存储一组书籍
  6. Book *aBook;  //书籍实例,代表一本书
  7. BOOL storingFlag; //查询标签所对应的元素是否存在
  8. NSArray *elementToParse;  //要存储的元素
  9. }
  10. - (IBAction)xmlButton:(id)sender;
  11. @end

说明:这里我用一个按键来触发xml解析。

.m文件

    1. #import "ViewController.h"
    2. #import "AppDelegate.h"
    3. @interface ViewController ()
    4. @end
    5. @implementation ViewController
    6. - (void)viewDidLoad
    7. {
    8. [super viewDidLoad];
    9. // Do any additional setup after loading the view, typically from a nib.
    10. //初始化要解析的元素标签
    11. elementToParse = [[NSArray alloc] initWithObjects:@"title",@"author",@"summary", nil];
    12. }
    13. - (void)didReceiveMemoryWarning
    14. {
    15. [super didReceiveMemoryWarning];
    16. // Dispose of any resources that can be recreated.
    17. }
    18. - (void) parser:(NSXMLParser *)parser didStartElement:(NSString *)elementName namespaceURI:(NSString *)namespaceURI qualifiedName:(NSString *)qName attributes:(NSDictionary *)attributeDict {
    19. if([elementName isEqualToString:@"Books"]) {
    20. //Initialize the array.
    21. //在这里初始化用于存储最终解析结果的数组变量,我们是在当遇到Books根元素时才开始初始化
    22. books = [[NSMutableArray alloc] init];
    23. }
    24. else if([elementName isEqualToString:@"Book"]) {
    25. //Initialize the book.
    26. //当碰到Book元素时,初始化用于存储Book信息的实例对象aBook
    27. aBook = [[Book alloc] init];
    28. //Extract the attribute here.
    29. //从attributeDict字典中读取Book元素的属性
    30. aBook.bookID = [[attributeDict objectForKey:@"id"] integerValue];
    31. NSLog(@"ID:%i", aBook.bookID);
    32. }
    33. storingFlag = [elementToParse containsObject:elementName];  //判断是否存在要存储的对象
    34. }
    35. - (void) parser:(NSXMLParser *)parser foundCharacters:(NSString *)string {
    36. // 当用于存储当前元素的值是空时,则先用值进行初始化赋值
    37. // 否则就直接追加信息
    38. if (storingFlag) {
    39. if (!currentElementValue) {
    40. currentElementValue = [[NSMutableString alloc] initWithString:string];
    41. }
    42. else {
    43. [currentElementValue appendString:string];
    44. }
    45. }
    46. }
    47. // 这里才是真正完成整个解析并保存数据的最终结果的地方
    48. - (void) parser:(NSXMLParser *)parser didEndElement:(NSString *)elementName namespaceURI:(NSString *)namespaceURI qualifiedName:(NSString *)qName {
    49. if ([elementName isEqualToString:@"Book"]) {
    50. [books addObject:aBook];
    51. aBook = nil;
    52. }
    53. if (storingFlag) {
    54. //去掉字符串的空格
    55. NSString *trimmedString = [currentElementValue stringByTrimmingCharactersInSet:[NSCharacterSet whitespaceAndNewlineCharacterSet]];
    56. //将字符串置空
    57. [currentElementValue setString:@""];
    58. if ([elementName isEqualToString:@"title"]) {
    59. aBook.title = trimmedString;
    60. NSLog(@"title :%@",aBook.title);
    61. }
    62. if ([elementName isEqualToString:@"author"]) {
    63. aBook.author = trimmedString;
    64. NSLog(@"author :%@",aBook.author);
    65. }
    66. if ([elementName isEqualToString:@"summary"]) {
    67. aBook.summary = trimmedString;
    68. NSLog(@"summary :%@",aBook.summary);
    69. }
    70. }
    71. }
    72. - (IBAction)xmlButton:(id)sender {
    73. //打开xml文件,读取数据到NSData
    74. NSString *path = [[NSBundle mainBundle] pathForResource:@"Books" ofType:@"xml"];
    75. NSFileHandle *file = [NSFileHandle fileHandleForReadingAtPath:path];
    76. NSData *data = [file readDataToEndOfFile];
    77. [file closeFile];
    78. //测试从xml接受到的数据
    79. NSString *dataString = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];
    80. NSLog(@"%@",dataString);
    81. NSXMLParser *m_parser = [[NSXMLParser alloc] initWithData:data];
    82. //设置该类本身为代理类,即该类在声明时要实现NSXMLParserDelegate委托协议
    83. [m_parser setDelegate:self];  //设置代理为本地
    84. BOOL flag = [m_parser parse]; //开始解析
    85. if(flag) {
    86. NSLog(@"解析指定路径的xml文件成功");
    87. }
    88. else {
    89. NSLog(@"解析指定路径的xml文件失败");
    90. }
    91. }
    92. @end