| commit | author | age | ||
| 3eceb5 | 1 | // |
| W | 2 | // VKBatchRequest.h |
| 3 | // | |
| 4 | // Copyright (c) 2014 VK.com | |
| 5 | // | |
| 6 | // Permission is hereby granted, free of charge, to any person obtaining a copy of | |
| 7 | // this software and associated documentation files (the "Software"), to deal in | |
| 8 | // the Software without restriction, including without limitation the rights to | |
| 9 | // use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of | |
| 10 | // the Software, and to permit persons to whom the Software is furnished to do so, | |
| 11 | // subject to the following conditions: | |
| 12 | // | |
| 13 | // The above copyright notice and this permission notice shall be included in all | |
| 14 | // copies or substantial portions of the Software. | |
| 15 | // | |
| 16 | // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR | |
| 17 | // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS | |
| 18 | // FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR | |
| 19 | // COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER | |
| 20 | // IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN | |
| 21 | // CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. | |
| 22 | ||
| 23 | #import "VKObject.h" | |
| 24 | #import "VKRequest.h" | |
| 25 | ||
| 26 | /** | |
| 27 | Used for execution bunch of methods at time, and receive results of that methods in array | |
| 28 | */ | |
| 29 | @interface VKBatchRequest : VKObject { | |
| 30 | @private | |
| 31 | ||
| 32 | NSMutableArray *_requests; | |
| 33 | NSMutableArray *_responses; | |
| 34 | BOOL _canceled; | |
| 35 | } | |
| 36 | /// Specify completion block for request | |
| 37 | @property(nonatomic, copy) void (^completeBlock)(NSArray *responses); | |
| 38 | /// Specity error (HTTP or API) block for request. | |
| 39 | @property(nonatomic, copy) void (^errorBlock)(NSError *error); | |
| 40 | ||
| 41 | /** | |
| 42 | Initializes batch processing with requests | |
| 43 | @param firstRequest ,... A comma-separated list of requests should be loaded, ending with nil. | |
| 44 | @return Prepared request | |
| 45 | */ | |
| 46 | - (instancetype)initWithRequests:(VKRequest *)firstRequest, ...NS_REQUIRES_NIL_TERMINATION; | |
| 47 | ||
| 48 | /** | |
| 49 | Initializes batch processing with requests array | |
| 50 | @param requests Array of requests should be loaded. | |
| 51 | @return Prepared request | |
| 52 | */ | |
| 53 | - (instancetype)initWithRequestsArray:(NSArray *)requests; | |
| 54 | ||
| 55 | /** | |
| 56 | Executes batch request | |
| 57 | @param completeBlock will receive result of passed requests | |
| 58 | @param errorBlock called if any request did fail | |
| 59 | */ | |
| 60 | - (void)executeWithResultBlock:(void (^)(NSArray *responses))completeBlock errorBlock:(void (^)(NSError *error))errorBlock; | |
| 61 | ||
| 62 | /** | |
| 63 | Cancel current batch operation | |
| 64 | */ | |
| 65 | - (void)cancel; | |
| 66 | @end | |
