/*--------------------- 01? NSURLSession -------------------*/
重點(diǎn):1.NSURLSession的使用 2.熟練掌握 NSURLSession
{
<1> NSURLSession 簡(jiǎn)介:
{
NSURLSession 是 iOS 7.0 之后推出的網(wǎng)絡(luò)解決方案!用于替代 NSURLConnection,? 針對(duì)下載/上傳等復(fù)雜的網(wǎng)絡(luò)操作提供了專門的解決方案!
NSURLSession 使用更加簡(jiǎn)單/方便!
}
<2> NSURLSession 中新增的內(nèi)容:
{
1> 全局的 NSURLSession 對(duì)象: 所有的網(wǎng)絡(luò)會(huì)話都由一個(gè) NSURLSession 對(duì)象發(fā)起, 實(shí)例化一個(gè) NSURLSession 對(duì)象有兩種方法:
{
*1 對(duì)于簡(jiǎn)單的,不需要監(jiān)聽網(wǎng)絡(luò)請(qǐng)求過程的網(wǎng)絡(luò)會(huì)話來說,使用系統(tǒng)提供的,全局的 NSURLSession 單利對(duì)象:
NSURLSession *session = [NSURLSession sharedSession];
*2 如果需要監(jiān)聽網(wǎng)絡(luò)進(jìn)度,需要自定義一個(gè) NSURLSession 對(duì)象,并且設(shè)置代理!這時(shí)還需要一個(gè) NSURLSessionConfiguration,可以設(shè)置全局的網(wǎng)絡(luò)訪問屬性.
NSURLSessionConfiguration *cfg = [NSURLSessionConfiguration defaultSessionConfiguration];
NSURLSession *session = [NSURLSession sessionWithConfiguration:cfg delegate:self delegateQueue:[NSOperationQueue mainQueue]];
}
2> 網(wǎng)絡(luò)任務(wù)(Task);在 NSURLSession 中,有三種網(wǎng)絡(luò)任務(wù)類型.
{
*1 用于非文件下載的普通的 GET/POST請(qǐng)求 NSURLSessionDataTask.實(shí)例化對(duì)象有以下2種方法:
{
// 1> 通過一個(gè) request 實(shí)例化普通網(wǎng)絡(luò)任務(wù),增加完成之后的 block 回調(diào),使用比較多.
NSURLSessionDataTask *task = [self.session dataTaskWithRequest:request completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
}];
// 2> 通過一個(gè) url 實(shí)例化普通網(wǎng)絡(luò)任務(wù),增加完成之后的 block 回調(diào),使用比較多.
NSURLSessionDataTask *task = [self.session dataTaskWithURL:url completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
}];
}
*2 用于文件下載的網(wǎng)絡(luò)任務(wù) NSURLSessionDownloadTask (無論文件大小,下載都使用 NSURLSessionDownloadTask) ,實(shí)例化對(duì)象有以下三種方法:
{
// 1> 通過一個(gè) request 實(shí)例化下載網(wǎng)絡(luò)任務(wù),增加任務(wù)完成之后的 block 回調(diào),一般用在小文件下載.
NSURLSessionDownloadTask *task = [self.session downloadTaskWithRequest:request completionHandler:^(NSURL *location, NSURLResponse *response, NSError *error) {
}];
// 2> 通過一個(gè) url 實(shí)例化下載網(wǎng)絡(luò)任務(wù),增加任務(wù)完成之后的 block 回調(diào),一般用在小文件下載.
NSURLSessionDownloadTask *task = [self.session downloadTaskWithURL:url completionHandler:^(NSURL *location, NSURLResponse *response, NSError *error) {
}];
// 3> 通過之前下載的數(shù)據(jù) ResumeData ,實(shí)例化一個(gè)下載任務(wù),用于斷點(diǎn)續(xù)傳.
NSURLSessionDownloadTask *task = [session downloadTaskWithResumeData:ResumeData completionHandler:^(NSURL *location, NSURLResponse *response, NSError *error) {
}];
}
*3 用于文件上傳的網(wǎng)絡(luò)任務(wù) NSURLSessionUploadTask.
{
// 目前,只有通過這種方式實(shí)例化的下載任務(wù),才能實(shí)現(xiàn)文件上傳.依然需要拼接數(shù)據(jù).
NSURLSessionUploadTask *task = [session uploadTaskWithRequest:request fromData:fromData completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
//
}]
}
}
}
<3> NSURLSession 的使用分為三步:
{
1> 實(shí)例化一個(gè) NSURLSession 對(duì)象 session ;
NSURLSession *session = [NSURLSession sharedSession];
2> 通過 NSURLSession 對(duì)象,實(shí)例化對(duì)應(yīng)的網(wǎng)絡(luò)任務(wù) task;
NSURLSessionDataTask *task = [session dataTaskWithRequest:request];
3> 開啟網(wǎng)絡(luò)任務(wù)
[task resume];
}
}
/*-----------------? 02 NSURLSession 下載的斷點(diǎn)續(xù)傳 ------------------*/
重點(diǎn):1.學(xué)會(huì)使用 NSULSession 實(shí)現(xiàn)下載任務(wù). 2.實(shí)時(shí)監(jiān)聽下載進(jìn)度,學(xué)會(huì)使用斷點(diǎn)續(xù)傳.
{? ?
?利用 NSURLSession 實(shí)現(xiàn)文件下載,首先需要?jiǎng)?chuàng)建一個(gè) NSURLSessionDownloadTask; 由于需要實(shí)時(shí)監(jiān)聽下載進(jìn)度,所以,需要實(shí)現(xiàn)方法,這樣,就需要自定義一個(gè)會(huì)話 session.并且制定代理.
// NSURLSession 下載的斷點(diǎn)續(xù)傳實(shí)現(xiàn)步驟:
1. 懶加載全局網(wǎng)絡(luò)會(huì)話
{
-(NSURLSession *)session
{
if (!_session) {
NSURLSessionConfiguration *config = [NSURLSessionConfiguration defaultSessionConfiguration];
_session = [NSURLSession sessionWithConfiguration:config delegate:self delegateQueue:nil];
}
return _session;
}
}
2. 利用全局網(wǎng)絡(luò)會(huì)話,創(chuàng)建下載 task, 開始下載任務(wù)
{
self.task = [self.session downloadTaskWithURL:url];
[self.task resume];
}
3. 在代理方法中,實(shí)時(shí)監(jiān)聽下載進(jìn)度
{
// 監(jiān)聽下載進(jìn)度的方法
// bytesWritten :本次下載的字節(jié)數(shù)
// totalBytesWritten :已經(jīng)下載的字節(jié)數(shù)
// totalBytesExpectedToWrite :下載文件的總字節(jié)數(shù)
-(void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didWriteData:(int64_t)bytesWritten totalBytesWritten:(int64_t)totalBytesWritten totalBytesExpectedToWrite:(int64_t)totalBytesExpectedToWrite
{
NSLog(@"代理回調(diào)~");
float progress = (float)totalBytesWritten/totalBytesExpectedToWrite;
dispatch_async(dispatch_get_main_queue(), ^{
self.progress.progress = progress;
});
}
// 完成下載的時(shí)候調(diào)用
-(void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didFinishDownloadingToURL:(NSURL *)location
{
NSLog(@"下載完成%@",location);
}
// 斷點(diǎn)續(xù)傳的代理方法,暫時(shí)什么都不寫
-(void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didResumeAtOffset:(int64_t)fileOffset expectedTotalBytes:(int64_t)expectedTotalBytes
{
NSLog(@"%s",__FUNCTION__);
}
}
4. 當(dāng)點(diǎn)擊暫停之后,應(yīng)該取消下載任務(wù),記錄當(dāng)前下載的文件數(shù)據(jù),并且將 task 任務(wù)設(shè)為 nil
{
[self.task cancelByProducingResumeData:^(NSData *resumeData) {
self.reusemData = resumeData;
self.task = nil;
}];
}
5. 當(dāng)點(diǎn)擊繼續(xù)之后,應(yīng)該從上次下載的進(jìn)度繼續(xù)下載,這時(shí),重新創(chuàng)建下載 task, 并且是根據(jù)上次記錄的文件下載數(shù)據(jù)來實(shí)例化下載任務(wù)
{
if (!self.reusemData) {
return;
}
self.task = [self.session downloadTaskWithResumeData:self.reusemData];
self.reusemData = nil;
[self.task resume];
}
}
/*--------------------- 03 NSURLSession 實(shí)現(xiàn)上傳文件 -----------------*/
重點(diǎn):1.學(xué)會(huì)使用 NSURLSession 實(shí)現(xiàn)文件上傳.
{
NSURLSession 上傳文件和 NSURLConnection 一樣需要按格式拼接文件數(shù)據(jù).重要的是要學(xué)會(huì)封裝方法,具體使用如下:
{
// NSURLSession 做文件上傳
- (void)uploadMfileSession
{
// 1.實(shí)例化全局網(wǎng)絡(luò)會(huì)話
NSURLSession *session = [NSURLSession sharedSession];
// 2.創(chuàng)建網(wǎng)絡(luò)請(qǐng)求
{
NSURL *url = [NSURL URLWithString:@"http://localhost/upload/upload-m.php"];
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
// 設(shè)置請(qǐng)求方法
request.HTTPMethod = @"POST";
// 告訴服務(wù)器,需要做文件上傳
NSString *contentType = [NSString stringWithFormat:@"multipart/form-data; boundary=%@",kBOUNDARY];
[request setValue:contentType forHTTPHeaderField:@"Content-Type"];
}
// 3. 將需要上傳至服務(wù)器的文件包裝在字典中.
{
// 需要上傳的文件路徑
NSString *file1 = @"/Users/likaining/Desktop/meinv.jpg";
NSString *file2 = @"/Users/likaining/Downloads/XMLdemo.xml";
// 文件在服務(wù)器中保存的名稱
NSString *fileName1 = @"meinv";
NSString *fileName2 = @"demo";
// 將上傳數(shù)據(jù)包裝在字典中
NSMutableDictionary *fileDict = [NSMutableDictionary dictionary];
[fileDict setObject:file1 forKey:fileName1];
[fileDict setObject:file2 forKey:fileName2];
}
// 4. 將需要上傳的非文件數(shù)據(jù)也包裝在字典中
{
NSMutableDictionary *parameter = [NSMutableDictionary dictionary];
[parameter setObject:@"likaining" forKey:@"username"];
}
// 5. 將需要上傳的數(shù)據(jù),按照上傳的數(shù)據(jù)格式化數(shù)據(jù).并且轉(zhuǎn)為二進(jìn)制數(shù)據(jù).
NSData *dataM = [self formDataWithfileName:@"userfile[]" fileDict:fileDict parameter:parameter];
// 6. 利用網(wǎng)絡(luò)會(huì)話,建立上傳任務(wù)
NSURLSessionUploadTask *task = [session uploadTaskWithRequest:request fromData:dataM completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
//
NSLog(@"%@",[[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding]);
NSLog(@"response: %@",response);
}];
// 7 .開始上傳.
[task resume];
}
// 格式化上傳數(shù)據(jù)的方法封裝.
- (NSData *) formDataWithfileName:(NSString *)fileName fileDict:(NSDictionary *)fileDict parameter:(NSDictionary *)parameter
{
NSMutableData *data = [NSMutableData data];
// key : 服務(wù)器保存的文件名
// obj : 上傳的文件地址
[fileDict enumerateKeysAndObjectsUsingBlock:^(id key, id obj, BOOL *stop) {
//
NSMutableString *headerStrM = [NSMutableString stringWithFormat:@"\r\n--%@\r\n",kBOUNDARY];
[headerStrM appendFormat:@"Content-Disposition: form-data; name=%@; filename=%@\r\n",fileName,key];
NSString *contentType = [self getContentTypeFromFile:obj];
[headerStrM appendFormat:@"Content-Type: %@\r\n\r\n",contentType];
NSData *headerData = [headerStrM dataUsingEncoding:NSUTF8StringEncoding];
NSData *fileData = [NSData dataWithContentsOfFile:obj];
[data appendData:headerData];
[data appendData:fileData];
}];
// key :username 服務(wù)器接收的 key
// obj :上傳文件的人
[parameter enumerateKeysAndObjectsUsingBlock:^(id key, id obj, BOOL *stop) {
//
NSMutableString *headerM = [NSMutableString stringWithFormat:@"\r\n--%@\r\n",kBOUNDARY];
[headerM appendFormat:@"Content-Disposition: form-data; name=%@\r\n\r\n",key];
NSString *username = obj;
NSData *headerData = [headerM dataUsingEncoding:NSUTF8StringEncoding];
NSData *userData = [username dataUsingEncoding:NSUTF8StringEncoding];
[data appendData:headerData];
[data appendData:userData];
}];
NSMutableString *footerStrM = [NSMutableString stringWithFormat:@"\r\n--%@--\r\n",kBOUNDARY];
NSData *footerData = [footerStrM dataUsingEncoding:NSUTF8StringEncoding];
[data appendData:footerData];
return data;
}
}
}
/*------------------- 04 文件的復(fù)制和剪切 ----------------------*/
重點(diǎn):掌握文件操作中的復(fù)制和剪切.
{
文件下載到本地之后,有時(shí)候需要對(duì)文件進(jìn)行移動(dòng)操作,這樣就需要掌握掌握文件的復(fù)制和剪切操作.
1.文件的拷貝
// 新建一個(gè)文件路徑
NSString *path = @"/Users/likaining/Desktop/abc/";
// 從一個(gè)文件路徑拷貝文件到另一個(gè)文件路徑
// AtPath : 拷貝前的文件路徑
// ToPath : 拷貝后的文件路徑
[[NSFileManager defaultManager] copyItemAtPath:location.path toPath:path error:0];
2.文件的剪切
// response.suggestedFilename:建議使用的文件名,一般跟服務(wù)器端的文件名一致
NSString *file = [caches stringByAppendingPathComponent:downloadTask.response.suggestedFilename];
// 將臨時(shí)文件剪切到Caches文件夾
// AtPath : 剪切前的文件路徑
// ToPath : 剪切后的文件路徑
[[NSFileManager defaultManager] moveItemAtPath:location.path toPath:file error:nil];
}
/*------------------------- 05 文件的解壓縮---------------------*/
重點(diǎn):掌握文件的解壓縮操作,會(huì)使用解壓縮框架.
{
為了方便網(wǎng)絡(luò)傳輸,文件經(jīng)常被壓縮之后再進(jìn)行網(wǎng)絡(luò)傳輸,這個(gè)時(shí)候,需要學(xué)會(huì)解壓縮文件.
1.文件的解壓縮需要導(dǎo)入第三方框架: SSZipArchive ,需要注意的是,這個(gè)框架依賴一個(gè)動(dòng)態(tài)度 libz.dylib.
2. 壓縮文件:
// 1.獲得需要壓縮的文件夾
NSString *images = [caches stringByAppendingPathComponent:@"images"];
// 1.創(chuàng)建一個(gè)zip文件（壓縮）
NSString *zipFile = [caches stringByAppendingPathComponent:@"images.zip"];
BOOL result = [SSZipArchive createZipFileAtPath:zipFile withContentsOfDirectory:images];
3. 解壓縮文件:
// location.path:需要解壓縮的文件
// 文件解壓縮之后存放的路徑(注意,只需要給出一個(gè)文件路徑就可以,因?yàn)楹芸赡芙鈮嚎s之后,生成很多個(gè)文件).
[SSZipArchive unzipFileAtPath:location.path toDestination:path];
}
? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? NSURLSessionConfiguration
NSURLSessionConfiguration對(duì)象用于初始化NSURLSession對(duì)象。
展開請(qǐng)求級(jí)別中與NSMutableURLRequest相關(guān)的可供選擇的方案，我們可以看到NSURLSessionConfiguration對(duì)于會(huì)話如何產(chǎn)生請(qǐng)求，提供了相當(dāng)多的控制和靈活性。從網(wǎng)絡(luò)訪問性能，到cookie，安全性，緩存策略，自定義協(xié)議，啟動(dòng)事件設(shè)置，以及用于移動(dòng)設(shè)備優(yōu)化的幾個(gè)新屬性，你會(huì)發(fā)現(xiàn)你一直在尋找的，正是NSURLSessionConfiguration。
會(huì)話在初始化時(shí)復(fù)制它們的配置，NSURLSession有一個(gè)只讀的配置屬性，使得該配置對(duì)象上的變化對(duì)這個(gè)會(huì)話的政策無效。配置在初始化時(shí)被讀取一次，之后都是不會(huì)變化的。
－構(gòu)造方法
NSURLSessionConfiguration有三個(gè)類構(gòu)造函數(shù)，這很好地說明了NSURLSession是為不同的用例而設(shè)計(jì)的。
+ "defaultSessionConfiguration"返回標(biāo)準(zhǔn)配置，這實(shí)際上與NSURLConnection的網(wǎng)絡(luò)協(xié)議棧是一樣的，具有相同的共享NSHTTPCookieStorage，共享NSURLCache和共享NSURLCredentialStorage。
+ "ephemeralSessionConfiguration"返回一個(gè)預(yù)設(shè)配置，沒有持久性存儲(chǔ)的緩存，Cookie或證書。這對(duì)于實(shí)現(xiàn)像"秘密瀏覽"功能的功能來說，是很理想的。
+ "backgroundSessionConfiguration"：獨(dú)特之處在于，它會(huì)創(chuàng)建一個(gè)后臺(tái)會(huì)話。后臺(tái)會(huì)話不同于常規(guī)的，普通的會(huì)話，它甚至可以在應(yīng)用程序掛起，退出，崩潰的情況下運(yùn)行上傳和下載任務(wù)。初始化時(shí)指定的標(biāo)識(shí)符，被用于向任何可能在進(jìn)程外恢復(fù)后臺(tái)傳輸?shù)氖刈o(hù)進(jìn)程提供上下文。
想要查看更多關(guān)于后臺(tái)會(huì)話的信息，可以查看WWDC Session 204: “What’s New with Multitasking”
－NSURLSessionConfiguration的屬性
NSURLSessionConfiguration擁有20個(gè)屬性。熟練掌握這些屬性的用處，將使應(yīng)用程序充分利用其網(wǎng)絡(luò)環(huán)境。
最重要的屬性：
# 替代 request 中的 forHTTPHeaderField 告訴服務(wù)器有關(guān)客戶端的附加信息
"HTTPAdditionalHeaders"指定了一組默認(rèn)的可以設(shè)置出站請(qǐng)求的數(shù)據(jù)頭。這對(duì)于跨會(huì)話共享信息，如內(nèi)容類型，語言，用戶代理，身份認(rèn)證，是很有用的。
# WebDav的身份驗(yàn)證
NSString *userPasswordString = [NSString stringWithFormat:@"%@:%@", user, password];
NSData * userPasswordData = [userPasswordString dataUsingEncoding:NSUTF8StringEncoding];
NSString *base64EncodedCredential = [userPasswordData base64EncodedStringWithOptions:0];
NSString *authString = [NSString stringWithFormat:@"Basic: %@", base64EncodedCredential];
# 設(shè)置客戶端類型
NSString *userAgentString = @"iPhone AppleWebKit";
configuration.HTTPAdditionalHeaders = @{@"Accept": @"application/json",
@"Accept-Language": @"en",
@"Authorization": authString,
@"User-Agent": userAgentString};
"networkServiceType（網(wǎng)絡(luò)服務(wù)類型）"對(duì)標(biāo)準(zhǔn)的網(wǎng)絡(luò)流量，網(wǎng)絡(luò)電話，語音，視頻，以及由一個(gè)后臺(tái)進(jìn)程使用的流量進(jìn)行了區(qū)分。大多數(shù)應(yīng)用程序都不需要設(shè)置這個(gè)
"allowsCellularAccess（允許蜂窩訪問）"和"discretionary（自行決定）"被用于節(jié)省通過蜂窩連接的帶寬。建議在使用后臺(tái)傳輸?shù)臅r(shí)候，使用discretionary屬性，而不是allowsCellularAccess屬性，因?yàn)樗鼤?huì)把WiFi和電源可用性考慮在內(nèi)
"timeoutIntervalForRequest"和"timeoutIntervalForResource"指定了請(qǐng)求以及該資源的超時(shí)時(shí)間間隔。許多開發(fā)人員試圖使用timeoutInterval去限制發(fā)送請(qǐng)求的總時(shí)間，但這誤會(huì)了timeoutInterval的意思：報(bào)文之間的時(shí)間。timeoutIntervalForResource實(shí)際上提供了整體超時(shí)的特性，這應(yīng)該只用于后臺(tái)傳輸，而不是用戶實(shí)際上可能想要等待的任何東西
"HTTPMaximumConnectionsPerHost"是 Foundation 框架中URL加載系統(tǒng)的一個(gè)新的配置選項(xiàng)。它曾經(jīng)被用于NSURLConnection管理私人連接池?，F(xiàn)在有了NSURLSession，開發(fā)者可以在需要時(shí)限制連接到特定主機(jī)的數(shù)量
"HTTPShouldUsePipelining"也出現(xiàn)在NSMutableURLRequest，它可以被用于開啟HTTP管道，這可以顯著降低請(qǐng)求的加載時(shí)間，但是由于沒有被服務(wù)器廣泛支持，默認(rèn)是禁用的
"sessionSendsLaunchEvents" 是另一個(gè)新的屬性，該屬性指定該會(huì)話是否應(yīng)該從后臺(tái)啟動(dòng)
"connectionProxyDictionary"指定了會(huì)話連接中的代理服務(wù)器。同樣地，大多數(shù)面向消費(fèi)者的應(yīng)用程序都不需要代理，所以基本上不需要配置這個(gè)屬性
關(guān)于連接代理的更多信息可以在 CFProxySupport Reference 找到。
"Cookie Policies"
－"HTTPCookieStorage" 是被會(huì)話使用的cookie存儲(chǔ)。默認(rèn)情況下，NSHTTPCookieShorage的 + sharedHTTPCookieStorage會(huì)被使用，這與NSURLConnection是相同的
－"HTTPCookieAcceptPolicy" 決定了該會(huì)話應(yīng)該接受從服務(wù)器發(fā)出的cookie的條件
－"HTTPShouldSetCookies" 指定了請(qǐng)求是否應(yīng)該使用會(huì)話HTTPCookieStorage的cookie
"Security Policies"
URLCredentialStorage 是會(huì)話使用的證書存儲(chǔ)。默認(rèn)情況下，NSURLCredentialStorage 的+ sharedCredentialStorage 會(huì)被使用使用，這與NSURLConnection是相同的
"TLSMaximumSupportedProtocol" 和 "TLSMinimumSupportedProtocol" 確定是否支持SSLProtocol版本的會(huì)話
"Caching Policies"
URLCache 是會(huì)話使用的緩存。默認(rèn)情況下，NSURLCache 的 + sharedURLCache 會(huì)被使用，這與NSURLConnection是相同的
requestCachePolicy 指定了一個(gè)請(qǐng)求的緩存響應(yīng)應(yīng)該在什么時(shí)候返回。這相當(dāng)于NSURLRequest 的-cachePolicy方法
"Custom Protocols"
protocolClasses是注冊(cè)NSURLProtocol類的特定會(huì)話數(shù)組
