CTNetwork

A network framework based on AFNetworking

##CTNetwork是什么？ CTNetwork是一个基于AFNetworking封装的一个网络框架，它主要由CTNetworkManager、CTBaseRequest、CTNetworkConfiguration、CTNetworkCache组成。它的工作流程是先将每个网络请求封装成一个Request对象，然后交给CTNetworkManager发送请求，最后使用block调用回来。

##有哪些功能？

• 支持统一设置baseURL
• 支持多域名间切换
• 提供对HTTP请求头的统一配置以及添加特殊请求头配置
• 提供请求参数统一(和针对某写接口自定义)加密方法
• 支持同一请求多次发送过滤的功能
• 支持对网络请求的数据进行缓存以及配置不同的缓存策略(仅采用磁盘缓存)
• 提供对Response解密的入口
• 支持文件断点下载
• 支持不同的缓存策略请求以及缓存有效期的设置
• 扩展了批量发送请求

##类的介绍 ####CTBaseRequest 网络请求类，当发起一个网络请求的时候，需要子类化这个类。CTBaseRequest提供了跟业务相关的设置，例如设置是GET请求还是POST请求、请求的方法名、请求的业务参数、缓存策略、请求头等等。当需要发起一个请求时，使用startRequestWithSuccess发起请求，使用cancelRequest类方法取消请求。

####CTNetworkConfiguration 这是一个整个网络的配置类，它提供的功能有：

• 配置baseURL
• 对CTNetworkRequest进行预处理(可指定不同的域名)
• 对请求统一设置HTTP Header
• 对参数进行加密处理方法
• 对Response进行解密
• 统一配置对某个请求是否缓存

####CTNetworkManager 它是一个单例，协调着CTBaseRequest、CTNetworkCache和CTNetworkConfiguration三者进行工作。

####CTNetworkCache 一个以写文件的形式进行缓存的类。

##如何使用？

首先，子类化一个CTNetworkConfiguration类，实现CTNetworkConfiguration协议，对网络进行配置，在Appdelegate.m文件中将它设置给CTNetworkManager。

     [CTNetworkManager setNetConfig:^(CTNetworkConfiguration * _Nonnull config) {
        config.baseURLString = @"http://www.weather.com.cn/";
        config.acceptableContentTypes = [NSSet setWithObjects:@"application/json", @"text/json", @"text/javascript",@"text/html", nil];
        config.requestSerializerType = CTRequestSerializerTypeHTTP;
        config.responseSerializerType = CTResponseSerializerTypeJSON;
        config.isDebug = YES;
    }];```

* GET 或 POST 请求

     [CTNetworkManager startGET:^(CTBaseRequest * _Nonnull req) {
        req.interface = @"data/sk/101010100.html";
        req.cachePolicy = CTCacheRefreshCacheAndLoadData;
        req.isCancleSendWhenExciting = YES;
        req.cacheValidInterval = 60;
    } success:^(CTBaseRequest * _Nonnull request, id  _Nullable responseObj) {
        
    } failure:^(CTBaseRequest * _Nonnull request, NSError * _Nullable error) {
        
    }];


* 文件上传
      CTBaseRequest * request = [[CTBaseRequest alloc] initWithInterface:@"api/index/uploadPhoto"];
      request.formData = ^(id <AFMultipartFormData>  _Nonnull formData) {
            NSData * imageData = UIImageJPEGRepresentation(self.idHandImageView.image, 0.8);
            [formData appendPartWithFileData:imageData name:@"picFile" fileName:@"photo.jpg" mimeType:@"image/jpeg"];
        };
      [request startUploadRequestWithProgress:^(NSProgress * _Nonnull uploadProgress) {
           NSLog(@"%lld %lld", uploadProgress.totalUnitCount, uploadProgress.completedUnitCount);
      } success:^(VJBaseRequest * _Nonnull request, id  _Nullable responseObj) {
           NSLog(@"responseObj = %@", responseObj);
      } failure:^(VJBaseRequest * _Nonnull request, NSError * _Nullable error) {
           NSLog(@"error = %@", error);
      }];

* 文件下载
    [CTNetworkManager startDownload:^(CTBaseRequest * _Nonnull req) {
        req.interface = @"http://dl.bizhi.sogou.com/images/2012/01/19/174522.jpg";
        req.cachePolicy = CTCacheRefreshCacheData;
    } progress:^(NSProgress * _Nonnull progress) {
        NSLog(@"%lld === %lld", progress.totalUnitCount, progress.completedUnitCount);
    } complectHandler:^(CTBaseRequest * _Nonnull request, NSURL * _Nullable filePath, NSError * _Nullable error) {
        NSLog(@"%@ %@", filePath.absoluteString, error);
    }];

##Podfile

 platform :ios, '7.0'
 pod "CTNetwork", :git=>'https://github.com/Excalibur-CT/CTNetwork'