M2DAPIGatekeeper 2.1.2

M2DAPIGatekeeper 2.1.2

TestsTested
LangLanguage Obj-CObjective C
License MIT
ReleasedLast Release Sep 2017

Maintained by Akira Matsuda.



  • By
  • Akira Matsuda

Requirements

  • Runs on iOS 7.0 or later.

Contribution

Please use git flow and send pull request to develop branch.

Usage

To run the example project, clone the repo, and run pod install from the Example directory first.

Only two steps to send request like this.

// Send asynchronous request
M2DAPIRequest *r = [M2DAPIRequest GETRequest:[NSURL URLWithString:@"URL"]];
[[r whenSucceeded:^(M2DAPIRequest *request, NSDictionary *httpHeaderFields, id parsedObject) {
    //When result condition is true
}] whenFailed:^(M2DAPIRequest *request, NSDictionary *httpHeaderFields, id parsedObject, NSError *error) {
    //When result condition is false
}];

A lot of methods to control each sequences. For example,

M2DAPIGatekeeper *gatekeeper = [M2DAPIGatekeeper sharedInstance];
[gatekeeper parseBlock:^id(NSData *data, NSError *__autoreleasing *error) {
    id result = nil;
    if (*error == nil) {
        result = [NSJSONSerialization JSONObjectWithData:data options:NSJSONReadingAllowFragments error:error];
    }
    return result;
}];

[gatekeeper resultConditionBlock:^BOOL(M2DAPIRequest *request, NSURLResponse *response, id parsedObject, NSError *__autoreleasing *error) {
    return [(NSHTTPURLResponse *)response statusCode] == 200;
}];

[gatekeeper initializeBlock:^(M2DAPIRequest *request, NSDictionary *params) {
    dispatch_async(dispatch_get_main_queue(), ^{
        // Show hud when start request
    });
}];
[gatekeeper finalizeBlock:^(M2DAPIRequest *request, NSDictionary *httpHeaderField, id parsedObject) {
    dispatch_async(dispatch_get_main_queue(), ^{
        // Dismiss hud when finish request
    });
}];

and so more.

When start connection, unique identifier is generated. You can use the identifier to cancel request .

NSString *identifier = [gatekeeper sendRequest:...];
[gatekeeper cancelRequestWithIdentifier:identifier];

Please see also M2DAPIGatekeeper.h or M2DAPIRequest.h.

Author

Akira Matsuda, [email protected]

License

M2DAPIGatekeeper is available under the MIT license. See the LICENSE file for more info.