MGJRequestMaager是一款基于AFNetwokrig2.0+的iOS网络库。
一般在做项目时，我们都会在AFNetworkig的基础上再封装一层，加入一些业务逻辑，然后作为统一的API层。细分下来的话，功能点其实不多，且相对固定和通用，就索性把这些常用的功能统一处理，并提供灵活的使用方式，于是就有了MGJRequestMaager。
MGJRequestMaager目前被用在「蘑菇街」，「小店」等App中，已稳定运行了一段时间。
强大以「蘑菇街」为例，统计这块会计算请求消耗的时间、每次请求都要发送的参数、据请求参数的值计算toke、缓存请求以便快速呈现等等，MGJRequestMaager都可以比较方便地搞定。
主要功能缓存GET请求（可以方便地开启/关闭）
设置Builti参数（每次请求都会带上的参数，如设备型号等）
符合某种（自定义）条件时，可以不发送请求（比如用户多次点击「喜欢」按钮）
对请求结果做预处理（比如将服务端返回的数据包装成统一的格式）
串行发送多个请求（比如toke过期后，可以将请求新toke和当前请求串起来）
并行发送多个请求，可以告知请求完成数，以及全部请求完成后调用某个callback
发送请求时显示loadig，发送完成后隐藏loadig
上传图片
取消正在发送的请求
灵活因为需求经常会变，所以架构需要非常灵活才能方便应对新功能，比如「发送请求时显示loadig，发送完成后隐藏loadig」这个只是利用了现成的接口实现的一个特性。一些常见的需求都可以通过对MGJRequestMaager进行配置来实现。
思想本着「everythigshouldbeassimpleaspossible,butotsimpler」的原则，设计这个类库时，希望使用起来和理解起来尽量方便，同时又足够灵活，可以应付大多数的场景。
主要分为两部分MGJRequestMaagerCofiguratio和MGJRequestMaager，前者做一些自定义配置，比如请求发送前/后的预处理，baseURL，userIfo等。后者记录下这些信息，在适当的时候消费它们，同时支持针对某些特殊请求做自定义配置。
安装pod 'MGJRequestMaager'gif演示使用以「发送请求时显示loadig，发送完成后隐藏loadig」为例
// 1MGJRequestMaagerCofiguratio *cofiguratio = [[MGJRequestMaagerCofiguratio alloc] iit];UIActivityIdicatorView *idicatorView = [[UIActivityIdicatorView alloc] iitWithActivityIdicatorStyle:UIActivityIdicatorViewStyleGray];idicatorView.frame = CGRectMake(self.view.frame.size.width / 2 - 8, self.view.frame.size.height / 2 - 8, 16, 16);[self.view addSubview:idicatorView];// 2cofiguratio.requestHadler = ^(AFHTTPRequestOperatio *operatio, id userIfo, BOOL *shouldStopProcessig) { if (userIfo[@"showLoadig"]) { [idicatorView startAimatig]; }};// 3cofiguratio.resposeHadler = ^(AFHTTPRequestOperatio *operatio, id userIfo, MGJRespose *respose, BOOL *shouldStopProcessig) { if (userIfo[@"showLoadig"]) { [idicatorView stopAimatig]; }};[MGJRequestMaager sharedIstace].cofiguratio = cofiguratio;// 4[[MGJRequestMaager sharedIstace] GET:@"https://httpbi.org/delay/2" parameters:il startImmediately:YES // 5 cofiguratioHadler:^(MGJRequestMaagerCofiguratio *cofiguratio){ cofiguratio.userIfo = @{@"showLoadig": @YES}; // 6 } completioHadler:^(NSError *error, id<NSObject> result, BOOL isFromCache, AFHTTPRequestOperatio *operatio) { [self appedLog:result.descriptio]; // 7 }];MGJRequestMaager要配合MGJRequestMaagerCofiguratio才能发挥出威力。这个cofiguratio可以配置baseURL,requestHadler,resposeHadler等信息，可变部分一般是通过对MGJRequestMaagerCofiguratio进行配置来实现的。可以全局设置一个cofiguratio，然后单独发送请求时还可以覆盖默认设置。
requestHadler这个block会在请求发送前被触发，userIfo这个参数时cofiguratio这个实例的一个属性，方便起见，作为参数传给了requestHadler。还有一个重要的参数时*shouldStopProcessig，如果在这个block里，它被设置为了YES，那么这个请求将不会被发送。
resposeHadler这个block会在收到服务端的响应后被触发，respose参数有error和result两个属性，服务端返回的数据都被放到了result属性里，在这里可以对它进行解析，然后重新设置respose。如果*shouldStopProcessig被设置为了YES，那么completioHadler就不会被触发。
POST/PUT/DELETE只需把GET换成对应的HTTPMethod即可。
startImmediately如果设为NO，那么这个请求不会被发送，可以将来通过调用-[MGJRequestMaagerstartOperatio:]来发送，或者也可以放到队列里。
这里会传入默认的cofiguratio，如果需要在这个请求做一些个性化设置，可以修改cofiguratio里相应地配置。
这里的result就是-[MGJResposeresult],error是-[MGJResposeerror],isFromCache表示这个结果是否来自缓存。
评论