iOS: iOS网络请求基本了解

文章目录URL与API获取网络请求URL与APIAPIApplication Programming Interface是一些预先定义的函数或指软件系统不同组成部分衔接的约定。也可以理解为是两个应用程序之间通信的机制或者使用一组规则和协议的组件或计算机硬件。URLuniform resource locator;URL是因特网的万维网服务程序上用于指定信息位置的表示方法。API与URL的关系Web API 是通过 URL 暴露的。每个 Web API 的端点Endpoint都有一个对应的 URL。URL作为API的访问接口我们可以通过特定的URL来调用API的功能。简单来说就是URL 是一个定位符标识资源的位置和访问方式。API 是一组接口定义了如何访问和使用某些功能或数据。Web API 使用 URL 作为其访问点客户端通过 URL 发送请求来调用 API 的功能。获取网络请求分为 5 个步骤创建请求地址创建请求类创建会话根据会话创建任务启动任务这里笔者以一个通过Open-Meteo提供的一个通过城市名获取城市省份和经纬度的示例来学习网络请求的基本操作-(void)creatURL{// 获取输入框的内容NSString*cityself.textField.text;if(city.length0){return;}// 对字符串进行 URL 编码NSString*endcode[city stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];// 拼接URLNSString*urlString[NSString stringWithFormat:https://geocoding-api.open-meteo.com/v1/search?name%count10languagezhformatjson,endcode];// 创建请求地址NSURL*url[NSURL URLWithString:urlString];// 创建Requset 请求类NSMutableURLRequest*request[NSMutableURLRequest requestWithURL:url];// 设置HPPT请求方法request.HTTPMethodGET;// 设置超时时间request.timeoutInterval15;// // 创建Session// NSURLSessionConfiguration* config [NSURLSessionConfiguration defaultSessionConfiguration];// 创建会话// NSURLSession* session [NSURLSession sessionWithConfiguration: config];NSURLSession*session[NSURLSession sharedSession];// 创建TaskNSURLSessionDataTask*task[session dataTaskWithRequest:request completionHandler:^(NSData*_Nullable data,NSURLResponse*_Nullable response,NSError*_Nullable error){if(error){NSLog(请求失败: %,error);return;}NSDictionary*dict[NSJSONSerialization JSONObjectWithData:data options:kNilOptions error:nil];NSLog(%,dict);NSArray*resultsdict[results];// 更新主线程 UIdispatch_async(dispatch_get_main_queue(),^{[self.cityArray removeAllObjects];if(results){[self.cityArray addObjectsFromArray:results];}[self.tableView reloadData];});}];[task resume];}在这个程序中, 我创建了一个NSTextField,并创建了一个UITableView 来显示结果,property(nonatomic,strong)UITextField*textField;property(nonatomic,strong)UITableView*tableView;property(nonatomic,strong)NSMutableData*data;property(nonatomic,strong)NSMutableArray*cityArray;下面我对上面的代码进行详细讲解在输入框中,我们输入城市名, 然后获取输入框中的内容NSString* endcode [city stringByAddingPercentEncodingWithAllowedCharacters: [NSCharacterSet URLQueryAllowedCharacterSet]];这段代码的作用是对输入框中的内容将城市名可能包含中文、空格等特殊字符转换为符合 URL 规范的百分号编码格式确保拼接后的 URL 合法且能被服务器正确解析。避免中文、空格、特殊符号导致 URL 无效或服务端解析错误NSString* urlString [NSString stringWithFormat: https://geocoding-api.open-meteo.com/v1/search?name%count10languagezhformatjson, endcode];这行代码的作用是将已编码的城市名拼接到 Open-Meteo 地理编码 API 的 URL 模板中生成一个完整的、可直接用于发起网络请求的 URL 字符串。https://geocoding-api.open-meteo.com/v1/search?name%count10languagezhformatjson这是 Open-Meteo 官方提供的免费地理编码 API。https://geocoding-api.open-meteo.com/v1/search?name%← 搜索关键词需 percent-encodingcount10← 返回结果数量默认10最大100languagezh ← 响应语言支持 zh/en/de/fr 等formatjson ← 响应格式默认即为 jsonNSURL* url [NSURL URLWithString: urlString];将字符串格式的URL转换为 Foundation 框架可识别的 NSURL 对象NSMutableURLRequest* request [NSMutableURLRequest requestWithURL: url];基于上一步创建的 URL 创建一个可变的请求对象如果需要修改默认的请求属性(如HPPT请求方法, 超时时间等)就需要使用Mutable, 如果使用不可变的 NSURLRequeest , 则无法在创建后更改任何配置request.HTTPMethod GET;这里显示指定 HTTP 动词为GETNSMutableURLRequest 的默认方法就是 GETrequest.timeoutInterval 15;将本次请求的超时阈值设为 15 秒, 超过此时间未收到响应, 系统会自动取消任务并返回 NSURLErrorTimeOut 错误NSURLSession* session [NSURLSession sharedSession];这段代码创建了一个APP 生命周期内的唯一会话对象,NSURLSession的作用是统一管理网络连接、配置策略、创建任务、处理回调这种方式的本质是获取系统预置的, APP 生命周期内的唯一的会话对象配置: 使用官方优化的默认配置 (缓存, Cookie, 超时策略)回调方式:仅支持 CompletionHandler不支持 Delegate生命周期: 由系统管理永远不需要也不应该调用invalidate会话对象还可以通过自定义创建// 创建配置对象NSURLSessionConfiguration*config[NSURLSessionConfiguration defaultSessionConfiguration];config.timeoutIntervalForRequest30;config.HTTPMaximumConnectionsPerHost4;config.requestCachePolicyNSURLRequestReloadIgnoringLocalCacheData;// 第二步用配置创建会话可选传入 delegate 和队列NSURLSession*session[NSURLSession sessionWithConfiguration:config delegate:selfdelegateQueue:nil]这种方式是创建一个全新的独立的会话实例配置: 完全自定义, 可以精确控制缓存, Cookie, 超时等所有网络行为回调方式: 同时支持Delegate 和 CompletionHander生命周期: 必须手动管理, 当不再使用时, 必须调用以下方式之一, 否则会导致内存泄漏// 等待现有任务完成之后再销毁[session finishTasksAndInvalIdate];// 立即取消所有任务并销毁[session invaldateAndCancel];// 创建TaskNSURLSessionDataTask*task[session dataTaskWithRequest:request completionHandler:^(NSData*_Nullable data,NSURLResponse*_Nullable response,NSError*_Nullable error){if(error){NSLog(请求失败: %,error);return;}NSDictionary*dict[NSJSONSerialization JSONObjectWithData:data options:kNilOptions error:nil];NSLog(%,dict);NSArray*resultsdict[results];// 更新主线程 UIdispatch_async(dispatch_get_main_queue(),^{[self.cityArray removeAllObjects];if(results){[self.cityArray addObjectsFromArray:results];}[self.tableView reloadData];});}];以上代码的作用是以 request 为蓝图, 向 session 申请创建一个数据任务其实可以采用一个 [session dataTaskWithURL:url completionHandler:]的方式去创建一个但是如果以后面的方式去创建的话就意味着是以一种GET方式去获取网络请求这样只能满足一些简单的网络请求而使用request方式来获取数据可以满足更复杂的情况下面给出以GET方式去获取网络请求的代码// 通过GET获取网络请求NSURLSessionDataTask*task[[NSURLSession sharedSession]dataTaskWithURL:url completionHandler:^(NSData*_Nullable data,NSURLResponse*_Nullable response,NSError*_Nullable error){if(error){NSLog(%,error);return;}NSDictionary*dict[NSJSONSerialization JSONObjectWithData:data options:kNilOptions error:nil];NSArray*resultsdict[results];dispatch_async(dispatch_get_main_queue(),^{[self.cityArray removeAllObjects];if(results){[self.cityArray addObjectsFromArray:results];}[self.tableView reloadData];});}];[task resume];这段代码的作用是启动(或恢复) 一个处于挂起状态的网络任务在 NSURLSession 的设计中, 所有通过工厂方法创建的任务默认都是挂起状态, 不会自动开始执行, 必须显示调用 resume 后,系统才会真正发起网络请求