详解iOS - ASIHTTPRequest 网络请求

前言

使用 iOS SDK 中的 HTTP 网络请求 API，相当的复杂，调用很繁琐，ASIHTTPRequest 就是一个对 CFNetwork API 进行了封装，并且使用起来非常简单的一套 API，外号 “HTTP终结者”，用 Objective-C 编写，运行效率很高，可以很好的应用在 Mac OS X 系统和 iOS 平台的应用程序中，ASIHTTPRequest 适用于基本的 HTTP 请求，和基于 REST 的服务之间的交互。可惜作者早已停止更新，有一些潜在的 BUG 无人去解决，很多公司的旧项目里面都残留着它的身影，以前的很多 iOS 项目都是 ASI + SBJson，会不会用 ASI，可以算是检验是否为老牌 iOS 程序员的标准之一。从 iOS 9 开始 CFNetwork 相关的类和方法开始被废弃，可以使用 AFNetworking 替换 ASIHTTPRequest 的使用。在 iOS 9+ 中使用 ASIHTTPRequest 无需对 App Transport Security Settings 添加设置。

1、ASIHTTPRequest

1.1 ASI 主要特色

• 通过简单的接口，即可完成向服务端提交数据和从服务端获取数据的工作。
• 下载的数据，可存储到内存中或直接存储到磁盘中。
• 能上传本地文件到服务端。
• 可以方便的访问和操作请求和返回的 Http 头信息。
• 可以获取到上传或下载的进度信息，为应用程序提供更好的体验。
• 支持上传或下载队列，并且可获取队列的进度信息。
• 支持基本、摘要和 NTLM 身份认证，在同一会话中授权凭证会自动维持，并且可以存储在 Keychain（Mac 和 iOS 操作系统的密码管理系统）中。
• 支持 Cookie。
• 当应用（iOS 4+）在后台运行时，请求可以继续运行。
• 支持 GZIP 压缩数据。
• 内置的 ASIDownloadCache 类，可以缓存请求返回的数据，这样即使没有网络也可以返回已经缓存的数据结果。
• ASIWebPageRequest 可以下载完整的网页，包括包含的网页、样式表、脚本等资源文件，并显示在 UIWebView /WebView 中。任意大小的页面都可以无限期缓存，这样即使没有网络也可以离线浏览。
• 支持客户端证书。
• 支持通过代理发起 Http 请求。
• 支持带宽限制。在 iOS 平台，可以根据当前网络情况来自动决定是否限制带宽，例如当使用 WWAN(GPRS/Edge/3G) 网络时限制，而当使用 WIFI 时不做任何限制。
• 支持断点续传。
• 支持同步和异步请求。

1.2 AFN 与 ASI 的区别

1、底层实现

1）AFN 的底层实现基于 OC 的 NSURLConnection 和 NSURLSession

2）ASI 的底层实现基于纯 C 语言的 CFNetwork 框架

3）因为 NSURLConnection 和 NSURLSession 是在 CFNetwork 之上的一层封装，因此 ASI 的运行性能高于 AFN

2、对服务器返回的数据处理

1）ASI 没有直接提供对服务器数据处理的方式，直接返回的是 NSData/NSString

2）AFN 提供了多种对服务器数据处理的方式 (1) JSON 处理-直接返回 NSDictionary 或者 NSArray

  (2) XML 处理-返回的是 xml 类型数据，需对其进行解析

  (3) 其他类型数据处理

3、监听请求过程 1

）AFN 提供了success 和 failure 两个 block 来监听请求的过程（只能监听成功和失败）

•  success : 请求成功后调用
• failure : 请求失败后调用

2）ASI 提供了 3 套方案，每一套方案都能监听请求的完整过程（监听请求开始、接收到响应头信息、接受到具体数据、接受完毕、请求失败）

• 成为代理，遵守协议，实现协议中的代理方法
• 成为代理，不遵守协议，自定义代理方法
• 设置 block

4、在文件下载和文件上传的使用难易度

1）AFN

•  不容易实现监听下载进度和上传进度
• 不容易实现断点续传
• 一般只用来下载不大的文件

2）ASI

•  非常容易实现下载和上传
• 非常容易监听下载进度和上传进度
• 非常容易实现断点续传
• 下载大文件或小文件均可

3）实现下载上传推荐使用 ASI

5、网络监控

1）AFN 自己封装了网络监控类，易使用

2）ASI 使用的是 Reachability，因为使用 CocoaPods 下载 ASI 时，会同步下载 Reachability，但 Reachability 作为网络监控使用较为复杂（相对于 AFN 的网络监控类来说）

3）推荐使用 AFN 做网络监控 AFNetworkReachabilityManager

6、ASI 提供的其他实用功能

1）控制信号旁边的圈圈要不要在请求过程中转

2）可以轻松地设置请求之间的依赖：每一个请求都是一个 NSOperation 对象

3）可以统一管理所有请求（还专门提供了一个叫做 ASINetworkQueue 来管理所有的请求对象） 暂停/恢复/取消所有的请求
监听整个队列中所有请求的下载进度和上传进度

2、ASIHTTPRequest 的使用

2.1 添加 ASIHTTPRequest

Github 网址： https://github.com/pokeb/asi-http-request

https://allseeing-i.com/ASIHTTPRequest/

ASIHTTPRequest 系统需求：

ASIHTTPRequest Version	Minimum iOS Target	Target Notes
1.8.1 -> 1.8.2	iOS 3.0+
0.2 -> 1.8.0

ASIHTTPRequest 使用 MRC

Objective-C

  // 添加系统库文件
  CFNetwork.framework
  SystemConfiguration.framework
  MobileCoreServices.framework
  CoreGraphics.framework
  libz.1.1.3.tbd
  libxml2.2.tbd

  // 添加第三方库文件
  ASIHTTPRequest-1.8.2

  // 在 TARGETS -> Builed Settings -> Search Paths -> Header Search Paths 中添加文件路径
  /usr/include/libxml2

  // 在 TARGETS -> Build Phases -> Compile Sources -> ...in .../ASIHTTPRequest 后添加
  -fno-objc-arc

  // 包含头文件
  #import "ASIHTTPRequest.h"
  #import "ASIFormDataRequest.h"

2.2 ASIHTTPRequest 的设置

Objective-C

  // 设置请求头
  ASIHTTPRequest *request = [ASIHTTPRequest requestWithURL:[NSURL URLWithString:@"http://api.hudong.com/iphonexml.do?type=focus-c"]];
  [request addRequestHeader:@"Referer" value:@"http://www.dreamingwish.com/"];

  // 设置应用后台运行时是否仍然请求数据
  request.shouldContinueWhenAppEntersBackground = YES;

  // 设置请求超时时重试的次数
  request.numberOfTimesToRetryOnTimeout = 3;

  // 设置 KeepAlive 支持

    // Set the amount of time to hang on to a persistent connection before it should expire to 2 minutes
    request.persistentConnectionTimeoutSeconds = 120;

    // Disable persistent connections entirely
    request.shouldAttemptPersistentConnection = NO;

  // 设置是否显示网络请求信息在 status bar 上
  [ASIHTTPRequest setShouldUpdateNetworkActivityIndicator:NO];

  // 网络状态检查
  BOOL isNetworkInUse = [ASIHTTPRequest isNetworkInUse];

3、ASI 同步 GET 请求

这是 ASIHTTPRequest 最简单的一种使用模式，发送 startSynchronous 消息后即开始在同一线程中执行 HTTP 请求，线程将一直等待直到请求结束（请求成功或者失败）。通过检查 error 属性可以判断请求是否成功或者有错误发生。

要获取返回的文本信息，调用 responseString 方法。如果下载的是二进制文件，例如图片、MP3，则调用 responseData 方法，可以得到一个 NSData 对象。

一般情况下，应该优先使用异步请求代替同步请求，当在主线程中使用 ASIHTTPRequest 同步请求会阻塞主线程的执行，这导致用户界面不响应用户操作，任何动画都会停止渲染，直到请求完成。

Objective-C

数据请求

  NSURL *url = [NSURL URLWithString:@"http://api.hudong.com/iphonexml.do?type=focus-c"];

  // 创建请求
  ASIHTTPRequest *request = [ASIHTTPRequest requestWithURL:url];

  // 设置超时时间，可不设置，使用默认
  request.timeOutSeconds = 5;

  // 发送同步请求
  [request startSynchronous];

  // 获得错误信息
  NSError *error = [request error];

  // 网络请求失败
  if (error) {

    // 网络请求成功
    NSLog(@"网络请求失败:\n%@", error);

  } else {

    // 获得服务器的响应，字符串格式
    NSString *responseString = [request responseString];
    NSLog(@"网络请求成功:\n%@", responseString);

    // 获得服务器的响应，NSData 格式
    NSData *responseData = [request responseData];
    textView.text = [[NSString alloc] initWithData:responseData encoding:NSUTF8StringEncoding];
  }

文件下载

通过设置 request 的 setDownloadDestinationPath，可以设置下载文件用的下载目标目录。首先，下载过程文件会保存在 temporaryFileDownloadPath 目录下。如果下载完成会做以下事情：

1，如果数据是压缩的，进行解压，并把文件放在 downloadDestinationPath 目录中，临时文件被删除。

2，如果下载失败，临时文件被直接移到 downloadDestinationPath 目录，并替换同名文件。

如果你想获取下载中的所有数据，可以实现 delegate 中的 request:didReceiveData:方法。但如果你实现了这个方法，request 在下载完后，request 并不把文件放在 downloadDestinationPath中，需要手工处理。

  NSURL *url = [NSURL URLWithString:@"http://www.dreamingwish.com/wp-content/uploads/2011/10/asihttprequest-auth.png"];

  ASIHTTPRequest *request = [ASIHTTPRequest requestWithURL:url];

  // 设置文件存储路径
  [request setDownloadDestinationPath:@"/Users/JHQ0228/Desktop/asi.png"];

  [request startSynchronous];

  // 获得错误信息
  NSError *error = [request error];

  // 网络请求失败
  if (error) {

    NSLog(@"网络请求失败:\n%@", error);

  } else {

    // 网络请求成功
    NSLog(@"网络请求成功:\n");
  }

4、ASI 异步 GET 请求

请求在后台线程中运行，当请求执行完后再通知调用的线程。这样不会导致主线程进行网络请求时，界面被锁定等情况。

1、协议方式

在这里实现了两个 delegate 的方法，当数据请求成功时会调用 requestFinished，请求失败时（如网络问题或服务器内部错误）会调用 requestFailed。

  NSURL *url = [NSURL URLWithString:@"http://api.hudong.com/iphonexml.do?type=focus-c"];

  // 创建请求
  ASIHTTPRequest *request = [ASIHTTPRequest requestWithURL:url];

  // 设置超时时间，可不设置，使用默认
  request.timeOutSeconds = 5;

  // 设置代理，需遵守 <ASIHTTPRequestDelegate> 协议
  request.delegate = self;

  // 发送异步请求
  [request startAsynchronous];

  // 网络请求成功，协议方法
  - (void)requestFinished:(ASIHTTPRequest *)request {

  }

  // 网络请求失败，协议方法
  - (void)requestFailed:(ASIHTTPRequest *)request {

  }

2、Block 方式

在平台支持情况下，ASIHTTPRequest 1.8 以上支持 block。

  NSURL *url = [NSURL URLWithString:@"http://api.hudong.com/iphonexml.do?type=focus-c"];

  // 创建请求，加 __weak 除去 block 循环调用警告
  __weak ASIHTTPRequest *request = [ASIHTTPRequest requestWithURL:url];

  // 设置超时时间，可不设置，使用默认
  request.timeOutSeconds = 5;

  // 发送异步请求
  [request startAsynchronous];

  // 网络请求成功
  [request setCompletionBlock:^{

  }];

  // 网络请求失败
  [request setFailedBlock:^{

  }];

5、ASI POST 请求

1、POST 表单

ASIFormDataRequest，模拟 Form 表单提交，其提交格式与 Header 会自动识别。文件中的数据是需要时才从磁盘加载，所以只要 web server 能处理，那么上传大文件是没有问题的。

  // 通常数据是以 'application/x-www-form-urlencoded' 格式发送的，如果上传了二进制数据或者文件，那么格式将自动变为 ‘multipart/form-data'。

    ASIFormDataRequest *request = [ASIFormDataRequest requestWithURL:[NSURL URLWithString:@"http://www.dreamingwish.com"]];

    // 没有文件
    [request setPostValue:@"Ben" forKey:@"first_name"];
    [request setPostValue:@"Copsey" forKey:@"last_name"];

    // 发送文件
    [request setFile:@"/Users/ben/Desktop/ben.jpg" forKey:@"photo"];

  // 数据的 mime 头是自动判定的，但是如果你想自定义mime头，那么这样：

    ASIFormDataRequest *request = [ASIFormDataRequest requestWithURL:[NSURL URLWithString:@"http://www.dreamingwish.com"]];

    // Upload a file on disk
    [request setFile:@"/Users/ben/Desktop/ben.jpg" withFileName:@"myphoto.jpg" andContentType:@"image/jpeg" forKey:@"photo"]; 

    // Upload an NSData instance
    NSData *imageData = UIImagePNGRepresentation([UIImage imageNamed:@"myphoto.jpg"]);
    [request setData:imageData withFileName:@"myphoto.jpg" andContentType:@"image/jpeg" forKey:@"photo"];

  // 你可以使用 addPostValue 方法来发送相同 name 的多个数据：

    ASIFormDataRequest *request = [ASIFormDataRequest requestWithURL:[NSURL URLWithString:@"http://www.dreamingwish.com"]];

    [request addPostValue:@"Ben" forKey:@"names"];
    [request addPostValue:@"George" forKey:@"names"];

2、PUT 请求、自定义 POST 请求

如果你想发送 PUT 请求，或者你想自定义 POST 请求，使用 appendPostData: 或者 appendPostDataFromFile:

  ASIHTTPRequest *request = [ASIHTTPRequest requestWithURL:[NSURL URLWithString:@"http://www.dreamingwish.com"]];

  [request appendPostData:[@"This is my data" dataUsingEncoding:NSUTF8StringEncoding]];

  // Default becomes POST when you use appendPostData: / appendPostDataFromFile: / setPostBody:
  [request setRequestMethod:@"PUT"];

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持。

# ios  # asihttprequest  # 网络请求  # ios9  # 详解iOS通过ASIHTTPRequest提交JSON数据  # 的是  # 上传  # 你想  # 自定义  # 数据处理  # 网络监控  # 可不  # 都是  # 放在  # 服务端  # 推荐使用  # 断点续传  # 不容易  # 表单  # 错误信息  # 完后  # 应用程序  # 需对  # 临时文件  # 这是 

相关文章： 浙江网站制作公司有哪些,浙江栢塑信息技术有限公司定制网站做的怎么样？  如何在橙子建站上传落地页？操作指南详解  建站主机与服务器功能差异如何区分？  建站主机选购指南：核心配置与性价比推荐解析  定制建站流程解析：需求评估与SEO优化功能开发指南  建站之星后台搭建步骤解析：模板选择与产品管理实操指南  如何快速完成中国万网建站详细流程？  建站之星代理商如何保障技术支持与售后服务？  零服务器AI建站解决方案：快速部署与云端平台低成本实践  较简单的网站制作软件有哪些,手机版网页制作用什么软件？  c++怎么编写动态链接库dll_c++ __declspec(dllexport)导出与调用【方法】  网页制作模板网站推荐,网页设计海报之类的素材哪里好？  建站之星备案流程有哪些注意事项？  高端智能建站公司优选：品牌定制与SEO优化一站式服务  宝华建站服务条款解析：五站合一功能与SEO优化设置指南  c++23 std::expected怎么用 c++优雅处理函数错误返回【详解】  如何在宝塔面板中修改默认建站目录？  香港服务器WordPress建站指南：SEO优化与高效部署策略  如何在企业微信快速生成手机电脑官网？  高防服务器租用首荐平台，企业级优惠套餐快速部署  建站之星下载版如何获取与安装？  北京网站制作公司哪家好一点,北京租房网站有哪些？  如何通过远程VPS快速搭建个人网站？  Python文件管理规范_工程实践说明【指导】  建站之星价格显示格式升级，你的预算足够吗？  如何在腾讯云免费申请建站？  网站制作公司排行榜,抖音怎样做个人官方网站  ,在苏州找工作，上哪个网站比较好？  如何在万网ECS上快速搭建专属网站？  如何通过PHP快速构建高效问答网站功能？  盘锦网站制作公司,盘锦大洼有多少5G网站？  宁波免费建站如何选择可靠模板与平台？  SAX解析器是什么，它与DOM在处理大型XML文件时有何不同？  深圳 网站制作,深圳招聘网站哪个比较好一点啊？  网站网页制作电话怎么打,怎样安装和使用钉钉软件免费打电话？  韩国网站服务器搭建指南：VPS选购、域名解析与DNS配置推荐  如何用免费手机建站系统零基础打造专业网站？  成都响应式网站开发,dw怎么把手机适应页面变成网页？  如何快速搭建个人网站并优化SEO？  北京企业网站设计制作公司,北京铁路集团官方网站？  电商网站制作多少钱一个,电子商务公司的网站制作费用计入什么科目？  北京制作网站的公司排名,北京三快科技有限公司是做什么？北京三快科技？  如何在香港服务器上快速搭建免备案网站？  详解jQuery中基本的动画方法  建站ABC备案流程中有哪些关键注意事项？  css网站制作参考文献有哪些,易聊怎么注册？  建站之星手机一键生成：多端自适应+小程序开发快速建站指南  如何自定义建站之星模板颜色并下载新样式？  头像制作网站在线制作软件,dw网页背景图像怎么设置？  ,柠檬视频怎样兑换vip？