How To Get Started

Communication

Installation

Installation with CocoaPods

pod'AFNetworking','~> 4.0'

Installation with Swift Package Manager

dependencies:[.package(url:"https://github.com/AFNetworking/AFNetworking.git",.upToNextMajor(from:"4.0.0"))]

Installation with Carthage

github "AFNetworking/AFNetworking" ~> 4.0

Requirements

Architecture

NSURLSession

Serialization

Additional Functionality

Usage

AFURLSessionManager

Creating a Download Task

NSURLSessionConfiguration *configuration = [NSURLSessionConfigurationdefaultSessionConfiguration];AFURLSessionManager *manager = [[AFURLSessionManageralloc]initWithSessionConfiguration:configuration];NSURL *URL = [NSURLURLWithString:@"http://example.com/download.zip"];NSURLRequest *request = [NSURLRequestrequestWithURL:URL];NSURLSessionDownloadTask *downloadTask = [managerdownloadTaskWithRequest:requestprogress:nildestination:^NSURL *(NSURL *targetPath,NSURLResponse *response) {NSURL *documentsDirectoryURL = [[NSFileManagerdefaultManager]URLForDirectory:NSDocumentDirectoryinDomain:NSUserDomainMaskappropriateForURL:nilcreate:NOerror:nil];return [documentsDirectoryURLURLByAppendingPathComponent:[responsesuggestedFilename]];}completionHandler:^(NSURLResponse *response,NSURL *filePath,NSError *error) {NSLog(@"File downloaded to:%@", filePath);}];[downloadTaskresume];

Creating an Upload Task

NSURLSessionConfiguration *configuration = [NSURLSessionConfigurationdefaultSessionConfiguration];AFURLSessionManager *manager = [[AFURLSessionManageralloc]initWithSessionConfiguration:configuration];NSURL *URL = [NSURLURLWithString:@"http://example.com/upload"];NSURLRequest *request = [NSURLRequestrequestWithURL:URL];NSURL *filePath = [NSURLfileURLWithPath:@"file://path/to/image.png"];NSURLSessionUploadTask *uploadTask = [manageruploadTaskWithRequest:requestfromFile:filePathprogress:nilcompletionHandler:^(NSURLResponse *response,id responseObject,NSError *error) {if (error) {NSLog(@"Error:%@", error);    }else {NSLog(@"Success:%@%@", response, responseObject);    }}];[uploadTaskresume];

Creating an Upload Task for a Multi-Part Request, with Progress

NSMutableURLRequest *request = [[AFHTTPRequestSerializerserializer]multipartFormRequestWithMethod:@"POST"URLString:@"http://example.com/upload"parameters:nilconstructingBodyWithBlock:^(id<AFMultipartFormData> formData) {        [formDataappendPartWithFileURL:[NSURLfileURLWithPath:@"file://path/to/image.jpg"]name:@"file"fileName:@"filename.jpg"mimeType:@"image/jpeg"error:nil];    }error:nil];AFURLSessionManager *manager = [[AFURLSessionManageralloc]initWithSessionConfiguration:[NSURLSessionConfigurationdefaultSessionConfiguration]];NSURLSessionUploadTask *uploadTask;uploadTask = [manageruploadTaskWithStreamedRequest:requestprogress:^(NSProgress * _Nonnull uploadProgress) {// This is not called back on the main queue.// You are responsible for dispatching to the main queue for UI updatesdispatch_async(dispatch_get_main_queue(), ^{//Update the progress view                      [progressViewsetProgress:uploadProgress.fractionCompleted];                  });              }completionHandler:^(NSURLResponse * _Nonnull response,id  _Nullable responseObject,NSError * _Nullable error) {if (error) {NSLog(@"Error:%@", error);                  }else {NSLog(@"%@%@", response, responseObject);                  }              }];[uploadTaskresume];

Creating a Data Task

NSURLSessionConfiguration *configuration = [NSURLSessionConfigurationdefaultSessionConfiguration];AFURLSessionManager *manager = [[AFURLSessionManageralloc]initWithSessionConfiguration:configuration];NSURL *URL = [NSURLURLWithString:@"http://httpbin.org/get"];NSURLRequest *request = [NSURLRequestrequestWithURL:URL];NSURLSessionDataTask *dataTask = [managerdataTaskWithRequest:requestcompletionHandler:^(NSURLResponse *response,id responseObject,NSError *error) {if (error) {NSLog(@"Error:%@", error);    }else {NSLog(@"%@%@", response, responseObject);    }}];[dataTaskresume];

Request Serialization

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

Query String Parameter Encoding

[[AFHTTPRequestSerializerserializer]requestWithMethod:@"GET"URLString:URLStringparameters:parameterserror:nil];

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

URL Form Parameter Encoding

[[AFHTTPRequestSerializerserializer]requestWithMethod:@"POST"URLString:URLStringparameters:parameterserror:nil];

POST http://example.com/Content-Type: application/x-www-form-urlencodedfoo=bar&baz[]=1&baz[]=2&baz[]=3

JSON Parameter Encoding

[[AFJSONRequestSerializerserializer]requestWithMethod:@"POST"URLString:URLStringparameters:parameterserror:nil];

POST http://example.com/Content-Type: application/json{"foo": "bar", "baz": [1,2,3]}

Network Reachability Manager

Shared Network Reachability

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

Security Policy

Allowing Invalid SSL Certificates

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

Unit Tests

Credits

Security Disclosure

License