/*--------------------- 01? NSURLSession -------------------*/
重點:1.NSURLSession的使用 2.熟練掌握 NSURLSession
{
<1> NSURLSession 簡介:
{
NSURLSession 是 iOS 7.0 之后推出的網(wǎng)絡(luò)解決方案!用于替代 NSURLConnection,? 針對下載/上傳等復(fù)雜的網(wǎng)絡(luò)操作提供了專門的解決方案!
NSURLSession 使用更加簡單/方便!
}
<2> NSURLSession 中新增的內(nèi)容:
{
1> 全局的 NSURLSession 對象: 所有的網(wǎng)絡(luò)會話都由一個 NSURLSession 對象發(fā)起, 實例化一個 NSURLSession 對象有兩種方法:
{
*1 對于簡單的,不需要監(jiān)聽網(wǎng)絡(luò)請求過程的網(wǎng)絡(luò)會話來說,使用系統(tǒng)提供的,全局的 NSURLSession 單利對象:
NSURLSession *session = [NSURLSession sharedSession];
*2 如果需要監(jiān)聽網(wǎng)絡(luò)進度,需要自定義一個 NSURLSession 對象,并且設(shè)置代理!這時還需要一個 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請求 NSURLSessionDataTask.實例化對象有以下2種方法:
{
// 1> 通過一個 request 實例化普通網(wǎng)絡(luò)任務(wù),增加完成之后的 block 回調(diào),使用比較多.
NSURLSessionDataTask *task = [self.session dataTaskWithRequest:request completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
}];
// 2> 通過一個 url 實例化普通網(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) ,實例化對象有以下三種方法:
{
// 1> 通過一個 request 實例化下載網(wǎng)絡(luò)任務(wù),增加任務(wù)完成之后的 block 回調(diào),一般用在小文件下載.
NSURLSessionDownloadTask *task = [self.session downloadTaskWithRequest:request completionHandler:^(NSURL *location, NSURLResponse *response, NSError *error) {
}];
// 2> 通過一個 url 實例化下載網(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 ,實例化一個下載任務(wù),用于斷點續(xù)傳.
NSURLSessionDownloadTask *task = [session downloadTaskWithResumeData:ResumeData completionHandler:^(NSURL *location, NSURLResponse *response, NSError *error) {
}];
}
*3 用于文件上傳的網(wǎng)絡(luò)任務(wù) NSURLSessionUploadTask.
{
// 目前,只有通過這種方式實例化的下載任務(wù),才能實現(xiàn)文件上傳.依然需要拼接數(shù)據(jù).
NSURLSessionUploadTask *task = [session uploadTaskWithRequest:request fromData:fromData completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
//
}]
}
}
}
<3> NSURLSession 的使用分為三步:
{
1> 實例化一個 NSURLSession 對象 session ;
NSURLSession *session = [NSURLSession sharedSession];
2> 通過 NSURLSession 對象,實例化對應(yīng)的網(wǎng)絡(luò)任務(wù) task;
NSURLSessionDataTask *task = [session dataTaskWithRequest:request];
3> 開啟網(wǎng)絡(luò)任務(wù)
[task resume];
}
}
/*-----------------? 02 NSURLSession 下載的斷點續(xù)傳 ------------------*/
重點:1.學(xué)會使用 NSULSession 實現(xiàn)下載任務(wù). 2.實時監(jiān)聽下載進度,學(xué)會使用斷點續(xù)傳.
{? ?
?利用 NSURLSession 實現(xiàn)文件下載,首先需要創(chuàng)建一個 NSURLSessionDownloadTask; 由于需要實時監(jiān)聽下載進度,所以,需要實現(xiàn)方法,這樣,就需要自定義一個會話 session.并且制定代理.
// NSURLSession 下載的斷點續(xù)傳實現(xiàn)步驟:
1. 懶加載全局網(wǎng)絡(luò)會話
{
-(NSURLSession *)session
{
if (!_session) {
NSURLSessionConfiguration *config = [NSURLSessionConfiguration defaultSessionConfiguration];
_session = [NSURLSession sessionWithConfiguration:config delegate:self delegateQueue:nil];
}
return _session;
}
}
2. 利用全局網(wǎng)絡(luò)會話,創(chuàng)建下載 task, 開始下載任務(wù)
{
self.task = [self.session downloadTaskWithURL:url];
[self.task resume];
}
3. 在代理方法中,實時監(jiān)聽下載進度
{
// 監(jiā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;
});
}
// 完成下載的時候調(diào)用
-(void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didFinishDownloadingToURL:(NSURL *)location
{
NSLog(@"下載完成%@",location);
}
// 斷點續(xù)傳的代理方法,暫時什么都不寫
-(void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didResumeAtOffset:(int64_t)fileOffset expectedTotalBytes:(int64_t)expectedTotalBytes
{
NSLog(@"%s",__FUNCTION__);
}
}
4. 當(dāng)點擊暫停之后,應(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)點擊繼續(xù)之后,應(yīng)該從上次下載的進度繼續(xù)下載,這時,重新創(chuàng)建下載 task, 并且是根據(jù)上次記錄的文件下載數(shù)據(jù)來實例化下載任務(wù)
{
if (!self.reusemData) {
return;
}
self.task = [self.session downloadTaskWithResumeData:self.reusemData];
self.reusemData = nil;
[self.task resume];
}
}
/*--------------------- 03 NSURLSession 實現(xiàn)上傳文件 -----------------*/
重點:1.學(xué)會使用 NSURLSession 實現(xiàn)文件上傳.
{
NSURLSession 上傳文件和 NSURLConnection 一樣需要按格式拼接文件數(shù)據(jù).重要的是要學(xué)會封裝方法,具體使用如下:
{
// NSURLSession 做文件上傳
- (void)uploadMfileSession
{
// 1.實例化全局網(wǎng)絡(luò)會話
NSURLSession *session = [NSURLSession sharedSession];
// 2.創(chuàng)建網(wǎng)絡(luò)請求
{
NSURL *url = [NSURL URLWithString:@"http://localhost/upload/upload-m.php"];
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
// 設(shè)置請求方法
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)為二進制數(shù)據(jù).
NSData *dataM = [self formDataWithfileName:@"userfile[]" fileDict:fileDict parameter:parameter];
// 6. 利用網(wǎng)絡(luò)會話,建立上傳任務(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ù)制和剪切 ----------------------*/
重點:掌握文件操作中的復(fù)制和剪切.
{
文件下載到本地之后,有時候需要對文件進行移動操作,這樣就需要掌握掌握文件的復(fù)制和剪切操作.
1.文件的拷貝
// 新建一個文件路徑
NSString *path = @"/Users/likaining/Desktop/abc/";
// 從一個文件路徑拷貝文件到另一個文件路徑
// AtPath : 拷貝前的文件路徑
// ToPath : 拷貝后的文件路徑
[[NSFileManager defaultManager] copyItemAtPath:location.path toPath:path error:0];
2.文件的剪切
// response.suggestedFilename:建議使用的文件名,一般跟服務(wù)器端的文件名一致
NSString *file = [caches stringByAppendingPathComponent:downloadTask.response.suggestedFilename];
// 將臨時文件剪切到Caches文件夾
// AtPath : 剪切前的文件路徑
// ToPath : 剪切后的文件路徑
[[NSFileManager defaultManager] moveItemAtPath:location.path toPath:file error:nil];
}
/*------------------------- 05 文件的解壓縮---------------------*/
重點:掌握文件的解壓縮操作,會使用解壓縮框架.
{
為了方便網(wǎng)絡(luò)傳輸,文件經(jīng)常被壓縮之后再進行網(wǎng)絡(luò)傳輸,這個時候,需要學(xué)會解壓縮文件.
1.文件的解壓縮需要導(dǎo)入第三方框架: SSZipArchive ,需要注意的是,這個框架依賴一個動態(tài)度 libz.dylib.
2. 壓縮文件:
// 1.獲得需要壓縮的文件夾
NSString *images = [caches stringByAppendingPathComponent:@"images"];
// 1.創(chuàng)建一個zip文件（壓縮）
NSString *zipFile = [caches stringByAppendingPathComponent:@"images.zip"];
BOOL result = [SSZipArchive createZipFileAtPath:zipFile withContentsOfDirectory:images];
3. 解壓縮文件:
// location.path:需要解壓縮的文件
// 文件解壓縮之后存放的路徑(注意,只需要給出一個文件路徑就可以,因為很可能解壓縮之后,生成很多個文件).
[SSZipArchive unzipFileAtPath:location.path toDestination:path];
}
? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? NSURLSessionConfiguration
NSURLSessionConfiguration對象用于初始化NSURLSession對象。
展開請求級別中與NSMutableURLRequest相關(guān)的可供選擇的方案榜聂，我們可以看到NSURLSessionConfiguration對于會話如何產(chǎn)生請求幔戏，提供了相當(dāng)多的控制和靈活性击敌。從網(wǎng)絡(luò)訪問性能削锰，到cookie巧勤，安全性粘室，緩存策略缺厉，自定義協(xié)議栓辜，啟動事件設(shè)置恋拍，以及用于移動設(shè)備優(yōu)化的幾個新屬性，你會發(fā)現(xiàn)你一直在尋找的藕甩，正是NSURLSessionConfiguration施敢。
會話在初始化時復(fù)制它們的配置，NSURLSession有一個只讀的配置屬性狭莱，使得該配置對象上的變化對這個會話的政策無效僵娃。配置在初始化時被讀取一次，之后都是不會變化的腋妙。
－構(gòu)造方法
NSURLSessionConfiguration有三個類構(gòu)造函數(shù)默怨，這很好地說明了NSURLSession是為不同的用例而設(shè)計的。
+ "defaultSessionConfiguration"返回標(biāo)準(zhǔn)配置骤素，這實際上與NSURLConnection的網(wǎng)絡(luò)協(xié)議棧是一樣的先壕，具有相同的共享NSHTTPCookieStorage瘩扼，共享NSURLCache和共享NSURLCredentialStorage。
+ "ephemeralSessionConfiguration"返回一個預(yù)設(shè)配置垃僚，沒有持久性存儲的緩存集绰，Cookie或證書。這對于實現(xiàn)像"秘密瀏覽"功能的功能來說谆棺，是很理想的栽燕。
+ "backgroundSessionConfiguration"：獨特之處在于，它會創(chuàng)建一個后臺會話改淑。后臺會話不同于常規(guī)的碍岔，普通的會話，它甚至可以在應(yīng)用程序掛起朵夏，退出蔼啦，崩潰的情況下運行上傳和下載任務(wù)。初始化時指定的標(biāo)識符仰猖，被用于向任何可能在進程外恢復(fù)后臺傳輸?shù)氖刈o進程提供上下文捏肢。
想要查看更多關(guān)于后臺會話的信息，可以查看WWDC Session 204: “What’s New with Multitasking”
－NSURLSessionConfiguration的屬性
NSURLSessionConfiguration擁有20個屬性饥侵。熟練掌握這些屬性的用處鸵赫，將使應(yīng)用程序充分利用其網(wǎng)絡(luò)環(huán)境。
最重要的屬性：
# 替代 request 中的 forHTTPHeaderField 告訴服務(wù)器有關(guān)客戶端的附加信息
"HTTPAdditionalHeaders"指定了一組默認的可以設(shè)置出站請求的數(shù)據(jù)頭躏升。這對于跨會話共享信息辩棒，如內(nèi)容類型，語言膨疏，用戶代理一睁，身份認證，是很有用的佃却。
# WebDav的身份驗證
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ù)類型）"對標(biāo)準(zhǔn)的網(wǎng)絡(luò)流量卖局，網(wǎng)絡(luò)電話，語音双霍，視頻砚偶，以及由一個后臺進程使用的流量進行了區(qū)分。大多數(shù)應(yīng)用程序都不需要設(shè)置這個
"allowsCellularAccess（允許蜂窩訪問）"和"discretionary（自行決定）"被用于節(jié)省通過蜂窩連接的帶寬洒闸。建議在使用后臺傳輸?shù)臅r候染坯，使用discretionary屬性，而不是allowsCellularAccess屬性丘逸，因為它會把WiFi和電源可用性考慮在內(nèi)
"timeoutIntervalForRequest"和"timeoutIntervalForResource"指定了請求以及該資源的超時時間間隔单鹿。許多開發(fā)人員試圖使用timeoutInterval去限制發(fā)送請求的總時間，但這誤會了timeoutInterval的意思：報文之間的時間深纲。timeoutIntervalForResource實際上提供了整體超時的特性仲锄，這應(yīng)該只用于后臺傳輸劲妙，而不是用戶實際上可能想要等待的任何東西
"HTTPMaximumConnectionsPerHost"是 Foundation 框架中URL加載系統(tǒng)的一個新的配置選項。它曾經(jīng)被用于NSURLConnection管理私人連接池∪搴埃現(xiàn)在有了NSURLSession镣奋，開發(fā)者可以在需要時限制連接到特定主機的數(shù)量
"HTTPShouldUsePipelining"也出現(xiàn)在NSMutableURLRequest，它可以被用于開啟HTTP管道怀愧，這可以顯著降低請求的加載時間侨颈，但是由于沒有被服務(wù)器廣泛支持，默認是禁用的
"sessionSendsLaunchEvents" 是另一個新的屬性芯义，該屬性指定該會話是否應(yīng)該從后臺啟動
"connectionProxyDictionary"指定了會話連接中的代理服務(wù)器哈垢。同樣地，大多數(shù)面向消費者的應(yīng)用程序都不需要代理扛拨，所以基本上不需要配置這個屬性
關(guān)于連接代理的更多信息可以在 CFProxySupport Reference 找到耘分。
"Cookie Policies"
－"HTTPCookieStorage" 是被會話使用的cookie存儲。默認情況下绑警，NSHTTPCookieShorage的 + sharedHTTPCookieStorage會被使用求泰，這與NSURLConnection是相同的
－"HTTPCookieAcceptPolicy" 決定了該會話應(yīng)該接受從服務(wù)器發(fā)出的cookie的條件
－"HTTPShouldSetCookies" 指定了請求是否應(yīng)該使用會話HTTPCookieStorage的cookie
"Security Policies"
URLCredentialStorage 是會話使用的證書存儲。默認情況下待秃，NSURLCredentialStorage 的+ sharedCredentialStorage 會被使用使用，這與NSURLConnection是相同的
"TLSMaximumSupportedProtocol" 和 "TLSMinimumSupportedProtocol" 確定是否支持SSLProtocol版本的會話
"Caching Policies"
URLCache 是會話使用的緩存痹屹。默認情況下章郁，NSURLCache 的 + sharedURLCache 會被使用，這與NSURLConnection是相同的
requestCachePolicy 指定了一個請求的緩存響應(yīng)應(yīng)該在什么時候返回志衍。這相當(dāng)于NSURLRequest 的-cachePolicy方法
"Custom Protocols"
protocolClasses是注冊NSURLProtocol類的特定會話數(shù)組
