使用bitly服务缩短长URL并解析XML响应

### 利用 Bitly 服务缩短长 URL 的实现指南 #### 1. 整体解决方案概述 要实现长 URL 缩短功能，我们可以借助 Bitly 提供的网络服务。具体步骤如下： 1. 根据 Bitly 服务提供商的文档制定请求字符串。 2. 基于请求字符串创建 NSURL 对象，并使用 NSData 下载网络服务的响应。 3. 使用 NSXMLParser 解析返回的 XML 文档。 #### 2. 前期准备 在开始之前，你需要在 Bitly 上创建一个免费账户，并获取自己的 API 密钥和 API 用户名。你可以访问 [https://bit.ly](https://bit.ly) 来创建账户。 #### 3. 创建 LinkShortener 类 由于 NSXMLParser 使用委托设计模式，我们需要创建一个能够采用协议并支持委托的类。以下是创建 LinkShortener 类的具体步骤： 1. 在项目中添加一个新的 Objective - C 类，命名为 LinkShortener。 2. LinkShortener 类的接口需要包含以下内容： - 一个名为 recorderString 的 NSMutableString 前向声明，用于记录从网络服务获取的数据。 - 一个名为 currentElement 的字符串，用于跟踪 XML 解析器当前所在的 XML 文件区域。将 currentElement 和 recorderString 都设置为私有。 - 一个名为 getTheShortURLVersionOfThisLongURL 的函数前向声明，用于缩短 URL。 LinkShortener 类的接口代码如下： ```objc #import <Foundation/Foundation.h> @interface LinkShortener : NSObject{ @private NSMutableString *recorderString; NSString *currentElement; } -(NSString *)getTheShortURLVersionOfThisLongURL:(NSString *)longURL; @end ``` #### 4. XML 解析原理 在继续之前，我们先来了解一下 XML 是什么以及 NSXMLParser 如何读取 XML 文档。 - **XML 简介**：XML 代表可扩展标记语言，用于存储和传输数据。它通过使用开始标签和结束标签来封装数据。开始标签由 < 和 > 包围，结束标签由 </ 和 > 包围。标签和数据一起被称为元素。 - **XML 示例**： ```xml <Person> <Name>Matthew J. Campbell</Name> <Gender>Male</Gender> </Person> ``` - **NSXMLParser 解析方式**：NSXMLParser 从 XML 文档的开头开始，逐个元素读取，直到到达文档末尾。这种解析 XML 的方法称为简单 XML API（SAX）。 #### 5. 让 LinkShortener 类成为 NSXMLParser 的委托 为了使 LinkShortener 类能够解析从 Bitly 获取的 XML 数据，它需要采用 NSXMLParserDelegate 协议。修改 LinkShortener 类的接口如下： ```objc #import <Foundation/Foundation.h> @interface LinkShortener : NSObject<NSXMLParserDelegate>{ @private NSMutableString *recorderString; NSString *currentElement; } -(NSString *)getTheShortURLVersionOfThisLongURL:(NSString *)longURL; @end ``` #### 6. 实现委托方法 采用协议后，我们需要实现至少两个委托方法：parser:didStartElement:namespaceURI:qualifiedName:attributes: 和 parser:foundCharacters:。 - **parser:didStartElement:namespaceURI:qualifiedName:attributes: 方法**： ```objc - (void) parser:(NSXMLParser *)parser didStartElement:(NSString *)elementName namespaceURI:(NSString *)namespaceURI qualifiedName:(NSString *)qName attributes: (NSDictionary *)attributeDict{ currentElement = [elementName copy]; if ([elementName isEqualToString:@"shortUrl"]) { recorderString = [[NSMutableString alloc] init]; } } ``` 这个委托方法在每次到达新的 XML 元素时执行。我们复制 elementName 参数并将其放入 currentElement 中，以便在其他委托方法执行时跟踪当前所在的元素。如果当前元素是 "shortUrl"，则创建并初始化一个新的 NSMutableString。 - **parser:foundCharacters: 方法**： ```objc - (void)parser:(NSXMLParser *)parser foundCharacters:(NSString *)string{ if ([currentElement isEqualToString:@"shortUrl"]) [recorderString appendString:string]; } ``` 这个委托方法在 XML 文件中的元素中遇到字符时执行。如果 XML 解析器位于 "shortUrl" 元素中，则将找到的字符追加到 recorderString 中。 #### 7. 实现 getTheShortURLVersionOfThisLongURL: 方法 该方法用于准备请求并发送到 Web 服务器下载响应。具体实现如下： ```objc -(NSString *)getTheShortURLVersionOfThisLongURL:(NSString *)longURL{ #warning Get your API Login from https://bitly.com/a/your_api_key and put it here before running NSString *APILogin = @"[YOUR API LOGIN]"; #warning Get your API key from https://bitly.com/a/your_api_key and put it here before running NSString *APIKey = @"[YOUR API KEY]"; NSString *requestString = [[NSString alloc] initWithFormat: @"http://api.bit.ly/shorten?version=2.0.1&longUrl=%@&login=%@&apiKey=%@&format=xml" ```