iOS Framework: Introducing MKNetworkKit

 
既然代码都是ARC的。那么是否对Engine的实例进行strong引用取决于开发人员。 

当你创建一个MKNetworkEngine子类，Reachability的会自己主动实现。这样当server宕机或者其它不可预料的情况下时，请求会被自己主动的队列或者冻结。想要获取很多其它关于冻结操作的信息。请阅读后面冻结操作相关的章节。

步骤 2:设计 Engine 类 (分离考虑) 

让我们開始在YahooEngine里面编写获取货币交换率的代码。

Engine里面的方法会在ViewController里面调用。一个好的设计实践就是确保你的Engine类不会暴露URL和http的请求头给调用的类。你的View层不应该知道url路径以及须要的參数，就是相应着YahooEngine里面的货币及以及货币单位。

返回的数据能够为double值表示货币交换率或者时间戳。由于请求都是异步的。你应该在block里面返回这些值，比方： 

-(MKNetworkOperation*) currencyRateFor:(NSString*) sourceCurrency
                           inCurrency:(NSString*) targetCurrency
              onCompletion:(CurrencyResponseBlock) completion
                           onError:(ErrorBlock) error;

typedef void (^ProgressBlock)(double progress);
typedef void (^ResponseBlock)(MKNetworkOperation* operation);
typedef void (^ErrorBlock)(NSError* error);

在YahooEngine里面，我们使用一种新的block，CurrencyResponseBlock来返回交换率的值，定义例如以下： 

typedef void (^CurrencyResponseBlock)(double rate);

 
在不论什么其它app里面，你都应该丁一你的block的方法类似于CurrencyResponseBlock这种来给viewController传回值。 

步骤 3: 处理返回数据 
处理数据，就是转换你从server取回的数据，不论时Json还是XML或者二进制plist。都应该在Engine里面完毕。再次声明，不要让你的Viewcontroller做这件事，你的Engine应该只发回正确的model对象或者model对象的数组。

在Engine中转换json或者xml。

再次声明。为了确保分类原则，你的viewController应该不知道从json里面获取单个元素的key。 
这就是设计Engine的准则了，大部分的网络库不强迫你遵循一些接口分离的原则，但我do，由于我爱你。 

步骤4: 方法实现 
如今我们讨论一下计算货币交换率的方法的详细实现细节 
从yahoo获取交换率。就是一个简单的GET请求，我写了一个宏来定义获取货币率的url请求的格式 

#define YAHOO_URL(__C1__, __C2__) [NSString stringWithFormat:@"d/quotes.csv?e=.csv&f=sl1d1t1&s=%@%@=X", __C1__, __C2__]

1. 准备好url和请求參数
2. 创建一个请求的MKNetworkOperation对象.
3. 设置方法參数
4. 加入完毕和错误处理方法，（完毕方法就是你处理你响应到对应的model类的地方）
5. 可选的。还有请求操作的进度指示。（或者在viewController里面处理）
6. 假设你的操作时下载文件，那么设置一个下载的流（一般是一个文件）给他，这也是可选的
7. 当请求操作完毕时，处理结果而且调用block方法来向调用方法返回数据。

        MKNetworkOperation *op = [self operationWithPath:YAHOO_URL(sourceCurrency, targetCurrency)
                                                  params:nil 
                                            httpMethod:@"GET"]; 
   [op onCompletion:^(MKNetworkOperation *completedOperation)     {
         DLog(@"%@", [completedOperation responseString]);
         // do your processing here
         completionBlock(5.0f);
     }onError:^(NSError* error) {
         errorBlock(error);     }];
    [self enqueueOperation:op];
    return op;[/pre]

    [self.uploadOperation onUploadProgressChanged:^(double progress) { 
       DLog(@"%.2f", progress*100.0);
        self.uploadProgessBar.progress = progress;    }];

       MKNetworkOperation *op = [self operationWithPath:YAHOO_URL(sourceCurrency, targetCurrency)];

[operation setDownloadStream:[NSOutputStream
    outputStreamToFileAtPath:@"/Users/mugunth/Desktop/DownloadedFile.pdf"
              append:YES]];

    [op onCompletion:^(MKNetworkOperation *completedOperation)     {
         if([completedOperation isCachedResponse]) { 
            DLog(@"Data from cache");
         }         else { 
            DLog(@"Data from server");         }
        DLog(@"%@", [completedOperation responseString]); 
    }onError:^(NSError* error) {
         errorBlock(error);     }];

[op setFreezable:YES];