AFNetworking.png

AFNetworking是iOS和Mac OS X的令人愉快的网络库。它建立在基础URL加载系统的顶部，将强大的高级网络抽象扩展到Cocoa中。它具有模块化架构，设计精良，功能丰富的API，使用起来非常舒适。
无论如何，所有这一切最重要的特征也许是每天使用和贡献AFNetworking的惊人的开发者社区。AFNetworking为iPhone，iPad和Mac上的一些最受欢迎和最受欢迎的应用程序提供支持。
选择AFNetworking为您的下一个项目，或迁移您现有的项目 - 你会很高兴你所做的！

如何开始

下载 AFNetworking and try out the included Mac and iPhone example apps
看一下 "Getting Started" 指导, FAQ, or 其他的文章在 Wiki
查看文档以全面了解AFNetworking中可用的所有API
阅读AFNetworking 3.0迁移指南，了解从2.0开始的架构更改的概述。

沟通方式

如需帮助，请移步Stack Overflow（Tag'afnetworking'）
或问一个问题，还是楼上方法
如果您发现了一个bug，并且可以提供可靠再现的步骤，请打开一个issue。
如果您有功能请求，请打开issue。
如果您想贡献，请提交拉动请求。

安装
AFNetworking支持在项目中安装库的多种方法。

使用CocoaPods安装

CocoaPods 是一个Objective-C的依赖管理器。它可以自动化并简化在项目中使用AFNetworking这样的第三方库的过程。看一下 "Getting Started" guide for more information，您可以使用以下命令安装它

$ gem install cocoapods

注意：需要CocoaPods 0.39.0+来构建AFNetworking 3.0.0+。

Podfile
使用CocoaPods将AFNetworking整合到你的工程中去，在你的Podfile中指定它。

source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '8.0'

target 'TargetName' do
pod 'AFNetworking', '~> 3.0'
end

然后运行一下命令：

$ pod install

使用 Carthage 安装

Carthage是一个分散的依赖管理器，可以构建您的依赖关系并为您提供二进制框架。
您可以使用以下命令安装Carthage与Homebrew

$ brew update
$ brew install carthage

使用Carthage将AFNetworking整合到你的项目中，在Cartfile中指定它：

github "AFNetworking/AFNetworking" ~> 3.0

运行carthage构建框架，并将内置的AFNetworking.framework拖到Xcode项目中。

配置要求

AFNetworking Version	Minimum iOS Target	Minimum OS X Target	Minimum watchOS Target	Minimum tvOS Target	Notes
3.x	iOS 7	OS X 10.9	watchOS 2.0	tvOS 9.0	Xcode 7+ is required. NSURLConnectionOperation support has been removed.
2.6 -> 2.6.3	iOS 7	OS X 10.9	watchOS 2.0	n/a	Xcode 7+ is required.
2.0 -> 2.5.4	iOS 6	OS X 10.8	n/a	n/a	Xcode 5+ is required. NSURLSession subspec requires iOS 7 or OS X 10.9.
1.x	iOS 5	Mac OS X 10.7	n/a	n/a
0.10.x	iOS 4	Mac OS X 10.6	n/a	n/a

（OS X项目必须支持64位与现代Cocoa运行时）

在Swift编程？尝试一个更传统的API集合的Alamofire。

架构

NSURLSession

AFURLSessionManager
AFHTTPSessionManager

Serialization

< AFURLRequestSerialization >
- AFHTTPRequestSerializer
- AFJSONRequestSerializer
- AFPropertyListRequestSerializer
< AFURLResponseSerialization >
- AFHTTPResponseSerializer
- AFJSONResponseSerializer
- AFXMLParserResponseSerializer
- AFXMLDocumentResponseSerializer (Mac OS X)
- AFPropertyListResponseSerializer
- AFImageResponseSerializer
- AFCompoundResponseSerializer
Additional Functionality
- AFSecurityPolicy
- AFNetworkReachabilityManager

用法

AFURLSessionManager

AFURLSessionManager基于指定的NSURLSessionConfiguration对象创建和管理NSURLSession对象，该对象符合<NSURLSessionTaskDelegate>，<NSURLSessionDataDelegate>，<NSURLSessionDownloadDelegate>和<NSURLSessionDelegate>。

创建一个下载任务

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];

创建一个上传任务

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];

创建一个带进度的多部请求的上传任务

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]];

NSURLSessionUploadTask *uploadTask;
uploadTask = [manager
              uploadTaskWithStreamedRequest:request
              progress:^(NSProgress * _Nonnull uploadProgress) {
                  // This is not called back on the main queue.
                  // You are responsible for dispatching to the main queue for UI updates
                  dispatch_async(dispatch_get_main_queue(), ^{
                      //Update the progress view
                      [progressView setProgress:uploadProgress.fractionCompleted];
                  });
              }
              completionHandler:^(NSURLResponse * _Nonnull response, id  _Nullable responseObject, NSError * _Nullable error) {
                  if (error) {
                      NSLog(@"Error: %@", error);
                  } else {
                      NSLog(@"%@ %@", response, responseObject);
                  }
              }];

[uploadTask resume];

创建数据任务

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

NSURL *URL = [NSURL URLWithString:@"http://httpbin.org/get"];
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];

请求序列化

请求序列化程序从URL字符串创建请求，将参数编码为查询字符串或HTTP主体。

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

查询字符串参数编码

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

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

网址格式参数编码

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

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

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

JSON参数编码

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

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

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

网络连接管理

AFNetworkReachabilityManager监控域的可达性，以及WWAN和WiFi网络接口的地址。

不要使用可达性来确定是否应该发送原始请求。
- 你应该尝试发送它。
您可以使用可达性来确定何时应自动重试请求。
- 虽然它可能仍然失败，但可访问性通知连接可用是适时重试某些东西。
网络可达性是确定请求可能失败的原因的有用工具。
- 在网络请求失败之后，告诉他们离线的用户比给予他们一个更为技术性但准确的错误，比如“请求超时”。

也可以看看WWDC 2012 session 706, "Networking Best Practices.".

共享网络可连接性

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

[[AFNetworkReachabilityManager sharedManager] startMonitoring];

安全政策

AFNetworking在Tests子目录中包含一套单元测试。这些测试可以简单地执行您想要测试的平台框架上的测试操作。

信用

AFNetworking由Alamofire软件基金会拥有和维护。
AFNetworking最初由Scott Raymond和Mattt Thompson在Gowalla for iPhone的开发中创建。
AFNetworking标志是由Alan Defibaugh设计的。
最重要的是，感谢AFNetworking越来越多的贡献者。

安全披露

如果您认为已经使用AFNetworking确定了安全漏洞，则应尽快通过电子邮件将其报告给security@alamofire.org。请不要将其发布到公共问题跟踪器。

许可

AFNetworking是根据MIT许可证发布的。有关详细信息，请参阅许可证。

原文地址：https://github.com/AFNetworking/AFNetworking

欢迎大家围观，如有不足请多指点，谢谢

AFNetworking--(翻译)