在做 DOM 式的 XML 解析時,最常翻到的就是 NSXMLDocument 這幾個方法。以下依官方文件的定義整理,並附上中文說明與實務提醒。
定義:回傳接收者中,名稱符合指定條件的子元素節點,型別為 NSXMLElement 物件陣列。
- (NSArray *)elementsForName:(NSString *)name;
參數
elementsForLocalName:URI:,並把 URI 參數設為該 prefix 所對應的 URI。否則,比對方式就是限定或非限定名稱的字串相等比較。回傳值
符合條件的 NSXMLElement 物件陣列;若找不到任何符合的子節點,則回傳空陣列(而非 nil)。
實務上要注意的是,這個方法只搜尋直接子節點,不會遞迴深入。若需要找出任意深度的後代節點,得自己遞迴呼叫,或改用 XPath(nodesForXPath:error:)。
回傳文件的根元素。
- (NSXMLElement *)rootElement;
回傳值:接收者的根元素節點。
可用版本:OS X v10.4 及以後。
相關方法:– setRootElement:
宣告於:NSXMLDocument.h
這個方法是 DOM 解析的起點。典型的用法是取得根元素後,再往下層層呼叫 elementsForName: 逐步定位到目標節點。
回傳註記(annotation)所關聯的字串。
- (NSString *)stringValue;
回傳值:該註記所設定的字串。
可用版本:OS X v10.4 及以後。
相關方法:– setStringValue:
宣告於:PDFAnnotationTextWidget.h
這裡有個容易混淆的點:stringValue 在 NSXMLNode 的體系中,指的是節點所承載的文字內容——也就是標籤之間那段文字。而在 PDFKit 的 PDFAnnotation 體系中,它指的是註記上的文字。兩者名稱相同但語境不同,查文件時要留意所屬的 framework。
NSXMLElement *root = [document rootElement];
NSArray *items = [root elementsForName:@"item"];
for (NSXMLElement *item in items) {
NSString *title = [[item elementsForName:@"title"][0] stringValue];
NSString *link = [[item elementsForName:@"link"][0] stringValue];
NSLog(@"%@ - %@", title, link);
}
使用時建議先檢查陣列是否為空再取 [0],否則遇到結構不完整的 XML 就會 crash。另外,stringValue 取到的文字可能含有大量換行與縮排空白,記得用 stringByTrimmingCharactersInSet: 清理乾淨再做後續處理。