MKNetworkKit 的使用

现在，大家使用最多的网络框架基本上就是AFNetworking，ASIHttpRequest，MKNetWorkKit等。

ASIHttpRequest功能很强大，早期的项目使用的较多，只是后续不再更新维护了，因此已成为过去时。

而AFNetworking采用了block模式，代码的紧凑性和可读性得到了大幅度的提升，现在手头上的几个项目就使用了这个框架。该框架不提交接口数据缓存功能，可以通过NSURLCache来缓存接口数据。根据自己的验证，NSURLCache仅可缓存请求方式GET的接口数据，POST无法缓存，不过可以自己扩展，将返回的responseObject通过比如归档的方法进行本地持久化。

而MKNetWorkKit下载了源码和demo，然后把源码的整体思路理通了。由于还没在项目中使用，仅将找到的一些资料整理出来，以便后期进行验证。

========================================================================================

在苹果开发中，我们可以使用苹果提供的NSURLConnection和NSURLRequest网络请求API来解决大部分的WebService请求，但使用起来不是很简洁方便，因此正面介绍一个第三方提供的网络框架MKNetworkKit。

1、什么是MKNetworkKit?

MKNetworkKit 是一个使用十分方便，功能又十分强大、完整的iOS网络编程代码库，完全基于 ARC。它只有两个类, 它的目标是使用像AFNetworking这么简单，而功能像ASIHTTPRequest(已经停止维护)那么强大。

 

2、MKNetworkKit有哪些优点？

1、高度的轻量级，仅仅只有2个主类；

2、自主操作多个网络请求；

3、更加准确的显示网络活动指标；

4、自动设置网络速度，实现自动的2G、3G、wifi切换；

5、自动缓冲技术的完美应用，实现网络操作记忆功能，当你掉线了又上线后，会继续执行未完成的网络请求；

6、可以实现网络请求的暂停功能；

7、准确无误的成功执行一次网络请求，摒弃后台的多次请求浪费；

8、支持图片缓冲；

9、支持ARC机制；

10、在整个app中可以只用一个队列（queue），队列的大小可以自动调整。

 

3、如何配置MKNetworkKit？

1、从https://github.com/MugunthKumar/MKNetworkKit下载MKNetworkKit；

2、将下载包中的 MKNetWorkKit 文件夹拖到你新建的工程中；

3、在项目设置中添加：SystemConfiguration.framework，CFNetwork.framework，Security.framework和ImageIO.framework，如下所示。

 

 

4、如何进行网络请求

MKNetworkKit中主要有两个类：MKNetworkOperation和MKNetworkEngine。MKNetworkOperation是NSOperation的子类并且封装了请求相应类，我们需要为每一个网络请求创建一个MKNetworkOperation。MKNetworkEngine负责管理网络队列，对于简单的请求，我们应该直接使用MKNetworkEngine的方法，对于复杂的需求，我们可以子类化MKNetworkEngine。下面就介绍基本的网络实现，其中包括GET请求和POST请求：

在需要使用的地方导入：#import"MKNetworkKit.h"

 http方式：

    GET请求：     

[cpp]  view plain copy

1. MKNetworkEngine *engine = [[MKNetworkEngine alloc] initWithHostName:@"192.168.2.176:3000" customHeaderFields:nil];  
2. MKNetworkOperation *op = [engine operationWithPath:@"/index" params:nil httpMethod:@"GET" ssl:NO];  
3. [op addCompletionHandler:^(MKNetworkOperation *operation) {  
4.     NSLog(@"[operation responseData]-->>%@", [operation responseString]);  
5. }errorHandler:^(MKNetworkOperation *errorOp, NSError* err) {  
6.     NSLog(@"MKNetwork request error : %@", [err localizedDescription]);  
7. }];  
8. [engine enqueueOperation:op];  

    POST请求：

[cpp]  view plain copy

1. MKNetworkEngine *engine = [[MKNetworkEngine alloc] initWithHostName:@"192.168.2.176:3000" customHeaderFields:nil];  
2. NSMutableDictionary *dic = [[NSMutableDictionary alloc] init];  
3. [dic setValue:@"admin" forKey:@"username"];  
4. [dic setValue:@"123" forKey:@"password"];  
5.   
6. MKNetworkOperation *op = [engine operationWithPath:@"/login" params:dic httpMethod:@"POST"];  
7. [op addCompletionHandler:^(MKNetworkOperation *operation) {  
8.     NSLog(@"[operation responseData]-->>%@", [operation responseString]);  
9. }errorHandler:^(MKNetworkOperation *errorOp, NSError* err) {  
10.     NSLog(@"MKNetwork request error : %@", [err localizedDescription]);  
11. }];  
12. [engine enqueueOperation:op];  

    https方式：

[cpp]  view plain copy

1. #define serverHost               @"192.168.1.84:5558"  
2.   
3. - (NSDictionary *)getDataFromURL:(NSString *)Path params:(NSDictionary *)data  
4. {  
5.     NSLog(@"MKNetwork request URL:  %@%@   \n Data: %@",serverHost,Path,data);  
6.       
7.     __block NSDictionary *responseJSON;  
8.     __block NSError *error = nil;  
9.     MKNetworkEngine *engine = [[MKNetworkEngine alloc] initWithHostName:serverHost customHeaderFields:nil];  
10.     MKNetworkOperation *op = [engine operationWithPath:Path  params:data httpMethod:@"POST" ssl:YES];  
11. //    在请求中添加证书  
12.     op.clientCertificate = [[[NSBundle mainBundle] resourcePath] stringByAppendingPathComponent:@"client.p12"];  
13.     op.clientCertificatePassword = @"test";  
14. //   当服务器端证书不合法时是否继续访问  
15.     op.shouldContinueWithInvalidCertificate=YES;  
16.     [op addCompletionHandler:^(MKNetworkOperation *operation) {  
17.         NSLog(@"[operation responseData]-->>%@", [operation responseString]);  
18.         responseJSON=[NSJSONSerialization JSONObjectWithData:[operation responseData] options:kNilOptions error:&error];  
19.         if(error) {  
20.             NSLog(@"JSONSerialization failed! - error: %@", error);  
21.         };  
22.         error=nil;  
23.     } errorHandler:^(MKNetworkOperation *errorOp, NSError* err) {  
24.         error=err;  
25.     }];  
26.     [engine enqueueOperation:op];  
27.     while(!error&&!responseJSON){}  
28.     if (error) {  
29.         NSLog(@"MKNetwork request error : %@", error);  
30.         return nil;  
31.     }  
32.     if(responseJSON){  
33.         NSLog(@"JSONSerialization successed! - responseJSON: %@", responseJSON);  
34.     }  
35.     return responseJSON;  
36. }  
37.   
38.   
39.     NSDictionary *params=[NSDictionary dictionaryWithObjectsAndKeys:@"admin",@"userName", @"123",@"password", nil];  
40.     NSDictionary *responseDict = [self getDataFromURL:@"/login" params:params];  

下载文件：

[cpp]  view plain copy

1. +(MKNetworkOperation*) downloadFatAssFileFrom:(NSString*) remoteURL toFile:(NSString*) filePath {  
2.     MKNetworkEngine *engine = [[MKNetworkEngine alloc] initWithHostName:@"127.0.0.1:5558" customHeaderFields:nil];  
3.     MKNetworkOperation *op = [engine operationWithURLString:remoteURL  
4.                                                    params:nil  
5.                                                httpMethod:@"GET"];  
6.       
7.     [op addDownloadStream:[NSOutputStream outputStreamToFileAtPath:filePath  
8.                                                             append:YES]];  
9.     [engine enqueueOperation:op];  
10.     return op;  
11. }  
12. +(void)testDownload{  
13.     NSArray *paths = NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES);  
14.     NSString *cachesDirectory = [paths objectAtIndex:0];  
15.     NSString *downloadPath = [cachesDirectory stringByAppendingPathComponent:@"DownloadedFile.pdf"];  
16.       
17.     MKNetworkOperation *downloadOperation=[HttpManager downloadFatAssFileFrom:@"http://127.0.0.1:5558/QQ"  
18.                                                                       toFile:downloadPath];  
19.       
20.     [downloadOperation onDownloadProgressChanged:^(double progress) {  
21.         //下载进度  
22.         NSLog(@"download progress: %.2f", progress*100.0);  
23.     }];  
24.     //事件处理  
25.     [downloadOperation addCompletionHandler:^(MKNetworkOperation* completedRequest) {  
26.         NSLog(@"download file finished!");  
27.     }  errorHandler:^(MKNetworkOperation *errorOp, NSError* err) {  
28.         NSLog(@"download file error: %@", err);  
29.     }];  
30. }  

上传文件：

[cpp]  view plain copy

1. +(MKNetworkOperation*) uploadImageFromFile:(NSString*) filePath mimeType:(NSString *)fileType{  
2.     MKNetworkEngine *engine = [[MKNetworkEngine alloc] initWithHostName:@"127.0.0.1:5558" customHeaderFields:nil];  
3.     MKNetworkOperation *op = [engine operationWithPath:@"upload"  
4.                                               params:[NSDictionary dictionaryWithObjectsAndKeys:  
5.                                                       @"admin", @"username",  
6.                                                       @"123", @"password",nil]  
7.                                           httpMethod:@"POST"];  
8.       
9.     [op addFile:filePath forKey:@"media" mimeType:fileType];  
10.       
11.     // setFreezable uploads your images after connection is restored!  
12.     [op setFreezable:YES];  
13.       
14.     [op addCompletionHandler:^(MKNetworkOperation* completedOperation) {  
15.           
16.         NSString *responseString = [completedOperation responseString];  
17.         NSLog(@"server response: %@",responseString);  
18.     } errorHandler:^(MKNetworkOperation *errorOp, NSError* err){  
19.           
20.         NSLog(@"Upload file error: %@", err);  
21.     }];  
22.       
23.     [engine enqueueOperation:op];  
24.       
25.     return op;  
26. }  
27.   
28. +(void)testUpload{  
29.     NSString *uploadPath = [[[NSBundle mainBundle] resourcePath] stringByAppendingPathComponent:@"SampleImage.jpg"];  
30.     //    NSData *myData = [NSData dataWithContentsOfFile:uploadPath];  
31.     //    NSLog(@">>>>>>>>%@",myData);  
32.     MKNetworkOperation *uploadOperation = [HttpManager uploadImageFromFile:uploadPath mimeType:@"jpg"];  
33.     [uploadOperation onUploadProgressChanged:^(double progress) {  
34.         //        上传进度  
35.         DLog(@"Upload file progress: %.2f", progress*100.0);  
36.     }];  
37. }  

上传文件时服务器端程序(Node.Js):

[javascript]  view plain copy

1. var express = require('express')  
2.     ,fs=require('fs');  
3.   
4. var app = module.exports = express.createServer();  
5. // Configuration  
6. app.configure(function(){  
7.     app.use(express.bodyParser());  
8.     app.use(express.methodOverride());  
9.     app.use(app.router);  
10. });  
11. // Routes  
12. app.post('/upload', function(req, res) {  
13.     console.log(req);  
14.     var tmp_path = req.files.media.path; // 获得文件的临时路径  
15.     var target_path = './'+req.files.media.name;// 指定文件上传后的目录  
16.     fs.rename(tmp_path, target_path, function(err) { // 移动文件  
17.         if (err) throw err;  
18.         fs.unlink(tmp_path, function() {// 删除临时文件夹文件,  
19.             if (err) throw err;  
20.             res.send({server:'success'});  
21.             res.end();  
22.         });  
23.     });  
24. });  
25. app.listen(5558);  
26. console.log("Express server listening on port %d in %s mode", app.address().port, app.settings.env);