YTKNetwork
What
YTKNetwork is a high level request util based on AFNetworking. It's developed by the iOS Team of YuanTiKu. It provides a High Level API for network request.
YTKNetwork is used in all products of YuanTiKu, including: YuanTiKu, YuanSoTi, YuanFuDao, FenBiZhiBoKe.
Features
- Response can be cached by expiration time
- Response can be cached by version number
- Set common base URL and CDN URL
- Validate JSON response
- Resume download
blockanddelegatecallback- Batch requests (see
YTKBatchRequest) - Chain requests (see
YTKChainRequest) - URL filter, replace part of URL, or append common parameter
- Plugin mechanism, handle request start and finish. A plugin for show "Loading" HUD is provided
Who
YTKNetowrk is suitable for a slightly more complex project, not for a simple personal project.
YTKNetwork is helpful if you want to cache requests, manage the dependences of requests, or validate the JSON response. And if you want to cache requests based on request version, this is one of the greatest advantages of YTKNetwork.
Why
YTKNetwork provides YTKRequest to handle every network request. You should inherit it and override some methods to define custom requests in your project.
The main idea is use the Command Pattern. The benefits are:
- Your code is decoupled to detail network request framework, it's easy to replace it. Actually, YTKNetwork is originally based on ASIHttpRequest, we just spent two days to switch to AFNetworking.
- Handle common logic in base class.
- Easier Persistence
But YTKNetwork is not suitable if your project is very simple. You can use AFNetworking directly in controller.
Installation
To use YTKNetwork add the following to your Podfile
pod 'YTKNetwork'
Or add this in your Cartfile:
github "yuantiku/YTKNetwork" ~> 3.0
Requirements
| YTKNetwork Version | AFNetworking Version | Minimum iOS Target | Note |
|---|---|---|---|
| 3.x | 4.x | iOS 9 | Xcode 11+ is required. |
| 2.x | 3.x | iOS 7 | Xcode 7+ is required. |
| 1.x | 2.x | iOS 6 | n/a |
YTKNetwork is based on AFNetworking. You can find more detail about version compatibility at AFNetworking README.
Guide & Demo
Contributors
Acknowledgements
Thanks for their great work.
License
YTKNetwork is available under the MIT license. See the LICENSE file for more info.