jashion / ytknetwork

YTKNetwork is a high level request util based on AFNetworking.

YTKNetwork

What

YTKNetwork is 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
• block and delegate callback
• 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" ~> 2.0

Requirements

YTKNetwork Version	AFNetworking Version	Minimum iOS Target	Note
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 compability at AFNetworking README.

Guide & Demo

• Basic Usage Guide
• YTKNetwork 2.0 Migration Guide(Simplified Chinese)

Contributors

• lancy
• maojj
• veecci
• tangqiaoboy
• skyline75489

Acknowledgements

• AFNetworking
• AFDownloadRequestOperation

Thanks for their great work.  

License

YTKNetwork is available under the MIT license. See the LICENSE file for more info.