Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/unamfi/SPTDataLoader
The HTTP library used by the Spotify iOS client
https://github.com/unamfi/SPTDataLoader
Last synced: 14 days ago
JSON representation
The HTTP library used by the Spotify iOS client
- Host: GitHub
- URL: https://github.com/unamfi/SPTDataLoader
- Owner: unamfi
- License: apache-2.0
- Fork: true (spotify/SPTDataLoader)
- Created: 2016-01-21T21:35:44.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2016-01-21T23:50:38.000Z (almost 9 years ago)
- Last Synced: 2024-08-02T08:09:34.465Z (4 months ago)
- Language: Objective-C
- Size: 340 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- Awesome-UNAM - Spotify Data Loader
README
[](https://coveralls.io/github/spotify/SPTDataLoader?branch=master)
[](https://travis-ci.org/spotify/SPTDataLoader)
[](LICENSE)
[](https://cocoapods.org/?q=SPTDataLoader)
[](https://github.com/Carthage/Carthage)
[](https://slackin.spotify.com)
Authentication and back-off logic is a pain, let's do it once and forget about it! This is a library that allows you to centralise this logic and forget about the ugly parts of making HTTP requests.
- [x] 📱 iOS 7.0+
- [x] đź’» OS X 10.8+
- [x] ⌚️ watchOS 2.0+
- [x] đź“ş tvOS 9.0+
## Architecture :triangular_ruler:
`SPTDataLoader` is designed as an HTTP stack with 3 additional layers on top of `NSURLSession`.
- **The Application level**, which controls the rate limiting and back-off policies per service, respecting the “Retry-After” header and knowing when or not it should retry the request.
- **The User level**, which controls the authentication of the HTTP requests.
- **The View level**, which allows automatic cancellation of requests the view has made upon deallocation.
### Authentication :key:
The authentication in this case is abstract, allowing the creator of the SPTDataLoaderFactory to define their own semantics for token acquisition and injection. It allows for asynchronous token acquisition if the token is invalid that seamlessly integrates with the HTTP request-response pattern.
### Back-off policy :cop:
The data loader service allows rate limiting of URLs to be set explicitly or to be determined by the server using the “Retry-After” semantic. It allows back-off retrying by using a jittered exponential backoff to prevent the thundering hordes creating a request storm after a predictable exponential period has expired.
## Usage example :eyes:
For an example of this framework's usage, see the demo application `SPTDataLoaderDemo` in `SPTDataLoader.xcodeproj`. Just follow the instructions in [`ClientKeys.h`](demo/ClientKeys.h).
## Background story :book:
At Spotify we have begun moving to a decentralised HTTP architecture, and in doing so have had some growing pains. Initially we had a data loader that would attempt to refresh the access token whenever it became invalid, but we immediately learned this was very hard to keep track of. We needed some way of injecting this authorisation data automatically into a HTTP request that didn't require our features to do any more heavy lifting than they were currently doing.
Thus we came up with a way to elegantly inject tokens in a Just-in-time manner for requests that require them. We also wanted to learn from our mistakes with our proprietary protocol, and bake in back-off policies early to avoid us DDOSing our own backends with huge amounts of eronious requests.
## Contributing :mailbox_with_mail:
Contributions are welcomed, have a look at the [CONTRIBUTING.md](CONTRIBUTING.md) document for more information.
## License :memo:
The project is available under the [Apache 2.0](http://www.apache.org/licenses/LICENSE-2.0) license.