Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kubatruhlar/afnetworking-retrypolicy
Nice category that adds the ability to set the retry interval, retry count and progressiveness.
https://github.com/kubatruhlar/afnetworking-retrypolicy
afnetworking cocoapods ios objective-c retry-policy
Last synced: 3 days ago
JSON representation
Nice category that adds the ability to set the retry interval, retry count and progressiveness.
- Host: GitHub
- URL: https://github.com/kubatruhlar/afnetworking-retrypolicy
- Owner: kubatruhlar
- License: mit
- Created: 2016-08-26T23:04:21.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2022-08-17T22:26:41.000Z (over 2 years ago)
- Last Synced: 2024-12-17T17:07:09.785Z (10 days ago)
- Topics: afnetworking, cocoapods, ios, objective-c, retry-policy
- Language: Objective-C
- Homepage:
- Size: 287 KB
- Stars: 212
- Watchers: 8
- Forks: 32
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
[](https://travis-ci.org/kubatruhlar/AFNetworking-RetryPolicy)
[](http://cocoapods.org/pods/AFNetworking+RetryPolicy)
[](http://cocoapods.org/pods/AFNetworking+RetryPolicy)
[](http://cocoadocs.org/docsets/AFNetworking+RetryPolicy/)
[](https://gitter.im/AFNetworking-RetryPolicy/General?utm_source=share-link&utm_medium=link&utm_campaign=share-link)
[](http://cocoapods.org/pods/AFNetworking+RetryPolicy)
If a request timed out, you usually have to call that request again by yourself. **AFNetworking+RetryPolicy** is an **objective-c** category that adds the ability to set the retry logic for requests made with [AFNetworking](https://github.com/AFNetworking/AFNetworking).
- [Features](#features)
- [Getting started](#getting-started)
- [Usage](#usage)
- [Requirements](#requirements)
- [Old versions](#old-versions)
- [Author and credit](#author-and-credit)
- [License](#license)
## Features
- [x] **retryCount** - How many times to try.
- [x] **retryInterval** - Time interval between attempts in seconds.
- [x] **progressive** - Next attempt will always take more time than the previous one. *(Uses Exponentiation)*
- [x] **fatalStatusCodes** - These will trigger failure block immediately when received and ends current retry.
## Getting started
- Installing through **[CocoaPods](https://cocoapods.org/)** with `pod 'AFNetworking+RetryPolicy'`
- Use `#import "AFHTTPSessionManager+RetryPolicy.h"` directive.
> Want to try it first? Use `pod try AFNetworking+RetryPolicy` command.
## Usage
### Example
- Simple `GET` request with **AFNetworking+RetryPolicy** could look like this:
```objective-c
AFHTTPSessionManager *manager = [AFHTTPSessionManager new];
[manager GET:@"foo" parameters:nil headers:nil progress:nil success:^(NSURLSessionDataTask *task, id responseObject) {
NSLog(@"%@", responseObject);
} failure:^(NSURLSessionDataTask *task, NSError *error) {
NSLog(@"%@", error.localizedDescription);
} retryCount:5 retryInterval:2.0 progressive:false fatalStatusCodes:@[@401, @403]];
```
### Log
- Enable to see what is happening by setting the `AFHTTPSessionManager`’s `retryPolicyLogMessagesEnabled` property to `true`. *Disabled by default.*
## Requirements
- **[AFNetworking](https://github.com/AFNetworking/AFNetworking) 4.0 or later**
- Target iOS 9 or later
- Target OS X/macOS 10.10 or later
- Xcode 11 or later
## Old versions
#### For [AFNetworking](https://github.com/AFNetworking/AFNetworking) 3 support
- use version 1.x.
#### For [AFNetworking](https://github.com/AFNetworking/AFNetworking) 2 support\*
- use branch [`afn2-support`](https://github.com/kubatru/AFNetworking-RetryPolicy/tree/afn2-support).
- Installing through **[CocoaPods](https://cocoapods.org/)** with `pod 'AFNetworking+RetryPolicy', git: 'https://github.com/kubatruhlar/AFNetworking-RetryPolicy.git' , branch: 'afn2-support'`
> \*Will not be updated anymore.
#### For [AFNetworking](https://github.com/AFNetworking/AFNetworking) 1 support\*
- use branch [`afn1-support`](https://github.com/kubatru/AFNetworking-RetryPolicy/tree/afn1-support).
- Installing through **[CocoaPods](https://cocoapods.org/)** with `pod 'AFNetworking+RetryPolicy', git: 'https://github.com/kubatruhlar/AFNetworking-RetryPolicy.git' , branch: 'afn1-support'`
> \*Will not be updated anymore.
## Author and credit
- This library is open-sourced and maintained by [Jakub Truhlář](http://kubatruhlar.cz).
- AFNetworking is owned and maintained by the [Alamofire Software Foundation](http://alamofire.org).
## License
- Like :+1: [AFNetworking](https://github.com/AFNetworking/AFNetworking), this category is published under the MIT License. See LICENSE.md for details.