GeoService 0.0.15

您想将类似于以下的内容添加到Podfile中：

target 'MyApp' do
  pod 'GeoService', '~> 0.0'
end

然后，在终端内或从CocoaPods.app中运行命令pod install

或者为了测试运行，运行以下命令：

pod try GeoService


依赖
AFNetworking	>= 0
Mantle	>= 0
GeoJSONSerialization	>= 0

GeoService 0.0.15

作者：
Daniel Ran Lehmann

AFNetworking是一个令人愉快的iOS和Mac OS X网络库。它是基于Foundation URL加载系统构建的，扩展了Cocoa中内置的强大高级网络抽象。它有一个模块化架构，拥有设计精良、功能丰富的API，易于使用。

然而，最重要的一点是，AFNetworking拥有一个惊人的开发者社区，他们每天都在使用并贡献给AFNetworking。AFNetworking为iPhone、iPad和Mac上的一些最受欢迎和最负盛誉的应用提供动力。

为您的下一个项目选择AFNetworking，或迁移现有项目，您会庆幸自己这么做了！

如何开始

下载AFNetworking并尝试包含的Mac和iPhone示例应用
阅读"如何开始"指南、常见问题或Wiki上的其他文章
查看文档，以全面了解AFNetworking中所有可用的API
阅读AFNetworking 3.0迁移指南，了解从2.0到3.0的架构变化概述。

沟通

如果您需要帮助，请使用Stack Overflow。（标签“afnetworking”）
如果您想提出一个一般性问题，请使用Stack Overflow。
如果您发现了一个错误，并且可以提供稳定重现它的步骤，请打开一个issue。
如果您有一个功能请求，请打开一个issue。
如果您想要贡献，请提交一个pull request。

安装

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

Podfile

要使用CocoaPods将AFNetworking集成到Xcode项目中，请在您的Podfile中指定它

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

pod 'AFNetworking', '~> 3.0'

然后，运行以下命令

$ pod install

要求

AFNetworking版本	最低iOS目标	最低OS X目标	最低watchOS目标	最低tvOS目标	备注
3.x	iOS 7	OS X 10.9	watchOS 2.0	tvOS 9.0	需要Xcode 7+。已移除 `NSURLConnectionOperation` 支持。
2.6 -> 2.6.3	iOS 7	OS X 10.9	watchOS 2.0	不适用	需要Xcode 7+。
2.0 -> 2.5.4	iOS 6	OS X 10.8	不适用	不适用	需要Xcode 5+。使用 `NSURLSession` 子规范需要iOS 7或OS X 10.9。
1.x	iOS 5	Mac OS X 10.7	不适用	不适用
0.10.x	iOS 4	Mac OS X 10.6	不适用	不适用

（OS X 项目必须支持具有现代Cocoa运行时的64位）。

使用Swift进行编程？尝试使用Alamofire提供的一个更常规的API集。

架构

NSURLSession

AFURLSessionManager
AFHTTPSessionManager

序列化

的子类
- AFHTTPRequestSerializer
- AFJSONRequestSerializer
- AFPropertyListRequestSerializer
的子类
- AFHTTPResponseSerializer
- AFJSONResponseSerializer
- AFXMLParserResponseSerializer
- AFXMLDocumentResponseSerializer（Mac OS X）
- AFPropertyListResponseSerializer
- AFImageResponseSerializer
- AFCompoundResponseSerializer

附加功能

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

URL表单参数编码

[[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 会话 706，“网络最佳实践”。。

共享网络可达性

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

[[AFNetworkReachabilityManager sharedManager] startMonitoring];

安全策略

AFSecurityPolicy通过安全连接检查服务器信任与固定X.509证书和公钥。

将固定SSL证书添加到您的应用有助于防止中间人攻击和其他漏洞。处理敏感客户数据或金融信息的应用程序应强烈建议通过配置并启用了SSL固定配置的HTTPS连接进行所有通信。

允许无效SSL证书

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

单元测试

AFNetworking在其Tests子目录内包含了一组单元测试。您可以通过在您想测试的平台框架上执行测试操作来简单地运行这些测试。

鸣谢

AFNetworking由Alamofire软件基金会拥有和维护。

AFNetworking最初由Scott Raymond和Mattt Thompson在开发iPhone版本的Gowalla时创建。

AFNetworking的标志由Alan Defibaugh设计。

最重要的是，感谢AFNetworking的不断增长的贡献者名单。

安全披露

如果您认为已发现AFNetworking的安全漏洞，请尽快通过电子邮件向[email&protected]报告。请勿将其发布在公开的问题跟踪器中。

许可

AFNetworking根据MIT许可证发布。请参阅LICENSE以获取详细信息。