NetworkLottiePlugin 1.0.8

NetworkLottiePlugin 1.0.8

×

由77维护。

 
依赖项
Booming/Core>= 0
lottie-ios>= 0
 

NetworkLottiePlugin 1.0.8

Booming

Carthage compatible CocoaPods Compatible CocoaPods Compatible CocoaPods Compatible Platform

Booming是一个Swift的网络基础库。为Swift 5开发，旨在利用最新的语言特性。该框架的最终目标是实现易于使用的网络，使其易于编写可维护的代码。

HollowCodable是Swift的属性包装器库，用于可编码的自定义。

RxNetworks是一个Swift的声明式和响应式网络库。

🧚. RxSwift + Moya + HandyJSON/Codable + 插件。👒👒👒

英语 | 简体中文

这是一个基于Moya的基础设施网络api集，也支持响应式网络与RxSwift结合。

特性

目前，Booming最重要的特性可以总结如下

  • 支持与RxSwift组合的响应式网络请求。
  • 支持OOP，也支持POP网络请求。
  • 支持使用HandyJSON和Codable进行数据解析。
  • 支持配置通用请求、路径、通用参数等。
  • 支持为Moya简单自定义各种网络插件。
  • 支持上传和下载文件/资源等。
  • 支持通过BoomingSetup.basePlugins添加默认插件。
  • 支持使用Alamofire的RequestInterceptor设置授权证书。
  • 支持自动管理加载插件hud。
  • 支持执行token插件验证和自动重试新的token请求。
  • 支持为您预装了18个插件。

用法

如何使用行为准则。

SharedAPI.userInfo(name: "yangKJ").request(success: { json, finished in
    // do somthing..
}, failure: { error in
    print(error.localizedDescription)
})

or

TokenAPI.auth.request(complete: { res in
    switch res {
    case let .success(json):
        // do somthing..
    case let .failure(error):    
        print(error.localizedDescription)
    }
})

插件

此模块主要基于Moya网络相关插件封装。

  • 目前，已为您封装了14个插件可供使用。
    • Header: 网络HTTP Header插件。
    • Debugging: 网络打印，内置插件。
    • GZip: 网络数据解压缩插件。
    • Shared: 网络共享插件。
    • Files: 网络下载文件和上传资源插件。
    • Token: Token验证插件。
    • Ignore: 忽略插件，目的是在此网络请求中忽略一个插件。
    • Authentication: 拦截器插件。
    • Cache: 网络数据缓存插件。
    • CustomCache: 自定义网络数据缓存插件。
    • Lottie：基于lottie的动画加载插件。

适用于iOS平台

如果您想使用令牌插件和授权插件，可以参考项目用例。

🎷 简单易用，在API协议中实现协议方法，然后将插件添加到其中

var plugins: APIPlugins {
    let cache = NetworkCachePlugin.init(options: .cacheThenNetwork)
    let loading = NetworkLoadingPlugin.init(options: .init(delay: 0.5))
    let warning = NetworkWarningPlugin.init()
    let shared = NetworkSharedPlugin.init()
    let gzip = NetworkGZipPlugin.init()
    return [loading, cache, warning, shared, gzip]
}

RxSwift

本模块主要支持响应式数据绑定。

func request(_ count: Int) -> Observable<[CacheModel]> {
    CacheAPI.cache(count).request()
        .mapHandyJSON(HandyDataModel<[CacheModel]>.self)
        .compactMap { $0.data }
        .observe(on: MainScheduler.instance)
        .catchAndReturn([])
}

HandyJSON

本模块基于HandyJSON包进行网络数据解析。

  • 大致分为以下3个部分
    • HandyDataModel：网络外层数据模型。
    • HandyJSONError：解析错误相关。
    • RxHandyJSON：HandyJSON数据解析，目前提供两种解析方案。
      • 方案1：将HandyDataModel模型结合以解析数据。
      • 方案2：根据keyPath解析指定键的数据，前提是json数据源必须为字典形式。

🎷 与网络部分结合使用的示例

func request(_ count: Int) -> Driver<[CacheModel]> {
    CacheAPI.cache(count).request()
        .asObservable()
        .mapHandyJSON(HandyDataModel<[CacheModel]>.self)
        .compactMap { $0.data }
        .observe(on: MainScheduler.instance)
        .delay(.seconds(1), scheduler: MainScheduler.instance)
        .asDriver(onErrorJustReturn: [])
}

HollowCodable

本模块用于数据的序列化和反序列化，取代HandyJSON。

🎷 与网络部分结合使用的示例

func request(_ count: Int) -> Observable<[CodableModel]> {
    CodableAPI.cache(count)
        .request(callbackQueue: DispatchQueue(label: "request.codable"))
        .deserialized(ApiResponse<[CodableModel]>.self, mapping: CodableModel.self)
        .compactMap({ $0.data })
        .observe(on: MainScheduler.instance)
        .catchAndReturn([])
}

CocoaPods

CocoaPods是一个依赖管理器。有关使用和安装说明，请访问他们的网站。要使用CocoaPods集成，请在Podfile中指定它

pod 'Booming'

您应明确定义您的最低部署目标，例如

platform :ios, '11.0'

如果您想导入缓存插件

pod 'NetworkCachePlugin'

如果您想使用Codable

pod 'HollowCodable'

如果您需要响应式网络

pod 'RxNetworks/RxSwift'

其他排除的插件和模块，请阅读podspec文件。

备注

一般过程几乎是这样的，Demo也写得非常详细，您可以去自己看看。🎷

BoomingDemo

提示：如果觉得有用，请帮我点个星。如果您有任何问题或需求，也可以提出。

谢谢。🎇

关于作者

在GitHub上为我点杯咖啡或支持我。

yellow-button

支付宝或微信。谢谢。

许可协议

Booming可在MIT许可下使用。有关更多信息，请参阅LICENSE文件。