NSURLConnection 网络请求

2024-03-28 14:59:46

前言

DEPRECATED: The NSURLConnection class should no longer be used.
NSURLSession is the replacement for NSURLConnection
从 iOS 9 开始 NSURLConnection 的大部分方法被废弃。

1、NSURLConnection

NSURLConnection 提供了两种方式来实现连接，一种是同步的另一种是异步的，异步的连接将会创建一个新的线程，
这个线程将会来负责下载的动作。而对于同步连接，在下载连接和处理通讯时，则会阻塞当前调用线程。
许多开发者都会认为同步的连接将会堵塞主线程，其实这种观点是错误的。一个同步的连接是会阻塞调用它的线程。
如果你在主线程中创建一个同步连接，没错，主线程会阻塞。但是如果你并不是从主线程开启的一个同步的连接，它将会类似异步的连接一样。
因此这种情况并不会堵塞你的主线程。事实上，同步和异步的主要区别就是运行 runtime 为会异步连接创建一个线程，而同步连接则不会。
1.1 NSURLConnection 的常用类
- 1、NSURL：请求地址；
- 2、NSURLRequest：封装一个请求，保存发给服务器的全部数据，包括一个 NSURL 对象，请求方法、请求头、请求体 ....；
- 3、NSMutableURLRequest：NSURLRequest 的子类
- 4、NSURLConnection：负责发送请求，建立客户端和服务器的连接。发送 NSURLRequest 的数据给服务器，并收集来自服务器的响应数据。
1.2 使用 NSURLConnection 发送请求的步骤
- 1、创建一个 NSURL 对象，设置请求路径（设置请求路径）；
- 2、传入 NSURL 创建一个 NSURLRequest 对象，设置请求头和请求体（创建请求对象）；任何 NSURLRequest 默认都是 GET 请求。
- 3、使用 NSURLConnection 发送 NSURLRequest（发送请求）。
  - 发送同步请求：有返回值。
  - 发送异步请求：没有返回值。
1.3 发送同步请求
- 使用 NSURLConnection 的 sendSynchronousRequest:returningResponse:error: 类方法，我们可以进行同步请求。
- 在创建一个同步的网络连接的时候我们需要明白一点，并不是是我们的这个同步连接一定会堵塞我们的主线程，如果这个同步的连接是创建在主线程上的，
- 那么这种情况下是会堵塞我们的主线程的，其他的情况下是不一定会堵塞我们的主线程的。
- 例如如果在 GCD 的全局并发队列上初始化了一个同步的连接，其实并不会堵塞我们的主线程的。
1.4 发送异步请求
发送异步请求有两种方式：
- 1）使用 block 回调：
```
NS_AVAILABLE(10_7, 5_0)
+ (void)sendAsynchronousRequest:(NSURLRequest*) request
queue:(NSOperationQueue*) queue
completionHandler:(void (^)(NSURLResponse* response, NSData* data, NSError* connectionError)) handler;
```
  - 创建一个操作，放在 NSOperation 队列中执行，默认是异步执行的。当服务器有返回数据的时候调用会开一条新的线程去发送请求，主线程继续往下走，
  - 当拿到服务器的返回数据的数据的时候再回调 block，执行 block 代码段。这种情况不会卡住主线程。
  - queue 队列的作用是决定这个 block 操作放在哪个线程执行？刷新 UI 界面的操作应该放在主线程执行，不能放在子线程，在子线程处理 UI 相关操作
  - 会出现一些莫名的问题。使用 [NSOperationQueue mainQueue] 返回一个和主线程相关的队列，即主队列，这个 block 操作会被放在主线程中执行。使用
  - [[NSOperationQueue alloc] init] 返回的不是主队列，这个 block 操作不会被放在主线程中执行。
- 2）代理：
```
- (instancetype)initWithRequest:(NSURLRequest *)request delegate:(id)delegate;
+ (NSURLConnection*)connectionWithRequest:(NSURLRequest *)request delegate:(id)delegate;
```
  - 要监听服务器返回的 data，所以使用协议。
  - 当接收到服务器的响应（连通了服务器）时会调用：
```
- (void)connection:(NSURLConnection *)connection didReceiveResponse:(NSURLResponse *)response
```
  - 当接收到服务器的数据时会调用（可能会被调用多次，每次只传递部分数据，需要拼接接收到的所有数）：
```
- (void)connection:(NSURLConnection *)connection didReceiveData:(NSData *)data
```
  - 当服务器的数据加载完毕时就会调用：
```
- (void)connectionDidFinishLoading:(NSURLConnection *)connection
```
  - 请求错误（失败）的时候调用（请求超时\断网\没有网，一般指客户端错误）：
```
- (void)connection:(NSURLConnection *)connection didFailWithError:(NSError *)error
```
  - NSURLConnection 的代理方法默认都是在主线程上执行的，会对界面产生卡顿。
  - For the connection to work correctly, the calling thread’s run loop must be operating in the default run loop mode.
  - 为了让连接工作正常，调用线程的运行循环必须在默认的运行循环模式下。
  - 如果要让 NSURLConnection 实现在后台线程回调代理方法，需要在后台线程启动 NSURLConnection，并启动后台线程的运行循环，NSURLConnection
  - 执行完毕后，会自动停止后台线程的运行循环。
  - 启动子线程的运行循环方法：
```
CFRunLoopRun();
[[NSRunLoop currentRunLoop] run];        // NSRunLoop 只能启动，没有提供停止的接口
```
1.5 开始／停止网络连接
```
- (void)start;
- (void)cancel;
```
- 创建网络连接后可以不使用 start，系统会自动开始网络连接。
- 取消一个请求后，连接不在调用代理方法，如果希望再此连接，需要再次创建一个新的网络连接。
1.6 NSURLConnectionDownloadDelegate
- NSURLConnectionDownloadDelegate 代理方法是为 Newsstand Kit’s(杂志包) 创建的下载服务的，Newsstand 主要在国外使用比较广泛，国内极少。
- 如果使用 NSURLConnectionDownloadDelegate 代理方法监听下载进度，能够监听到进度，但是找不到下载的文件。

2、NSURLConnection 同步 GET 请求


// 设置网络接口
NSString *urlStr = @"http://192.168.88.200:8080/MJServer/video?type=JSON";

// 设置请求路径
NSURL *url = [NSURL URLWithString:urlStr];

NSURLRequest *urlRequest = [NSURLRequest requestWithURL:url];

// 创建同步网络请求
NSData *syncNetData = [NSURLConnection sendSynchronousRequest:urlRequest returningResponse:NULL error:NULL];

3、NSURLConnection 同步 POST 请求


// 设置网络接口
NSURL *url = [NSURL URLWithString:@"http://192.168.88.200:8080/MJServer/video"];

// 创建请求对象
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:url];

// 设置请求方式，默认为 GET 请求
urlRequest.HTTPMethod = @"POST";

// 设置请求体(请求参数)
urlRequest.HTTPBody = [@"type=JSON" dataUsingEncoding:NSUTF8StringEncoding];

// 创建同步网络请求
NSData *syncNetData = [NSURLConnection sendSynchronousRequest:urlRequest returningResponse:NULL error:NULL];

4、NSURLConnection 异步 GET 请求

4.1 使用 block 回调方式

// 设置网络接口
NSURL *url = [NSURL URLWithString:@"http://192.168.88.200:8080/MJServer/video?type=XML"];

// 创建请求对象
NSURLRequest *urlRequest = [NSURLRequest requestWithURL:url];

// 创建异步网络请求
[NSURLConnection sendAsynchronousRequest:urlRequest 
queue:[NSOperationQueue mainQueue] 
completionHandler:^(NSURLResponse *response, NSData *data, NSError *connectionError) {

    if (connectionError == nil && data != nil) {

    }
}];

4.2 使用协议方式

// 遵守协议 <NSURLConnectionDataDelegate>

@property(nonatomic, retain)NSMutableData *asyncNetData;

// 设置网络接口
NSURL *url = [NSURL URLWithString:@"http://192.168.88.200:8080/MJServer/video?type=XML"];

// 创建请求对象
NSURLRequest *urlRequest = [NSURLRequest requestWithURL:url];

// 创建异步网络请求
[NSURLConnection connectionWithRequest:urlRequest delegate:self];

// 协议方法

// 接收到服务器的响应
- (void)connection:(NSURLConnection *)connection didReceiveResponse:(NSURLResponse *)response {

    // 异步下载数据源初始化
    self.asyncNetData = [[NSMutableData alloc] init];
}

// 接收到服务器数据
- (void)connection:(NSURLConnection *)connection didReceiveData:(NSData *)data {

    // 拼接从服务器下载的数据
    [self.asyncNetData appendData:data];
}

// 服务器的数据加载完毕
- (void)connectionDidFinishLoading:(NSURLConnection *)connection {

    // 处理从服务器下载的数据
    self.textView.text = [[NSString alloc] initWithData:self.asyncNetData encoding:NSUTF8StringEncoding];
}

// 请求错误
- (void)connection:(NSURLConnection *)connection didFailWithError:(NSError *)error {

}

5、NSURLConnection 异步 POST 请求

5.1 使用 block 回调方式

// 设置网络接口
NSURL *url = [NSURL URLWithString:@"http://192.168.88.200:8080/MJServer/video"];

// 创建请求对象
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:url];

// 设置请求方式，默认为 GET 请求
urlRequest.HTTPMethod = @"POST";

// 设置请求体(请求参数)
urlRequest.HTTPBody = [@"type=XML" dataUsingEncoding:NSUTF8StringEncoding];

// 创建异步网络请求
[NSURLConnection sendAsynchronousRequest:urlRequest queue:[NSOperationQueue mainQueue] completionHandler:^(NSURLResponse *response, NSData *data, NSError *connectionError) {

    if (connectionError == nil && data != nil) {

    }
}];

5.2 使用协议方式

// 遵守协议 <NSURLConnectionDataDelegate>

// 设置网络接口
NSURL *url = [NSURL URLWithString:@"http://192.168.88.200:8080/MJServer/video"];

// 创建请求对象
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:url];

// 设置请求方式，默认为 GET 请求
urlRequest.HTTPMethod = @"POST";

// 设置请求体(请求参数)
urlRequest.HTTPBody = [@"type=XML" dataUsingEncoding:NSUTF8StringEncoding];

// 创建异步网络请求
[NSURLConnection connectionWithRequest:urlRequest delegate:self];

// 协议方法

// 已经发送请求体
- (void)connection:(NSURLConnection *)connection didSendBodyData:(NSInteger)bytesWritten totalBytesWritten:(NSInteger)totalBytesWritten totalBytesExpectedToWrite:(NSInteger)totalBytesExpectedToWrite {

}

// 接收到服务器的响应
- (void)connection:(NSURLConnection *)connection didReceiveResponse:(NSURLResponse *)response {

}

// 接收到服务器数据
- (void)connection:(NSURLConnection *)connection didReceiveData:(NSData *)data {

}

// 服务器的数据加载完毕
- (void)connectionDidFinishLoading:(NSURLConnection *)connection {

}

// 请求错误
- (void)connection:(NSURLConnection *)connection didFailWithError:(NSError *)error {

}

6、NSURLConnection 文件下载

6.1 获取文件信息


NSURL *url = [NSURL URLWithString:@"http://192.168.88.200/download/file/minion_02.mp4"];

NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];

// 使用 HEAD 请求方式
request.HTTPMethod = @"HEAD";

NSURLResponse *response = nil;
NSError *error = nil;

// 使用同步请求方式，后续的下载会依赖于此
[NSURLConnection sendSynchronousRequest:request returningResponse:&response error:&error];

if (error == nil && response != nil) {

    // 获取文件大小或名称
    NSLog(@"要下载文件的长度 %tu", response.expectedContentLength);
}

6.2 使用 GET 数据请求方式下载，文件句柄存储


// 下载文件的总长度
@property (nonatomic, assign) long long expectedContentLength;

// 当前文件大小
@property (nonatomic, assign) long long recvedfileLength;

NSURL *url = [NSURL URLWithString:@"http://192.168.88.200/download/file/minion_02.mp4"];
NSURLRequest *urlRequest = [NSURLRequest requestWithURL:url];

// 遵守协议 <NSURLConnectionDataDelegate>
[NSURLConnection connectionWithRequest:urlRequest delegate:self];

// 协议方法

- (void)connection:(NSURLConnection *)connection didReceiveResponse:(NSURLResponse *)response {

    NSString *documentsPath = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES)[0] stringByAppendingPathComponent:@"321.mp4"];

    // 如果文件不存在，方法不会出错
    [[NSFileManager defaultManager] removeItemAtPath:documentsPath error:NULL];

    // 获取数据总大小
    self.expectedContentLength = response.expectedContentLength;

    self.recvedfileLength = 0;
}

- (void)connection:(NSURLConnection *)connection didReceiveData:(NSData *)data {

    // 将从服务器下载的数据直接写入文件
    [self writeToFile:data];

    // 计算当前数据下载完成的大小
    self.recvedfileLength += data.length;

    // 计算下载进度   
    float progress = (float)self.recvedfileLength / self.expectedContentLength;
}

- (void)connectionDidFinishLoading:(NSURLConnection *)connection {

}

- (void)connection:(NSURLConnection *)connection didFailWithError:(NSError *)error {

}

// 将数据写入文件
- (void)writeToFile:(NSData *)data {

    /*
    NSFileManager：文件管理器，文件复制，删除，是否存在...操作，类似于在 Finder 中进行的操作
    NSFileHandle ：文件 "句柄(指针)" Handle 操纵杆，凡事看到 Handle 单词，表示对前面一个名词（File）的操作，
    对一个文件进行独立的操作。
    */

    NSString *documentsPath = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES)[0] stringByAppendingPathComponent:@"321.mp4"];

    // 打开文件，如果文件不存在，fp == nil
    NSFileHandle *fp = [NSFileHandle fileHandleForWritingAtPath:documentsPath];

    // 如果文件不存在
    if (fp == nil) {

        // 将数据直接写入文件
        [data writeToFile:documentsPath atomically:YES];
    } else {

        // 将文件指针移动到文件末尾
        [fp seekToEndOfFile];

        // 写入数据
        [fp writeData:data];

        // 关闭文件，C 语言中有一个默认的约定，凡事打开文件，都必须关闭
        [fp closeFile];
    }
}

6.3 使用 GET 数据请求方式下载，文件输出流存储


// 下载文件的总长度
@property (nonatomic, assign) long long expectedContentLength;

// 当前文件大小
@property (nonatomic, assign) long long recvedfileLength;

// 输出数据流
@property (nonatomic, strong) NSOutputStream *fileStream;

NSURL *url = [NSURL URLWithString:@"http://192.168.88.200/download/file/minion_02.mp4"];
NSURLRequest *urlRequest = [NSURLRequest requestWithURL:url];

// 遵守协议 <NSURLConnectionDataDelegate>
[NSURLConnection connectionWithRequest:urlRequest delegate:self];

// 协议方法

- (void)connection:(NSURLConnection *)connection didReceiveResponse:(NSURLResponse *)response {

    NSString *documentsPath = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES)[0] stringByAppendingPathComponent:@"312.mp4"];

    // 如果文件不存在，方法不会出错
    [[NSFileManager defaultManager] removeItemAtPath:documentsPath error:NULL];

    // 以拼接的方式实例化文件流
    self.fileStream = [[NSOutputStream alloc] initToFileAtPath:documentsPath append:YES];

    // 打开文件流
    [self.fileStream open];

    // 获取数据总大小
    self.expectedContentLength = response.expectedContentLength;

    self.recvedfileLength = 0;
}

- (void)connection:(NSURLConnection *)connection didReceiveData:(NSData *)data {

    // 将数据的 "字节"一次性写入文件流，并且指定数据长度
    [self.fileStream write:data.bytes maxLength:data.length];

    // 计算当前数据下载完成的大小
    self.recvedfileLength += data.length;

    // 计算下载进度   
    float progress = (float)self.recvedfileLength / self.expectedContentLength;
}

- (void)connectionDidFinishLoading:(NSURLConnection *)connection {

    // 关闭文件流
    [self.fileStream close];
}

- (void)connection:(NSURLConnection *)connection didFailWithError:(NSError *)error {

    // 关闭文件流
    [self.fileStream close];
}

6.4 使用专用下载方式


NSURL *url = [NSURL URLWithString:@"http://192.168.88.200/download/file/minion_01.mp4"];
NSURLRequest *urlRequest = [NSURLRequest requestWithURL:url];

// 遵守协议 <NSURLConnectionDownloadDelegate>
[NSURLConnection connectionWithRequest:urlRequest delegate:self];

// 协议方法

- (void)connection:(NSURLConnection *)connection didWriteData:(long long)bytesWritten totalBytesWritten:(long long)totalBytesWritten expectedTotalBytes:(long long)expectedTotalBytes {

    /*
    下载进度：

    bytesWritten            本次下载子节数
    totalBytesWritten       已经下载字节数
    expectedTotalBytes      总下载字节数(文件总大小)
    */

    float progress = (float)totalBytesWritten / expectedTotalBytes;
    NSLog(@"%f", progress);
}

- (void)connectionDidFinishDownloading:(NSURLConnection *)connection destinationURL:(NSURL *) destinationURL {

    /*
    destinationURL          下载保存的路径，下载完成之后，找不到下载的文件。
    */

    NSLog(@"%@", destinationURL);
}

6.5 断点续传下载


// 下载文件的总长度
@property (nonatomic, assign) long long expectedContentLength;

// 当前文件大小
@property (nonatomic, assign) long long recvedfileLength;

// 输出数据流
@property (nonatomic, strong) NSOutputStream *fileStream;

// 目标目录
@property (nonatomic, copy) NSString *targetPath;

@property (nonatomic, strong) NSURLConnection *conn;

NSURL *url = [NSURL URLWithString:@"http://192.168.88.200/download/file/minion_02.mp4"];

// 检查服务器上的文件信息
[self checkServerFileInfoWithURL:url];

// 检查本地文件信息
long long fileSize = [self checkLocalFileInfo];

// 文件已经下载到本地
if (fileSize == self.expectedContentLength) {

    return;
}

// 根据本地文件的长度，从对应 "偏移" 位置开始下载
[self downloadWithURL:url offset:fileSize];

// 检查服务器上的文件信息
- (void)checkServerFileInfoWithURL:(NSURL *)url {

    NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
    request.HTTPMethod = @"HEAD";

    NSURLResponse *response = nil;
    NSError *error = nil;

    // 发送同步方法
    [NSURLConnection sendSynchronousRequest:request returningResponse:&response error:&error];

    if (error == nil && response != nil) {

        // 文件大小
        self.expectedContentLength = response.expectedContentLength;

        // 文件名，保存到临时文件夹                                          
        self.targetPath = [NSTemporaryDirectory() stringByAppendingPathComponent:response.suggestedFilename];
    }
}

// 检查本地文件信息
- (long long)checkLocalFileInfo {

    long long fileSize = 0;

    // 检查本地是否存在文件
    if ([[NSFileManager defaultManager] fileExistsAtPath:self.targetPath]) {

        NSDictionary *dict = [[NSFileManager defaultManager] attributesOfItemAtPath:self.targetPath error:NULL];

        // 获取文件大小
        fileSize = [dict fileSize];
    }

    // 判断是否比服务器的文件大
    if (fileSize > self.expectedContentLength) {

        // 删除文件                                                                 
        [[NSFileManager defaultManager] removeItemAtPath:self.targetPath error:NULL];
        fileSize = 0;
    }

    return fileSize;
}

// 从断点处开始下载
- (void)downloadWithURL:(NSURL *)url offset:(long long)offset {

    // 记录本地文件大小
    self.recvedfileLength = offset;

    NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:url cachePolicy:1 timeoutInterval:15];

    // 一旦设置了 Range，response 的状态码会变成 206
    [urlRequest setValue:[NSString stringWithFormat:@"bytes=%lld-", offset] forHTTPHeaderField:@"Range"];

    // 遵守协议 <NSURLConnectionDataDelegate>
    self.conn = [NSURLConnection connectionWithRequest:urlRequest delegate:self];

    [self.conn start];
}

// 暂停下载
- (void)pause1 {

    [self.conn cancel];
}

// 协议方法
- (void)connection:(NSURLConnection *)connection didReceiveResponse:(NSURLResponse *)response {

    // 以拼接的方式实例化文件流
    self.fileStream = [[NSOutputStream alloc] initToFileAtPath:self.targetPath append:YES];
    [self.fileStream open];
}

- (void)connection:(NSURLConnection *)connection didReceiveData:(NSData *)data {

    // 将数据的 "字节"一次性写入文件流，并且指定数据长度
    [self.fileStream write:data.bytes maxLength:data.length];

    // 计算当前数据下载完成的大小
    self.recvedfileLength += data.length;

    // 计算下载进度                                                                 
    float progress = (float)self.recvedfileLength / self.expectedContentLength;
}

- (void)connectionDidFinishLoading:(NSURLConnection *)connection {

    [self.fileStream close];
}

- (void)connection:(NSURLConnection *)connection didFailWithError:(NSError *)error {

    // 关闭文件流
    [self.fileStream close];
}

6.6 异步下载


// 下载文件的总长度
@property (nonatomic, assign) long long expectedContentLength;

// 当前文件大小
@property (nonatomic, assign) long long recvedfileLength;

// 输出数据流
@property (nonatomic, strong) NSOutputStream *fileStream;

dispatch_async(dispatch_get_global_queue(0, 0), ^{

    NSURL *url = [NSURL URLWithString:@"http://192.168.88.200/download/file/minion_02.mp4"];
    NSURLRequest *urlRequest = [NSURLRequest requestWithURL:url];

    // 遵守协议 <NSURLConnectionDataDelegate>
    [NSURLConnection connectionWithRequest:urlRequest delegate:self];

    // 启动运行循环
    CFRunLoopRun();
});

// 协议方法
- (void)connection:(NSURLConnection *)connection didReceiveResponse:(NSURLResponse *)response {

    NSString *documentsPath = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES)[0] stringByAppendingPathComponent:@"312.mp4"];

    // 如果文件不存在，方法不会出错
    [[NSFileManager defaultManager] removeItemAtPath:documentsPath error:NULL];

    // 以拼接的方式实例化文件流
    self.fileStream = [[NSOutputStream alloc] initToFileAtPath:documentsPath append:YES];

    // 打开文件流
    [self.fileStream open];

    // 获取数据总大小
    self.expectedContentLength = response.expectedContentLength;

    self.recvedfileLength = 0;
}

- (void)connection:(NSURLConnection *)connection didReceiveData:(NSData *)data {

    // 将数据的 "字节"一次性写入文件流，并且指定数据长度
    [self.fileStream write:data.bytes maxLength:data.length];

    // 计算当前数据下载完成的大小
    self.recvedfileLength += data.length;

    // 计算下载进度   
    float progress = (float)self.recvedfileLength / self.expectedContentLength;
}   

- (void)connectionDidFinishLoading:(NSURLConnection *)connection {

    // 关闭文件流
    [self.fileStream close];
}

- (void)connection:(NSURLConnection *)connection didFailWithError:(NSError *)error {

    // 关闭文件流
    [self.fileStream close];
}

7、NSURLConnection 下载单例封装

7.1 QDownloaderOperation.h

@interface QDownloaderOperation : NSOperation

/// 类方法
+ (instancetype)downloaderWithURL:(NSURL *)url 
progress:(void (^)(float progress))progress 
successed:(void (^)(NSString *targetPath))successed 
failed:(void (^)(NSError *error))failed;

/// 暂停当前下载
- (void)pauseDownload;

/// 取消当前下载
- (void)cancelDownload;

@end

7.2 QDownloaderOperation.m

@interface QDownloaderOperation () <NSURLConnectionDataDelegate>

/// 下载文件总长度
@property (nonatomic, assign) long long expectedContentLength;

/// 已下载文件大小
@property (nonatomic, assign) long long recvedfileLength;

/// 下载目标目录
@property (nonatomic, copy) NSString *targetPath;

/// 下载文件输出数据流
@property (nonatomic, strong) NSOutputStream *fileStream;

/// block 属性
@property (nonatomic, copy) void (^progressBlock)(float);
@property (nonatomic, copy) void (^successedBlock)(NSString *);
@property (nonatomic, copy) void (^failedBlock)(NSError *);

/// 网络连接属性
@property (nonatomic, strong) NSURLConnection *conn;
@property (nonatomic, strong) NSURL *downloadURL;

@end

+ (instancetype)downloaderWithURL:(NSURL *)url progress:(void (^)(float))progress successed:(void (^)(NSString *))successed failed:(void (^)(NSError *))failed {

    QDownloaderOperation *downloader = [[self alloc] init];

    downloader.progressBlock = progress;
    downloader.successedBlock = successed;
    downloader.failedBlock = failed;

    downloader.downloadURL = url;

    return downloader;
}

- (void)main {
    @autoreleasepool {

        // 检查服务器上的文件信息
        [self checkServerFileInfoWithURL:self.downloadURL];

        if (self.isCancelled) return;

        // 检查本地文件信息
        long long fileSize = [self checkLocalFileInfo];

        if (fileSize == self.expectedContentLength) {

            // 下载完成的回调
            if (self.successedBlock) {
                dispatch_async(dispatch_get_main_queue(), ^{
                    self.successedBlock(self.targetPath);
                });

                // 下载进度的回调
                if (self.progressBlock) {
                    self.progressBlock(1.0);
                }
            }
            return;
        }

        // 根据本地文件的长度，从对应 "偏移" 位置开始下载
        [self downloadWithURL:self.downloadURL offset:fileSize];
    }
}

- (void)pauseDownload {

    // 取消一个请求，调用此方法后，连接不在调用代理方法
    [self.conn cancel];
}

- (void)cancelDownload {

    [self.conn cancel];
    [[NSFileManager defaultManager] removeItemAtPath:self.targetPath error:NULL];
}

/// 检查服务器上的文件信息
- (void)checkServerFileInfoWithURL:(NSURL *)url {

    NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
    request.HTTPMethod = @"HEAD";

    NSURLResponse *response = nil;
    NSError *error = nil;

    // 发送同步方法
    [NSURLConnection sendSynchronousRequest:request returningResponse:&response error:&error];

    if (error == nil && response != nil) {

        // 文件大小
        self.expectedContentLength = response.expectedContentLength;

        // 文件名
        self.targetPath = [NSTemporaryDirectory() stringByAppendingPathComponent:response.suggestedFilename];
    }
}

/// 检查本地文件信息

- (long long)checkLocalFileInfo {

    long long fileSize = 0;

    // 检查本地是否存在文件
    if ([[NSFileManager defaultManager] fileExistsAtPath:self.targetPath]) {
        NSDictionary *dict = [[NSFileManager defaultManager] attributesOfItemAtPath:self.targetPath error:NULL];

        // 获取文件大小
        fileSize = [dict fileSize];
    }

    // 判断是否比服务器的文件大
    if (fileSize > self.expectedContentLength) {

        // 删除文件
        [[NSFileManager defaultManager] removeItemAtPath:self.targetPath error:NULL];
        fileSize = 0;
    }

    return fileSize;
}

/// 从断点处开始下载
- (void)downloadWithURL:(NSURL *)url offset:(long long)offset {

    // 记录本地文件大小
    self.recvedfileLength = offset;

    NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:url cachePolicy:1 timeoutInterval:15];

    // 一旦设置了 Range，response 的状态码会变成 206
    [urlRequest setValue:[NSString stringWithFormat:@"bytes=%lld-", offset] forHTTPHeaderField:@"Range"];

    // 遵守协议 <NSURLConnectionDataDelegate>
    self.conn = [NSURLConnection connectionWithRequest:urlRequest delegate:self];

    [self.conn start];

    // 开启子线程运行循环
    CFRunLoopRun();
}

/// 协议方法

- (void)connection:(NSURLConnection *)connection didReceiveResponse:(NSURLResponse *)response {

    // 以拼接的方式实例化文件流
    self.fileStream = [[NSOutputStream alloc] initToFileAtPath:self.targetPath append:YES];

    // 打开文件流
    [self.fileStream open];
}

- (void)connection:(NSURLConnection *)connection didReceiveData:(NSData *)data {

    // 将数据的 "字节" 一次性写入文件流，并且指定数据长度
    [self.fileStream write:data.bytes maxLength:data.length];

    // 计算当前数据下载完成的大小
    self.recvedfileLength += data.length;

    // 计算下载进度
    float progress = (float)self.recvedfileLength / self.expectedContentLength;

    // 进度的回调
    if (self.progressBlock) {
        self.progressBlock(progress);
    }
}

- (void)connectionDidFinishLoading:(NSURLConnection *)connection {

    // 关闭文件流
    [self.fileStream close];

    // 完成的回调
    if (self.successedBlock) {

        // 主线程回调
        dispatch_async(dispatch_get_main_queue(), ^{
            self.successedBlock(self.targetPath);
        });
    }
}

- (void)connection:(NSURLConnection *)connection didFailWithError:(NSError *)error {

    // 关闭文件流
    [self.fileStream close];

    // 失败的回调
    if (self.failedBlock) {
        self.failedBlock(error);
    }
}

7.3 QDownloaderManager.h

@interface QDownloaderManager : NSObject

/// 单例
+ (instancetype)sharedManager;

/// 开始下载
- (void)downloadWithURL:(NSURL *)url progress:(void (^)(float progress))progress successed:(void (^)(NSString *targetPath))successed failed:(void (^)(NSError *error))failed;

/// 暂停下载
- (void)pauseWithURL:(NSURL *)url;

/// 取消下载
- (void)cancelWithURL:(NSURL *)url;

@end

7.4 QDownloaderManager.m

@interface QDownloaderManager ()

/// 下载操作缓冲池
@property (nonatomic, strong) NSMutableDictionary *downloadCache;

/// 下载操作队列
@property (nonatomic, strong) NSOperationQueue *downloadQueue;

@end

+ (instancetype)sharedManager {
    static id instance;

    static dispatch_once_t onceToken;
    dispatch_once(&onceToken, ^{
        instance = [[self alloc] init];
    });

    return instance;
}

- (void)downloadWithURL:(NSURL *)url progress:(void (^)(float))progress successed:(void (^)(NSString *))successed failed:(void (^)(NSError *))failed {

    // 检查缓冲池中是否有下载，如果有，直接返回
    if (self.downloadCache[url.absoluteString] != nil) {
        NSLog(@"正在在玩命下载中...");
        return;
    }

    QDownloaderOperation *downloader = [QDownloaderOperation downloaderWithURL:url progress:progress successed:^(NSString *targetPath) {

        // 删除下载操作
        [self.downloadCache removeObjectForKey:url.absoluteString];

        if (successed != nil) {
            successed(targetPath);
        }

    } failed:^(NSError *error) {

        [self.downloadCache removeObjectForKey:url.absoluteString];

        if (failed != nil) {
            failed(error);
        }
    }];

    // 添加到缓冲池
    [self.downloadCache setObject:downloader forKey:url.absoluteString];
    // 添加到队列
    [self.downloadQueue addOperation:downloader];
}

- (void)pauseWithURL:(NSURL *)url {

    // 判断缓冲池中是否有对应的下载操作
    QDownloaderOperation *downloader = self.downloadCache[url.absoluteString];

    if (downloader != nil) {

        // 暂停 downloader 内部的 NSURLConnection
        [downloader pauseDownload];

        // 给操作发送取消消息 NSOperation
        [downloader cancel];

        // 从缓冲池中清除
        [self.downloadCache removeObjectForKey:url.absoluteString];
    }
}

- (void)cancelWithURL:(NSURL *)url {

    // 判断缓冲池中是否有对应的下载操作
    QDownloaderOperation *downloader = self.downloadCache[url.absoluteString];

    if (downloader != nil) {

        // 取消 downloader 内部的 NSURLConnection
        [downloader cancelDownload];

        // 给操作发送取消消息 NSOperation
        [downloader cancel];

        // 从缓冲池中清除
        [self.downloadCache removeObjectForKey:url.absoluteString];
    }
}

/// 懒加载

- (NSMutableDictionary *)downloadCache {
    if (_downloadCache == nil) {
        _downloadCache = [NSMutableDictionary dictionary];
    }
    return _downloadCache;
}

- (NSOperationQueue *)downloadQueue {
    if (_downloadQueue == nil) {
        _downloadQueue = [[NSOperationQueue alloc] init];

        // 设置最大并发数
        _downloadQueue.maxConcurrentOperationCount = 5;
    }
    return _downloadQueue;
}

7.5 ViewController.m

// 下载进度
@property (weak, nonatomic) IBOutlet UIProgressView *progressView;

@property (nonatomic, strong) NSURL *url;

// 开始下载

NSURL *url = [NSURL URLWithString:@"http://120.25.226.186:32812/resources/videos/minion_01.mp4"];
self.url = url;

[[QDownloaderManager sharedManager] downloadWithURL:url progress:^(float progress) {

    dispatch_async(dispatch_get_main_queue(), ^{

        self.progressView.progress = progress;
    });

    } successed:^(NSString *targetPath) {

        NSLog(@"%@", targetPath);

    } failed:^(NSError *error) {

        NSLog(@"%@", error);
}];

// 暂停下载

[[QDownloaderManager sharedManager] pauseWithURL:self.url];

// 取消下载

[[QDownloaderManager sharedManager] cancelWithURL:self.url];

码农公寓

前言

1、NSURLConnection

1.1 NSURLConnection 的常用类

1.2 使用 NSURLConnection 发送请求的步骤

1.3 发送同步请求

1.4 发送异步请求

1）使用 block 回调：

2）代理：

1.5 开始／停止网络连接

1.6 NSURLConnectionDownloadDelegate

2、NSURLConnection 同步 GET 请求

3、NSURLConnection 同步 POST 请求

4、NSURLConnection 异步 GET 请求

4.1 使用 block 回调方式

4.2 使用 协议 方式

5、NSURLConnection 异步 POST 请求

5.1 使用 block 回调方式

5.2 使用 协议 方式

6、NSURLConnection 文件下载

6.1 获取文件信息

6.2 使用 GET 数据请求方式下载，文件句柄存储

6.3 使用 GET 数据请求方式下载，文件输出流存储

6.4 使用 专用下载 方式

6.5 断点续传下载

6.6 异步下载

7、NSURLConnection 下载单例封装

7.1 QDownloaderOperation.h

7.2 QDownloaderOperation.m

7.3 QDownloaderManager.h

7.4 QDownloaderManager.m

7.5 ViewController.m

相关文章

4.2 使用协议方式

5.2 使用协议方式

6.4 使用专用下载方式