AFNetworking 2.0的教程

AFNetworking 2.0有着很大的更新，建立在两年的开发并维护这个库的基础上，新版本带来了更多的特性，当然，他也不会抛弃AFNetworking 1.x的用户，它提供了一个简单的如何从1.x升级到2.0的一篇文档。

Read the  AFNetworking 2.0 Migration Guide  for an overview of the architectural and API changes.

• Refactored Architecture
• Support for NSURLSession
• Serialization Modules
• Expanded UIKit Extensions
• Real-time functionality with  Rocket
• 重构了架构
• 支持NSURLSession
• 模块化的模型
• 扩展了UIKit
• ？？？？？？

Requirements（ 要求 ）

AFNetworking 2.0 and higher requires Xcode 5, targeting either iOS 6.0 and above, or Mac OS 10.8 Mountain Lion ( 64-bit with modern Cocoa runtime ) and above.

AFNetworking 2.0以及后续高版本需要在Xcode 5上进行开发，iOS版本需要6.0以及以上，Mac OS 10.8以及以上。

For compatibility with iOS 5 or Mac OS X 10.7, use the  latest 1.x release .

For compatibility with iOS 4.3 or Mac OS X 10.6, use the  latest 0.10.x release.

为了兼容iOS 5或者Mac OS X 10.7，使用1.x版本。

为了兼容iOS 4.3或者Mac OS X 10.6，使用0.10.x版本。

Architecture（ 结构 ）

• AFURLConnectionOperation
• AFHTTPRequestOperation
• AFHTTPRequestOperationManager

NSURLSession  (iOS 7 / Mac OS X 10.9)

• AFURLSessionManager
• AFHTTPSessionManager

• <AFURLRequestSerialization>
  • AFHTTPRequestSerializer
  • AFJSONRequestSerializer
  • AFPropertyListRequestSerializer
• <AFURLResponseSerialization>
  • AFHTTPResponseSerializer
  • AFJSONResponseSerializer
  • AFXMLParserResponseSerializer
  • AFXMLDocumentResponseSerializer   (Mac OS X)
  • AFPropertyListResponseSerializer
  • AFImageResponseSerializer
  • AFCompoundResponseSerializer

Additional Functionality

• AFSecurityPolicy
• AFNetworkReachabilityManager

Usage（ 使用 ）

HTTP Request Operation Manager（ HTTP请求操作管理器 ）

AFHTTPRequestOperationManager  encapsulates the common patterns of communicating with a web application over HTTP, including request creation, response serialization, network reachability monitoring, and security, as well as request operation management.

AFHTTPRequestOperationManager  将通用的与服务器应用交互的操作封装了起来，包括了请求的创建，回复的序列化，网络指示器的监测，安全性，当然还有请求操作的管理。

GET  Request（ GET请求 ）

AFHTTPRequestOperationManager *manager = [AFHTTPRequestOperationManager manager];
[manager GET:@"http://example.com/resources.json" parameters:nil success:^(AFHTTPRequestOperation *operation, id responseObject) {
    NSLog(@"JSON: %@", responseObject);
} failure:^(AFHTTPRequestOperation *operation, NSError *error) {
    NSLog(@"Error: %@", error);
}];

POST  URL-Form-Encoded Request（ 附带表单编码的POST请求 ）

AFHTTPRequestOperationManager *manager = [AFHTTPRequestOperationManager manager];
NSDictionary *parameters = @{@"foo": @"bar"};
[manager POST:@"http://example.com/resources.json" parameters:parameters success:^(AFHTTPRequestOperation *operation, id responseObject) {
    NSLog(@"JSON: %@", responseObject);
} failure:^(AFHTTPRequestOperation *operation, NSError *error) {
    NSLog(@"Error: %@", error);
}];

POST  Multi-Part Request（ 复杂的POST请求 ）

AFHTTPRequestOperationManager *manager = [AFHTTPRequestOperationManager manager];
NSDictionary *parameters = @{@"foo": @"bar"};
NSURL *filePath = [NSURL fileURLWithPath:@"file://path/to/image.png"];
[manager POST:@"http://example.com/resources.json" parameters:parameters constructingBodyWithBlock:^(id<AFMultipartFormData> formData) {
    [formData appendPartWithFileURL:filePath name:@"image" error:nil];
} success:^(AFHTTPRequestOperation *operation, id responseObject) {
    NSLog(@"Success: %@", responseObject);
} failure:^(AFHTTPRequestOperation *operation, NSError *error) {
    NSLog(@"Error: %@", error);
}];

---

AFURLSessionManager

AFURLSessionManager  creates and manages an  NSURLSession object based on a specified  NSURLSessionConfiguration  object, which conforms to  <NSURLSessionTaskDelegate> , <NSURLSessionDataDelegate> ,  <NSURLSessionDownloadDelegate>, and  <NSURLSessionDelegate> .

AFURLSessionManager  创建了一个管理一个NSURLSession的对象，基于一个指定的 NSURLSessionConfiguration 对象，它与以下的这些协议融合在一起（ <NSURLSessionTaskDelegate> , <NSURLSessionDataDelegate> ,  <NSURLSessionDownloadDelegate>, <NSURLSessionDelegate> ）。

Creating a Download Task（ 创建一个下载任务 ）

NSURLSessionConfiguration *configuration = [NSURLSessionConfiguration defaultSessionConfiguration];
AFURLSessionManager *manager = [[AFURLSessionManager alloc] initWithSessionConfiguration:configuration];

NSURL *URL = [NSURL URLWithString:@"http://example.com/download.zip"];
NSURLRequest *request = [NSURLRequest requestWithURL:URL];

NSURLSessionDownloadTask *downloadTask = [manager downloadTaskWithRequest:request progress:nil destination:^NSURL *(NSURL *targetPath, NSURLResponse *response) {
    NSURL *documentsDirectoryURL = [[NSFileManager defaultManager] URLForDirectory:NSDocumentDirectory inDomain:NSUserDomainMask appropriateForURL:nil create:NO error:nil];
    return [documentsDirectoryURL URLByAppendingPathComponent:[response suggestedFilename]];
} completionHandler:^(NSURLResponse *response, NSURL *filePath, NSError *error) {
    NSLog(@"File downloaded to: %@", filePath);
}];
[downloadTask resume];

Creating an Upload Task（ 创建一个上传任务 ）

NSURLSessionConfiguration *configuration = [NSURLSessionConfiguration defaultSessionConfiguration];
AFURLSessionManager *manager = [[AFURLSessionManager alloc] initWithSessionConfiguration:configuration];

NSURL *URL = [NSURL URLWithString:@"http://example.com/upload"];
NSURLRequest *request = [NSURLRequest requestWithURL:URL];

NSURL *filePath = [NSURL fileURLWithPath:@"file://path/to/image.png"];
NSURLSessionUploadTask *uploadTask = [manager uploadTaskWithRequest:request fromFile:filePath progress:nil completionHandler:^(NSURLResponse *response, id responseObject, NSError *error) {
    if (error) {
        NSLog(@"Error: %@", error);
    } else {
        NSLog(@"Success: %@ %@", response, responseObject);
    }
}];
[uploadTask resume];

Creating an Upload Task for a Multi-Part Request, with Progress（ 创建一个复杂的请求，并附带进度 ）

NSMutableURLRequest *request = [[AFHTTPRequestSerializer serializer] multipartFormRequestWithMethod:@"POST" URLString:@"http://example.com/upload" parameters:nil constructingBodyWithBlock:^(id<AFMultipartFormData> formData) {
    [formData appendPartWithFileURL:[NSURL fileURLWithPath:@"file://path/to/image.jpg"] name:@"file" fileName:@"filename.jpg" mimeType:@"image/jpeg" error:nil];
  } error:nil];

  AFURLSessionManager *manager = [[AFURLSessionManager alloc] initWithSessionConfiguration:[NSURLSessionConfiguration defaultSessionConfiguration]];
  NSProgress *progress = nil;

  NSURLSessionUploadTask *uploadTask = [manager uploadTaskWithStreamedRequest:request progress:&progress completionHandler:^(NSURLResponse *response, id responseObject, NSError *error) {
    if (error) {
      NSLog(@"Error: %@", error);
    } else {
      NSLog(@"%@ %@", response, responseObject);
    }
  }];

  [uploadTask resume];

Creating a Data Task（ 创建一个数据任务 ）

NSURLSessionConfiguration *configuration = [NSURLSessionConfiguration defaultSessionConfiguration];
AFURLSessionManager *manager = [[AFURLSessionManager alloc] initWithSessionConfiguration:configuration];

NSURL *URL = [NSURL URLWithString:@"http://example.com/upload"];
NSURLRequest *request = [NSURLRequest requestWithURL:URL];

NSURLSessionDataTask *dataTask = [manager dataTaskWithRequest:request completionHandler:^(NSURLResponse *response, id responseObject, NSError *error) {
    if (error) {
        NSLog(@"Error: %@", error);
    } else {
        NSLog(@"%@ %@", response, responseObject);
    }
}];
[dataTask resume];

---

Request Serialization（ 请求序列化 ）

Request serializers create requests from URL strings, encoding parameters as either a query string or HTTP body.

请求序列化器会从URL字符串创建请求，编码参数，查找字符串或者是HTTPbody部分。

NSString *URLString = @"http://example.com";
NSDictionary *parameters = @{@"foo": @"bar", @"baz": @[@1, @2, @3]};

Query String Parameter Encoding（ 查询string的编码 ）

[[AFHTTPRequestSerializer serializer] requestWithMethod:@"GET" URLString:URLString parameters:parameters error:nil];

GET http://example.com?foo=bar&baz[]=1&baz[]=2&baz[]=3

URL Form Parameter Encoding（ 查询URL表单形式参数的编码 ）

[[AFHTTPRequestSerializer serializer] requestWithMethod:@"POST" URLString:URLString parameters:parameters];

POST http://example.com/
Content-Type: application/x-www-form-urlencoded

foo=bar&baz[]=1&baz[]=2&baz[]=3

JSON Parameter Encoding（ 查询json参数的编码 ）

[[AFJSONRequestSerializer serializer] requestWithMethod:@"POST" URLString:URLString parameters:parameters];

POST http://example.com/
Content-Type: application/json

{"foo": "bar", "baz": [1,2,3]}

---

Network Reachability Manager（ 监测网络管理器 ）

AFNetworkReachabilityManager  monitors the reachability of domains, and addresses for both WWAN and WiFi network interfaces.

AFNetworkReachabilityManager  监测域名以及IP地址的畅通性，对于WWAN以及WiFi的网络接口都管用。

Shared Network Reachability（ 单例形式检测网络畅通性 ）

[[AFNetworkReachabilityManager sharedManager] setReachabilityStatusChangeBlock:^(AFNetworkReachabilityStatus status) {
    NSLog(@"Reachability: %@", AFStringFromNetworkReachabilityStatus(status));
}];

HTTP Manager with Base URL（ 用基本的URL管理HTTP ）

When a  baseURL  is provided, network reachability is scoped to the host of that base URL.

如果提供了一个基本的URL地址，那个基本URL网址的畅通性就会被仔细的监测着。

NSURL *baseURL = [NSURL URLWithString:@"http://example.com/"];
AFHTTPRequestOperationManager *manager = [[AFHTTPRequestOperationManager alloc] initWithBaseURL:baseURL];

NSOperationQueue *operationQueue = manager.operationQueue;
[manager.reachabilityManager setReachabilityStatusChangeBlock:^(AFNetworkReachabilityStatus status) {
  switch (status) {
    case AFNetworkReachabilityStatusReachableViaWWAN:
    case AFNetworkReachabilityStatusReachableViaWiFi:
      [operationQueue setSuspended:NO];
      break;
    case AFNetworkReachabilityStatusNotReachable:
    default:
      [operationQueue setSuspended:YES];
      break;
  }
}];

---

AFSecurityPolicy  evaluates server trust against pinned X.509 certificates and public keys over secure connections.

Adding pinned SSL certificates to your app helps prevent man-in-the-middle attacks and other vulnerabilities. Applications dealing with sensitive customer data or financial information are strongly encouraged to route all communication over an HTTPS connection with SSL pinning configured and enabled.

Allowing Invalid SSL Certificates（ 允许不合法的SSL证书 ）

AFHTTPRequestOperationManager *manager = [AFHTTPRequestOperationManager manager];
manager.securityPolicy.allowInvalidCertificates = YES; // not recommended for production

---

AFHTTPRequestOperation

AFHTTPRequestOperation  is a subclass of AFURLConnectionOperation  for requests using the HTTP or HTTPS protocols. It encapsulates the concept of acceptable status codes and content types, which determine the success or failure of a request.

Although  AFHTTPRequestOperationManager  is usually the best way to go about making requests,  AFHTTPRequestOperation  can be used by itself.

AFHTTPRequestOperation 继承自AFURLConnectionOperation，使用HTTP以及HTTPS协议来处理网络请求。它封装成了一个可以令人接受的代码形式。当然AFHTTPRequestOperationManager 目前是最好的用来处理网络请求的方式，但AFHTTPRequestOperation 也有它自己的用武之地。

GET  with AFHTTPRequestOperation（使用AFHTTPRequestOperation）

NSURL *URL = [NSURL URLWithString:@"http://example.com/resources/123.json"];
NSURLRequest *request = [NSURLRequest requestWithURL:URL];
AFHTTPRequestOperation *op = [[AFHTTPRequestOperation alloc] initWithRequest:request];
op.responseSerializer = [AFJSONResponseSerializer serializer];
[op setCompletionBlockWithSuccess:^(AFHTTPRequestOperation *operation, id responseObject) {
    NSLog(@"JSON: %@", responseObject);
} failure:^(AFHTTPRequestOperation *operation, NSError *error) {
    NSLog(@"Error: %@", error);
}];
[[NSOperationQueue mainQueue] addOperation:op];

Batch of Operations（ 许多操作一起进行 ）

NSMutableArray *mutableOperations = [NSMutableArray array];
for (NSURL *fileURL in filesToUpload) {
  NSURLRequest *request = [[AFHTTPRequestSerializer serializer] multipartFormRequestWithMethod:@"POST" URLString:@"http://example.com/upload" parameters:nil constructingBodyWithBlock:^(id<AFMultipartFormData> formData) {
    [formData appendPartWithFileURL:fileURL name:@"images[]" error:nil];
  }];

  AFHTTPRequestOperation *operation = [[AFHTTPRequestOperation alloc] initWithRequest:request];

  [mutableOperations addObject:operation];
}

NSArray *operations = [AFURLConnectionOperation batchOfRequestOperations:@[...] progressBlock:^(NSUInteger numberOfFinishedOperations, NSUInteger totalNumberOfOperations) {
  NSLog(@"%lu of %lu complete", numberOfFinishedOperations, totalNumberOfOperations);
} completionBlock:^(NSArray *operations) {
  NSLog(@"All operations in batch complete");
}];
[[NSOperationQueue mainQueue] addOperations:operations waitUntilFinished:NO];

转载地址：http://www.tuicool.com/articles/zyEBjua