iOS 提供了原生的 XML 解析能力,核心類是 NSXMLParser。它採用 SAX 式的流解析模型——不一次性構建整棵文檔樹,而是逐個事件向上回調,因此內存佔用低,適合處理大文件。
先準備一個測試用的 XML 文件:New → File → Other → Empty,在 Save As 裡隨便起個名字,後綴為 .xml。內容如下:
<person>
<student>
<pid>1001</pid>
<name>小明</name>
<sex>男</sex>
<age>12</age>
</student>
</person>
把這個文件拖進工程,記得勾選相應的 target,否則運行時讀不到。
#import "ViewController.h"
@interface ViewController () <NSXMLParserDelegate>
@end
@implementation ViewController
- (void)viewDidLoad {
[super viewDidLoad];
[self analysis];
}
#pragma mark - 開始解析
- (void)analysis {
// 從 bundle 中取出文件路徑
NSString *filename = [[NSBundle mainBundle] pathForResource:@"File.xml" ofType:nil];
NSData *data = [[NSData alloc] initWithContentsOfFile:filename];
NSXMLParser *parser = [[NSXMLParser alloc] initWithData:data];
parser.delegate = self;
// 必須調用 parse 才會真正開始,返回值表示是否成功啟動
[parser parse];
}
#pragma mark - NSXMLParserDelegate 回調
// 文檔開始,只觸發一次
- (void)parserDidStartDocument:(NSXMLParser *)parser {
NSLog(@"parserDidStartDocument");
}
// 解析出錯
- (void)parser:(NSXMLParser *)parser parseErrorOccurred:(NSError *)parseError {
if (parseError) {
NSLog(@"parseError: %@", parseError);
}
}
// 遇到文本內容
// 注意:這個方法可能被多次調用,同一段文本會被切開分幾次回傳,
// 實際取值時需要用 NSMutableString 拼接
- (void)parser:(NSXMLParser *)parser foundCharacters:(NSString *)string {
NSLog(@"foundCharacters ----- %@", string);
}
// 遇到開始標簽
- (void)parser:(NSXMLParser *)parser
didStartElement:(NSString *)elementName
namespaceURI:(NSString *)namespaceURI
qualifiedName:(NSString *)qName
attributes:(NSDictionary<NSString *, NSString *> *)attributeDict {
NSLog(@"didStartElement ----- %@, attributes: %@", elementName, attributeDict);
}
// 遇到結束標簽
- (void)parser:(NSXMLParser *)parser
didEndElement:(NSString *)elementName
namespaceURI:(NSString *)namespaceURI
qualifiedName:(NSString *)qName {
NSLog(@"didEndElement ----- %@", elementName);
}
// 文檔結束
- (void)parserDidEndDocument:(NSXMLParser *)parser {
NSLog(@"parserDidEndDocument");
}
@end
1. foundCharacters: 會被多次調用。這是最容易踩的坑。同一段文本,系統可能拆成好幾次回傳(尤其是在文本節點比較長、或夾雜實體引用的時候)。所以千萬不要指望一次回調就能拿到完整內容,正確做法是在 didStartElement: 時初始化一個 NSMutableString,在 foundCharacters: 裡 append,在 didEndElement: 時取值並清空。
2. 事件順序是嚴格配對的。didStartElement 和 didEndElement 一定成對出現,利用這一點可以維護一個棧來跟蹤當前解析到的層級。
3. attributes 字典在開始標簽回調中提供。如果 XML 用的是屬性而非子節點存數據,直接從這個字典取即可,不必進入下一層。
4. 別忘了錯誤處理。parseErrorOccurred: 一定要實現。XML 格式稍有瑕疵(標簽未閉合、特殊字符未轉義)就會解析失敗,有了這個回調才能定位問題。
5. 解析前先確認文件存在。如果 pathForResource:ofType: 返回 nil,後續 dataWithContentsOfFile: 會拿到空數據,解析自然失敗。這也是「代碼看起來沒問題但就是不出結果」的常見原因。