[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