AvenueFetcher 0.4.0

You want to add pod 'AvenueFetcher', '~> 0.4' similar to the following to your Podfile:

target 'MyApp' do
  pod 'AvenueFetcher', '~> 0.4'
end

Then run a pod install inside your terminal, or from CocoaPods.app.

Alternatively to give it a test run, run the command:

pod try AvenueFetcher


Depends on:
Avenue	~> 0.4
JSONModel	~> 1.1
PromiseKit/CorePromise	~> 3.0

AvenueFetcher 0.4.0

By
Dustin Bachrach

AvenueFetcher is a simple component that builds on Avenue. It provides an abstract class, AVEFetcher that makes fetching JSONModel model objects from network requests easy.

Installation

Setup

Simply Subclass AVEFetcher, and impelment +sharedFetcher:

@interface MYFetcher : AVEFetcher

@end

@implementation MYFetcher

+ (instancetype)sharedFetcher
{
    static id sharedInstance = nil;
    static dispatch_once_t onceToken;
    dispatch_once(&onceToken, ^{
        sharedInstance = [[self alloc] init];
    });
    return sharedInstance;
}

You also need to configure the fetcher's builder. A builder is an instance of AVEHTTPRequestOperationBuilder. It describes details about all of the fetcher's requests, like baseURL, request/response serialization, security policy, etc.

Typically, you will want to configure the builder in your -init method:

- (instancetype)init
{
    if (self = [super init]) {
        NSURL* baseURL = [NSURL URLWithString:@"https://myurl.com"];
        AVEHTTPRequestOperationBuilder* builder = [[AVEHTTPRequestOperationBuilder alloc] initWithBaseURL:baseURL];

        self.builder = builder;
    }
    return self;
}

Using the Fetcher

Making requests with the fetcher is simple:

[[MYFetcher sharedFetcher] fetchModel:MYModel.class
                                 path:@"model/1"
                              keyPath:nil
                           parameters:nil
                             priority:[AVENetworkPriority priorityWithLevel:AVENetworkPriorityLevelHigh]
                         networkToken:nil].then(^(MYModel* model) {
    // Use the `model`.
});

You can also make POST and PUT requests and treat the returned response as a model.

[[MYFetcher sharedFetcher] postAndFetchModel:MYModel.class
                                        path:@"model/1"
                                     keyPath:nil
                                  parameters:parameters].then(^(MYModel* model) {
    // Use the `model`.
});

[[MYFetcher sharedFetcher] putAndFetchModel:MYModel.class
                                       path:@"model/1"
                                    keyPath:nil
                                 parameters:parameters].then(^(MYModel* model) {
    // Use the `model`.
});

Author

MediaHound

License

Avenue is available under the Apache License 2.0. See the LICENSE file for more info.