YTKNetwork

by yuantiku

yuantiku / YTKNetwork

YTKNetwork is a high level request util based on AFNetworking.

6.2K Stars 1.6K Forks Last release: 6 months ago (3.0.0) MIT License 188 Commits 26 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

YTKNetwork

License MIT Pod version Carthage Compatible Platform info Build Status

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
  • 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" ~> 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.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.