iOS基础 - 网络：XML | GDataXMLNode

▶ XML

XML：Extensible Markup language 可扩展标记语⾔言，它是主流数据格式之一，可以用来存储和传输数据，主要作用是数据交换、内容管理、⽤作配置文件

XML 解析有两种

A. SAX 解析：simple API for xml，基于事件驱动的解析方式，逐行解析，采用协议回调机制

B. DOM 解析：document Object model，解析时需要将 XML文件 整体读入，并且将 XML 结构化成树状，使用时再通过树状结构读取相关数据

在 Xcode 中如何新建 xml 源文件 ？选择 iOS/other/empty，新建文件即可，后缀名需手动填写。XML 解析工具有 NSXMLParser、GDataXMLNode、TochXML、KissXML 等

XML 数据结构语法

A. 节点使用⼀对标签表⽰：起始和结束标签

B. 根节点是起始节点，只有⼀个

C. 节点可以嵌套；也可以有值，存储在⼀对儿标签中

D. 结点添加属性：数据存储一般只有两个位置，一个是结点属性，一个是子节点

 

▶ NSXMLParser

它是 iOS ⾃带的 XML 解析类，采⽤ SAX ⽅式解析数据。解析过程由 NSXMLParserDelegate 协议⽅法回调：开始标签 -> 取值 -> 结束标签 -> 取值。使用方式如下

// - Students.xml ：XML文件

<Students>

    <Student homeTown = "Lewisham" petName = "Keylee">
        <name>Hazell</name>
        <sex>Female</sex>
        <age>26</age>
        <phoneNumber>15555555555</phoneNumber>
    </Student>

    <Student>
        <name>Lee</name>
        <sex>Male</sex>
        <age>32</age>
        <phoneNumber>18888888888</phoneNumber>
    </Student>

    <Student>
        <name>Solina</name>
        <sex>Female</sex>
        <age>22</age>
        <phoneNumber>17777777777</phoneNumber>
    </Student>

</Students>

// - ViewController.m

#import "ViewController.h"
@interface ViewController ()<NSXMLParserDelegate>// 接受协议

@end
@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];


    // 路径
    NSString *filePath = [[NSBundle mainBundle] pathForResource:@"Students" ofType:@"xml"];
    NSData *data = [NSData dataWithContentsOfFile:filePath];
    // 通过 data 创建一个解析器
    NSXMLParser *xmlParser = [[NSXMLParser alloc] initWithData:data];
    xmlParser.delegate = self;// 代理
    [xmlParser parse];// 开始解析
}

#pragma mark - <NSXMLParserDelegate>
// 扫描到一个开始标签
- (void)parser:(NSXMLParser *)parser didStartElement:(NSString *)elementName namespaceURI:(NSString *)namespaceURI qualifiedName:(NSString *)qName attributes:(NSDictionary *)attributeDict{
    NSLog(@"%s",__func__);
    NSLog(@"didStartElement = %@,namespaceURI = %@ ,qualifiedName = %@,attributes = %@",elementName,namespaceURI,qName,attributeDict);
}

// 扫描到一个结束标签
- (void)parser:(NSXMLParser *)parser didEndElement:(NSString *)elementName namespaceURI:(NSString *)namespaceURI qualifiedName:(NSString *)qName{
    NSLog(@"%s",__func__);
    NSLog(@"didEndElement = %@,namespaceURI = %@ ,qualifiedName = %@",elementName,namespaceURI,qName);
}

// 扫描到内容
- (void)parser:(NSXMLParser *)parser foundCharacters:(NSString *)string{
    NSLog(@"%s",__func__);
    NSLog(@"foundCharacters = %@",string);
}

// 错误发生
- (void)parser:(NSXMLParser *)parser validationErrorOccurred:(NSError *)validationError{
    NSLog(@"%s",__func__);
    NSLog(@"validationErrorOccurred = %@",validationError);
}


@end

▶ GDataXMLNode

GDataXMLNode 是 Google 提供的开源 XML 解析类，对 libxml2.dylib 进行了 Objective-C 的封装，能对较小或中等的 xml文档 进行读写操作且支持 XPath语法。使用 GDataXMLNode 前，Xcode 需导入  libxml2.tbd 框架！注：它默认在 MRC模式 下使用，若编译出现  libxml/tree.h' file not found  错误，只需在 build Settings/Header Search Paths 中，添加  ${SDKROOT}/usr/include/libxml2 即可

代码示例：如何使用 GDataXMLNode 

// - ViewController.m

#import "ViewController.h"
#import "GDataXMLNode.h"
@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];

    // 路径
    NSString *filePath02 = [[NSBundle mainBundle] pathForResource:@"Students" ofType:@"xml"];
    NSData *data02 = [NSData dataWithContentsOfFile:filePath02];

    // GDataXMLDocument
    GDataXMLDocument *document = [[GDataXMLDocument alloc] initWithData:data02 options:0 error:nil];
    
    // 文档树
    GDataXMLElement *rootElement = [document rootElement];
    //NSLog(@"%@",rootElement);

    // 获取根节点下面所有叫做 student 的子节点
    NSArray *allStudentElements = [rootElement elementsForName:@"Student"];
    //NSLog(@"%@",allStudentElements);

    for (GDataXMLElement *stuElement in allStudentElements) {
        //NSLog(@"%@",stuElement);

        NSString *name = [[[stuElement elementsForName:@"name"] objectAtIndex:0] stringValue];
        NSLog(@"%@",name);
        NSString *age = [[[stuElement elementsForName:@"age"] objectAtIndex:0] stringValue];
        NSLog(@"%@",age);
        NSString *phoneNumber = [[[stuElement elementsForName:@"phoneNumber"] objectAtIndex:0] stringValue];
        NSLog(@"%@",phoneNumber);
        NSString *sex = [[[stuElement elementsForName:@"sex"] objectAtIndex:0] stringValue];
        NSLog(@"%@",sex);
    }
}

// 相对路径、绝对路径
-(void)learnPath{

    // 路径
    // 1、绝对路径：从当前的节点（调用方法的节点）开始，给出一个完整路径。如 Student/name
    // 2、相对路径，以 // 打头，后接节点名称，凡是满足此路径的，全部返回，如 //name 获得所有的 name 节点

    NSString *filePath02 = [[NSBundle mainBundle] pathForResource:@"Student" ofType:@"xml"];
    NSData *data02 = [NSData dataWithContentsOfFile:filePath02];

    GDataXMLDocument *document = [[GDataXMLDocument alloc] initWithData:data02 options:0 error:nil];
    GDataXMLElement *rootElement = [document rootElement];// 把 xml 文档读入内存生成 xml 文档树

    // 相对路径
    NSArray *stuElements = [rootElement nodesForXPath:@"//Student" error:nil];
    NSLog(@"%@",stuElements);
    GDataXMLElement *firstStuElement = [stuElements objectAtIndex:0];// 返回节点
    NSString *homeTown = [[firstStuElement attributeForName:@"homeTown"] stringValue];
    NSLog(@"%@",homeTown);

    // 绝对路径
    NSArray * nameElements = [rootElement nodesForXPath:@"Student/name" error:nil];
    NSLog(@"%@",nameElements);

}

@end