IOS NSURLConnection（大文件下载）

NSURL：请求地址

NSURLRequest：一个NSURLRequest对象就代表一个请求，它包含的信息有
一个NSURL对象
请求方法、请求头、请求体
请求超时
… …

NSMutableURLRequest：NSURLRequest的子类

NSURLConnection
负责发送请求，建立客户端和服务器的连接
发送NSURLRequest的数据给服务器，并收集来自服务器的响应数据

NSURLConnection的使用步骤

使用NSURLConnection发送请求的步骤很简单
创建一个NSURL对象，设置请求路径
传入NSURL创建一个NSURLRequest对象，设置请求头和请求体
使用NSURLConnection发送NSURLRequest

NSURLConnection发送请求

NSURLConnection常见的发送请求方法有以下几种
同步请求
+ (NSData *)sendSynchronousRequest:(NSURLRequest *)request returningResponse:(NSURLResponse **)response
 error:(NSError **)error;

异步请求：根据对服务器返回数据的处理方式的不同，又可以分为2种
block回调
+ (void)sendAsynchronousRequest:(NSURLRequest*) request  queue:(NSOperationQueue*) queue 
 completionHandler:(void (^)(NSURLResponse* response, NSData* data, NSError* connectionError)) handler;

代理
- (id)initWithRequest:(NSURLRequest *)request delegate:(id)delegate;
+ (NSURLConnection*)connectionWithRequest:(NSURLRequest *)request delegate:(id)delegate;
- (id)initWithRequest:(NSURLRequest *)request delegate:(id)delegate startImmediately:(BOOL)startImmediately;

在startImmediately = NO的情况下，需要调用start方法开始发送请求
- (void)start;

成为NSURLConnection的代理，最好遵守NSURLConnectionDataDelegate协议

NSURLConnectionDelegate

NSURLConnectionDataDelegate协议中的代理方法
开始接收到服务器的响应时调用
- (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;

NSMutableURLRequest

NSMutableURLRequest是NSURLRequest的子类，常用方法有
设置请求超时等待时间（超过这个时间就算超时，请求失败）
- (void)setTimeoutInterval:(NSTimeInterval)seconds;

设置请求方法（比如GET和POST）
- (void)setHTTPMethod:(NSString *)method;

设置请求体
- (void)setHTTPBody:(NSData *)data;

设置请求头
- (void)setValue:(NSString *)value forHTTPHeaderField:(NSString *)field;

创建GET和POST请求

创建GET请求
NSString *urlStr = [@"http://192.168.1.102:8080/MJServer/login?username=123&pwd=123" 
stringByAddingPercentEscapesUsingEncoding:NSUTF8StringEncoding];
NSURL *url = [NSURL URLWithString:urlStr];
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];

创建POST请求
NSString *urlStr = @"http://192.168.1.102:8080/MJServer/login";
NSURL *url = [NSURL URLWithString:urlStr];
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
request.HTTPMethod = @"POST";
// 请求体
NSString *bodyStr = @"username=123&pwd=123";
request.HTTPBody = [bodyStr dataUsingEncoding:NSUTF8StringEncoding];

发送JSON给服务器

如何发送JSON给服务器
一定要使用POST请求
设置请求头
[request setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];
设置JSON数据为请求体

多值参数
有时候一个参数名，可能会对应多个值
http://192.168.1.103:8080/MJServer/weather?place=北京&place=河南&place=湖南
服务器的place属性是一个数组

一、大文件下载

1.方案：利用NSURLConnection和它的代理方法
1> 发送一个请求
// 1.URL
NSURL *url = [NSURL URLWithString:@"http://localhost:8080/MJServer/resources/videos.zip"];
// 2.请求
NSURLRequest *request = [NSURLRequest requestWithURL:url];
// 3.下载(创建完conn对象后，会自动发起一个异步请求)
[NSURLConnection connectionWithRequest:request delegate:self];

2> 在代理方法中处理服务器返回的数据
/**
 在接收到服务器的响应时：
 1.创建一个空的文件
 2.用一个句柄对象关联这个空的文件，目的是：方便后面用句柄对象往文件后面写数据
 */
- (void)connection:(NSURLConnection *)connection didReceiveResponse:(NSURLResponse *)response
{
    // 文件路径
    NSString *caches = [NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES) lastObject];
    NSString *filepath = [caches stringByAppendingPathComponent:@"videos.zip"];
    
    // 创建一个空的文件 到 沙盒中
    NSFileManager *mgr = [NSFileManager defaultManager];
    [mgr createFileAtPath:filepath contents:nil attributes:nil];
    
    // 创建一个用来写数据的文件句柄
    self.writeHandle = [NSFileHandle fileHandleForWritingAtPath:filepath];
}

/**
 在接收到服务器返回的文件数据时，利用句柄对象往文件的最后面追加数据
 */
- (void)connection:(NSURLConnection *)connection didReceiveData:(NSData *)data
{
    // 移动到文件的最后面
    [self.writeHandle seekToEndOfFile];
    
    // 将数据写入沙盒
    [self.writeHandle writeData:data];
}

/**
 在所有数据接收完毕时，关闭句柄对象
 */
- (void)connectionDidFinishLoading:(NSURLConnection *)connection
{
    // 关闭文件
    [self.writeHandle closeFile];
    self.writeHandle = nil;
}

2.注意点：千万不能用NSMutableData来拼接服务器返回的数据

二、NSURLConnection发送异步请求的方法

1.block形式 - 除开大文件下载以外的操作，都可以用这种形式
[NSURLConnection sendAsynchronousRequest:<#(NSURLRequest *)#> queue:<#(NSOperationQueue *)#> completionHandler:^(NSURLResponse *response, NSData *data, NSError *connectionError) {
    
}];

2.代理形式 - 一般用在大文件下载
// 1.URL
NSURL *url = [NSURL URLWithString:@"http://localhost:8080/MJServer/login?username=123&pwd=123"];
// 2.请求
NSURLRequest *request = [NSURLRequest requestWithURL:url];
// 3.下载(创建完conn对象后，会自动发起一个异步请求)
[NSURLConnection connectionWithRequest:request delegate:self];