後端開發按某種約定好的格式存數據,前端按同樣的格式取數據——這就是解析。要牢記的是,這種格式由後端決定,我們無權更改。解析的本質,就是按照約定好的格式把想要的數據取出來的過程。
當今最流行的兩種數據格式是 XML 和 JSON。
SAX 解析:基於事件回調的解析機制,在 iOS 上就是使用 NSXMLParser 配合協議與代理。它逐行讀入、逐行解析,一次只在內存中保留一行數據,因此內存佔用很小,非常適合大數據量的場景。
DOM 解析:一次性把整個內容讀入內存並構建成樹形結構,再逐層遍歷。使用起來直觀,但內存開銷大,更適合小數據量的場景。iOS 上常用 Google 開源的 GDataXMLNode。
下面是一個把兩種 XML 解析方式和多種 JSON 解析方式集中到一起的演示控制器,用按鈕切換不同解析路徑。
// FInterPreterVC.m
// FInterpreter
//
// Created by lanouhn on 14-9-11.
// Copyright (c) 2014年 vaercly@163.com 陳聰雷. All rights reserved.
#import "FInterPreterVC.h"
#import "Person.h"
#import "GDataXMLNode.h"
#import "JSONKit.h"
@interface FInterPreterVC () <NSXMLParserDelegate>
@property (nonatomic, retain) NSMutableArray *arr; // 存儲 Person 對象
@property (nonatomic, retain) Person *per; // 存儲單條信息
@property (nonatomic, retain) NSString *str; // 存儲讀到的字符串
@end
@implementation FInterPreterVC
- (id)initWithNibName:(NSString *)nibNameOrNil bundle:(NSBundle *)nibBundleOrNil {
self = [super initWithNibName:nibNameOrNil bundle:nibBundleOrNil];
if (self) {
// Custom initialization
}
return self;
}
- (void)viewDidLoad {
[super viewDidLoad];
self.view.backgroundColor = [UIColor whiteColor];
UILabel *XMLLabel = [[UILabel alloc] initWithFrame:CGRectMake(110, 30, 100, 30)];
XMLLabel.text = @"XML解析";
XMLLabel.textAlignment = NSTextAlignmentCenter;
[self.view addSubview:XMLLabel];
[XMLLabel release];
UILabel *JSONLabel = [[UILabel alloc] initWithFrame:CGRectMake(110, 200, 100, 30)];
JSONLabel.text = @"JSON解析";
JSONLabel.textAlignment = NSTextAlignmentCenter;
[self.view addSubview:JSONLabel];
[JSONLabel release];
NSArray *titles = @[@"SAX解析", @"Dom解析第一種方式", @"Dom解析第二種方式", @"系統解析",
@"字符串解析", @"數組解析", @"字典解析", @"Data解析"];
NSArray *methods = @[@"handleSAX:", @"handleDomBtn1:", @"handleDomBtn2:", @"handleSystemJSON:",
@"handleStrBtn:", @"handleArrBtn:", @"handleDicBtn:", @"handleDataBtn:"];
CGFloat height = 70;
for (int i = 0; i < 8; i++) {
UIButton *btn = [UIButton buttonWithType:UIButtonTypeSystem];
btn.frame = CGRectMake(60, height, 200, 30);
btn.backgroundColor = [UIColor greenColor];
[btn setTitle:titles[i] forState:UIControlStateNormal];
SEL selector = NSSelectorFromString(methods[i]);
[btn addTarget:self action:selector forControlEvents:UIControlEventTouchUpInside];
[self.view addSubview:btn];
if (i == 2) {
height = 200;
}
height += 40;
}
UILabel *text = [[UILabel alloc] initWithFrame:CGRectMake(110, 470, 100, 30)];
text.text = @"加油!";
text.textAlignment = NSTextAlignmentCenter;
[self.view addSubview:text];
[text release];
}
- (void)handleSAX:(UIButton *)btn {
// 1. 獲取待解析文件的路徑
NSString *xmlPath = [[NSBundle mainBundle] pathForResource:@"Person" ofType:@"xml"];
// 2. 根據路徑初始化 NSData
NSData *data = [NSData dataWithContentsOfFile:xmlPath];
// 3. 創建解析工具對象
NSXMLParser *parser = [[NSXMLParser alloc] initWithData:data];
// 4. 設置代理
parser.delegate = self;
// 5. 開始解析
[parser parse];
}
數據有兩種常見存法:寫在開始標簽的屬性裡,或者寫在開始與結束標簽之間。下面演示的是前者。
#pragma mark - NSXMLParserDelegate
// 讀到開始標簽時觸發
- (void)parser:(NSXMLParser *)parser didStartElement:(NSString *)elementName
namespaceURI:(NSString *)namespaceURI
qualifiedName:(NSString *)qName
attributes:(NSDictionary *)attributeDict {
NSLog(@"start %@", attributeDict);
if ([elementName isEqualToString:@"Persons"]) {
self.arr = [NSMutableArray array]; // 數組闢空間
} else if ([elementName isEqualToString:@"person"]) {
self.per = [[[Person alloc] init] autorelease];
[self.arr addObject:self.per];
} else if ([elementName isEqualToString:@"name"]) {
self.per.name = attributeDict[@"name"];
} else if ([elementName isEqualToString:@"gender"]) {
self.per.gender = attributeDict[@"gender"];
} else if ([elementName isEqualToString:@"age"]) {
self.per.age = attributeDict[@"age"];
} else if ([elementName isEqualToString:@"phoneNumber"]) {
self.per.phoneNumber = attributeDict[@"phoneNumber"];
} else if ([elementName isEqualToString:@"imageName"]) {
self.per.imageName = attributeDict[@"imageName"];
}
}
// 讀到標簽之間的文本內容時觸發
- (void)parser:(NSXMLParser *)parser foundCharacters:(NSString *)string {
self.str = string;
}
// 讀到結束標簽時觸發
- (void)parser:(NSXMLParser *)parser didEndElement:(NSString *)elementName
namespaceURI:(NSString *)namespaceURI
qualifiedName:(NSString *)qName {
NSLog(@"end %@", elementName);
if ([elementName isEqualToString:@"name"]) {
self.per.name = self.str;
} else if ([elementName isEqualToString:@"gender"]) {
self.per.gender = self.str;
} else if ([elementName isEqualToString:@"age"]) {
self.per.age = self.str;
} else if ([elementName isEqualToString:@"phoneNumber"]) {
self.per.phoneNumber = self.str;
} else if ([elementName isEqualToString:@"imageName"]) {
self.per.imageName = self.str;
}
}
// 解析結束
- (void)parserDidEndDocument:(NSXMLParser *)parser {
NSLog(@"game over");
NSLog(@"%@", self.arr);
}
GDataXMLNode 的解析速度據說比 NSXMLParser 快十倍以上。使用前需要三步准備:
libxml2.2.dylib;/usr/include/libxml2;-lxml2。
- (void)handleDomBtn1:(UIButton *)btn {
// 1. 獲取文件路徑
NSString *xmlPath = [[NSBundle mainBundle] pathForResource:@"Person" ofType:@"xml"];
// 2. 讀入 XML 字符串
NSString *xmlStr = [NSString stringWithContentsOfFile:xmlPath
encoding:NSUTF8StringEncoding
error:nil];
// 3. 初始化文檔對象,後續解析都從它取值
GDataXMLDocument *document = [[GDataXMLDocument alloc] initWithXMLString:xmlStr
options:0
error:nil];
// 4. 獲取根節點
GDataXMLElement *rootElement = [document rootElement];
// 5. 獲取根節點下所有 person 子節點
NSArray *personElements = [rootElement elementsForName:@"person"];
// 6. 遍歷每個 person 節點
for (GDataXMLElement *element in personElements) {
GDataXMLElement *nameElement = [[element elementsForName:@"name"] firstObject];
GDataXMLElement *genderElement = [[element elementsForName:@"gender"] firstObject];
GDataXMLElement *ageElement = [[element elementsForName:@"age"] firstObject];
GDataXMLElement *imageNameElement = [[element elementsForName:@"imageName"] firstObject];
GDataXMLElement *phoneNumberElement = [[element elementsForName:@"phoneNumber"] firstObject];
// 讀法一:取開始與結束標簽之間的值
// NSString *name = [nameElement stringValue];
// 讀法二:取標簽屬性中存儲的數據,屬性對應的類是 GDataXMLNode
GDataXMLNode *nameNode = [nameElement attributeForName:@"name"];
GDataXMLNode *genderNode = [genderElement attributeForName:@"gender"];
GDataXMLNode *ageNode = [ageElement attributeForName:@"age"];
GDataXMLNode *imageNameNode = [imageNameElement attributeForName:@"imageName"];
GDataXMLNode *phoneNumberNode = [phoneNumberElement attributeForName:@"phoneNumber"];
NSString *name = [nameNode stringValue];
NSString *gender = [genderNode stringValue];
NSString *age = [ageNode stringValue];
NSString *phoneNumber = [phoneNumberNode stringValue];
NSString *imageName = [imageNameNode stringValue];
NSLog(@"%@ %@ %@ %@ %@", name, gender, age, phoneNumber, imageName);
}
}
XPath 的好處是只要給出相對路徑即可,比如 //name,只要能到達 name 節點就能把它取回來。
- (void)handleDomBtn2:(UIButton *)btn {
NSString *xmlPath = [[NSBundle mainBundle] pathForResource:@"Person" ofType:@"xml"];
NSString *xmlStr = [NSString stringWithContentsOfFile:xmlPath
encoding:NSUTF8StringEncoding
error:nil];
GDataXMLDocument *document = [[GDataXMLDocument alloc] initWithXMLString:xmlStr
options:0
error:nil];
// 一次性取出各類節點
NSArray *nameElements = [document nodesForXPath:@"//name" error:nil];
NSArray *genderElements = [document nodesForXPath:@"//gender" error:nil];
NSArray *ageElements = [document nodesForXPath:@"//age" error:nil];
NSArray *imageNameElements = [document nodesForXPath:@"//imageName" error:nil];
NSArray *phoneNumberElements = [document nodesForXPath:@"//phoneNumber" error:nil];
for (int i = 0; i < 3; i++) {
GDataXMLElement *nameElement = nameElements[i];
GDataXMLElement *genderElement = genderElements[i];
GDataXMLElement *ageElement = ageElements[i];
GDataXMLElement *imageNameElement = imageNameElements[i];
GDataXMLElement *phoneNumberElement = phoneNumberElements[i];
NSLog(@"-------%@ %@ %@ %@ %@",
[nameElement stringValue],
[genderElement stringValue],
[ageElement stringValue],
[imageNameElement stringValue],
[phoneNumberElement stringValue]);
}
}
- (void)handleSystemJSON:(UIButton *)btn {
NSString *filePath = [[NSBundle mainBundle] pathForResource:@"Student" ofType:@"json"];
NSData *data = [NSData dataWithContentsOfFile:filePath];
NSMutableArray *arr = [NSJSONSerialization JSONObjectWithData:data
options:NSJSONReadingMutableContainers
error:nil];
NSLog(@"%@", arr);
}
JSONKit 的做法是給 NSString、NSData 添加分類,在分類裡提供解析方法,效率僅次於系統原生方案。它能把 JSON 數據解析成 NSArray、NSDictionary;反過來,給 NSArray、NSDictionary 添加的分類方法則能把 OC 對象轉成 JSON 字符串。
// 從字符串解析
- (void)handleStrBtn:(UIButton *)btn {
NSString *filePath = [[NSBundle mainBundle] pathForResource:@"Student" ofType:@"json"];
NSString *jsonStr = [NSString stringWithContentsOfFile:filePath
encoding:NSUTF8StringEncoding
error:nil];
NSArray *arr = [jsonStr objectFromJSONString];
NSLog(@"%@", arr);
}
// 數組與 JSON 字符串互轉
- (void)handleArrBtn:(UIButton *)btn {
NSArray *arr = @[@1, @"bb", @"cc", @"dd", @"ee"];
NSString *jsonStr = [arr JSONString];
NSLog(@"%@", jsonStr);
NSString *str = [jsonStr objectFromJSONString];
NSLog(@"%@", str);
}
// 字典與 JSON 字符串互轉
- (void)handleDicBtn:(UIButton *)btn {
NSDictionary *dic = @{@"name": @1, @"gender": @"man", @"age": @"18"};
NSString *jsonStr = [dic JSONString];
NSLog(@"%@", jsonStr);
NSString *str = [jsonStr objectFromJSONString];
NSLog(@"%@", str);
}
// 直接從 NSData 解析
- (void)handleDataBtn:(UIButton *)btn {
NSString *filePath = [[NSBundle mainBundle] pathForResource:@"Student" ofType:@"json"];
NSData *jsonData = [NSData dataWithContentsOfFile:filePath];
NSArray *arr = [jsonData objectFromJSONData];
NSLog(@"%@", arr);
}
- (void)didReceiveMemoryWarning {
[super didReceiveMemoryWarning];
// Dispose of any resources that can be recreated.
}
- (void)dealloc {
self.arr = nil;
self.per = nil;
self.str = nil;
[super dealloc];
}
@end
XML 場景下,數據量大就用 SAX,結構複雜、需要隨機訪問節點就用 DOM。JSON 場景下,新項目直接上系統原生的 NSJSONSerialization 即可,沒有必要再引入第三方庫;只有維護老項目時,才會接觸到 JSONKit 這類歷史方案。
需要提醒的是,上面這份代碼寫於 MRC 時代,retain、release、autorelease 都需要手動管理。在今天的 ARC 環境下,這些內存管理調用都可以刪去。