[iOS] XML解析

 

1. 相关的类

主导解析的类：

@interface NSXMLParser : NSObject {

｝

- (id)initWithContentsOfURL:(NSURL *)url; 

// 初始化解析器指定的URL。

- (id)initWithData:(NSData *)data; 

// 从数据创建解析器

- (id)initWithStream:(NSInputStream *)stream NS_AVAILABLE(10_7, 5_0); 

//创建一个解析器，增量从指定的流中提取数据，并解析它。

// 委托管理。委托不被保留。

- (id <NSXMLParserDelegate>)delegate;

- (void)setDelegate:(id <NSXMLParserDelegate>)delegate;

- (void)setShouldProcessNamespaces:(BOOL)shouldProcessNamespaces;
- (void)setShouldReportNamespacePrefixes:(BOOL)shouldReportNamespacePrefixes;
- (void)setShouldResolveExternalEntities:(BOOL)shouldResolveExternalEntities;

- (BOOL)shouldProcessNamespaces;

- (BOOL)shouldReportNamespacePrefixes;

- (BOOL)shouldResolveExternalEntities;

- (BOOL)parse; 

// 调用来启动事件驱动的解析。返回一个成功的解析中的“是”的情况下，在发生错误的情况下为“否”。

- (void)abortParsing; 

// 调用的委托，停止解析。委托将得到一个错误信息发送给它的。

- (NSError *)parserError; 

// 被称为解析后到确定解析器的状态。
@end

获取解析过程中状态的类：

// 一旦解析已经开始，委托在某些解析器的状态可能会感兴趣。在分析过程中，这些方法只会返回有意义的信息，或之后发生了一个错误。

@interface NSXMLParser (NSXMLParserLocatorAdditions)
- (NSString *)publicID;
- (NSString *)systemID;
- (NSInteger)lineNumber;
- (NSInteger)columnNumber;
@end

解析的回调接口：

// 解析器的代表通知的事件通过的方法在NSXMLParserDelegateEventAdditions类别。@protocol NSXMLParserDelegate <NSObject>
@optional

// Document handling methods
- (void)parserDidStartDocument:(NSXMLParser *)parser;
 // 解析器解析文档开始时发送。

- (void)parserDidEndDocument:(NSXMLParser *)parser;
 //当解析器发送已完成解析。如果遇到这，在解析成功。

// DTD处理方法的各种声明。

- (void)parser:(NSXMLParser*)parser foundNotationDeclarationWithName:(NSString *)name publicID:(NSString *)publicID systemID:(NSString *)systemID;

- (void)parser:(NSXMLParser *)parser foundUnparsedEntityDeclarationWithName:(NSString *)name publicID:(NSString *)publicID systemID:(NSString *)systemID notationName:(NSString *)notationName;

- (void)parser:(NSXMLParser *)parser foundAttributeDeclarationWithName:(NSString *)attributeName forElement:(NSString *)elementName type:(NSString *)type defaultValue:(NSString *)defaultValue;

- (void)parser:(NSXMLParser *)parser foundElementDeclarationWithName:(NSString *)elementName model:(NSString *)model;

- (void)parser:(NSXMLParser *)parser foundInternalEntityDeclarationWithName:(NSString *)name value:(NSString *)value;

- (void)parser:(NSXMLParser *)parser foundExternalEntityDeclarationWithName:(NSString *)name publicID:(NSString *)publicID systemID:(NSString *)systemID;

- (void)parser:(NSXMLParser *)parser didStartElement:(NSString *)elementName namespaceURI:(NSString *)namespaceURI qualifiedName:(NSString *)qName attributes:(NSDictionary *)attributeDict;

 // 当解析器发现元素开始标记发送。

 //在的cvslog标记的情况下，下面的是委托接收：

 // elementName == cvslog, namespaceURI == http://xml.apple.com/cvslog, qualifiedName == cvslog

 //在雷达标记的情况下，是通过在以下：
 // elementName == radar, namespaceURI == http://xml.apple.com/radar, qualifiedName == radar:radar

 // If namespace processing >isn't< on, the xmlns:radar="http://xml.apple.com/radar" is returned as an attribute pair, the elementName is 'radar:radar' and there is no qualifiedName.

- (void)parser:(NSXMLParser *)parser didEndElement:(NSString *)elementName namespaceURI:(NSString *)namespaceURI qualifiedName:(NSString *)qName;
 // 发送时遇到一个结束标记。的各种参数被提供如上。

- (void)parser:(NSXMLParser *)parser didStartMappingPrefix:(NSString *)prefix toURI:(NSString *)namespaceURI;
 //发送，当解析器首先看到一个命名空间属性。
 // In the case of the cvslog tag, before the didStartElement:, you'd get one of these with prefix == @"" and namespaceURI == @"http://xml.apple.com/cvslog" (i.e. the default namespace)
 // In the case of the radar:radar tag, before the didStartElement: you'd get one of these with prefix == @"radar" and namespaceURI == @"http://xml.apple.com/radar"
- (void)parser:(NSXMLParser *)parser didEndMappingPrefix:(NSString *)prefix;
 // 发送的命名空间前缀的问题时，超出范围。

- (void)parser:(NSXMLParser *)parser foundCharacters:(NSString *)string;
 // 返回字符串迄今为止遇到的人物。您可能不一定能得到最长的字符运行。解析器保留的权利交给委托的许多潜在要求在连续

-parser:foundCharacters:

- (void)parser:(NSXMLParser *)parser foundIgnorableWhitespace:(NSString *)whitespaceString;

 // 解析器报告忽略的空白，它的发现为字符以同样的方式。

- (void)parser:(NSXMLParser *)parser foundProcessingInstructionWithTarget:(NSString *)target data:(NSString *)data;

 //解析器报告你使用这种方法处理指令。

 In the case above, target == @"xml-stylesheet" and data == @"type='text/css' href='cvslog.css'"

- (void)parser:(NSXMLParser *)parser foundComment:(NSString *)comment;
 // 报告的注释（Text in a <!-- --> block）的委托，作为一个单一字符串

- (void)parser:(NSXMLParser *)parser foundCDATA:(NSData *)CDATABlock;
 //本报告CDATA块的委托作为一个NSData。

- (NSData *)parser:(NSXMLParser *)parser resolveExternalEntityName:(NSString *)name systemID:(NSString *)systemID;
 // 这给代表一个机会来解决外部实体本身所得到的数据和回复。

- (void)parser:(NSXMLParser *)parser parseErrorOccurred:(NSError *)parseError;

 //本报告委托一个致命的错误。解析器将停止解析。
- (void)parser:(NSXMLParser *)parser validationErrorOccurred:(NSError *)validationError;
 //本报告委托一个致命的错误。解析器将停止解析。

@end