MVVM-Swift

基于Swift 4.0的MVVM框架
仿照Moya对Alamofire进行更轻量级的封装,网络请求返回实体或者实体数组（双刃剑，缺点在于对于简单数据结构也需要创建相应的实体对象，优点是保持项目结构统一，后续会优化）
基于当下流行的Realm数据库，封装了一套方便开发者，对数据库CRUD操作的数据库工具类
另外通过灵活使用Swift的语言特性，封装了其他更方便的工具类，使开发者的工作更轻松

Tips: 因为项目涉及的功能较多，部分功能测试不够充分，如果有不合理的地方，请多多指教，后续我也将不断完善这个框架，努力打造一套合理、简洁、实用的项目

项目结构

Controllers
ViewModels
Views
Utils
- Extension
  - UIColorExtension
  - NSObjectExtension
  - NotificationCenterExtension
  - UIApplicationExtension
  - NSUserDefaultsExtension
  - UIViewControllerExtension
  - UIStoryboardExtension
  - UIViewExtension
  - StringExtension
  - UIImageExtension
  - FoundationExtension
- Configure
- ThirdPart
- Custom
  - Managers
    - NetworkManager（仿照Moya的轻量级实现）
    - CacheManager (待实现)
    - AppManager
    - ThemeManager
    - DateManager
    - FileManager
    - LocationManager
    - DBManager(基于RealmSwift)
  - UITools
    - CustomProgressHUD
    - WebView(UIWebView&WKWebView)
Resources
- Interface
- Assets.xcassets
- Images
- Documents

架构工作流程

流程图

Utils中部分工具介绍

一、 NetworkManager

Model 中实现方式，遵循RealmSwift的写法

import UIKit
import RealmSwift
class Province: DBModel {
    @objc dynamic var id: Int = 0
    @objc dynamic var firstletter: String = ""
    @objc dynamic var name: String = ""
    /// 设置与Contry的一对多关系
    let owner = LinkingObjects(fromType: Country.self, property: "provinces")
    /// 设置与cities的一对多关系， 保持字段名称与服务端返回一致
    let citys = List<City>()
}

API 中实现如下：

enum UserApi {
    case login
    case Image(count:Int,page:Int)
    case regester
    case xxx
    case download
}
extension UserApi: Request {
    /// 请求返回实体类型
    typealias EntityType = Country
    /// host 如果项目中所有host可以保持一致，直接在Request中设置默认Host，在具体的Api中可省略
    var baseURL: String {
        switch self {
        case .xxx:
            return "http://www.baidu.com"
        default:
            return "http://comm.app.autohome.com.cn"
        }
    }
    /// 具体业务对应的path
    var path: String {
        switch self {
        case .login:
            return "/news/province-pm2-ts0.json"
        case .regester:
            return "/regester"
        case .download:
            return "http://7xoyls.com1.z0.glb.clouddn.com/%E9%99%88%E5%A5%95%E8%BF%85-%E4%B8%80%E4%B8%9D%E4%B8%8D%E6%8C%82%20%28Live%29.mp3"
        default:
            return ""
        }
    }
    /// 参数
    var parameters: [String: Any]? {
        switch self {
        case .Image(let X, let Y):
            return ["x": X, "y": Y]
        default:
            return [:]
        }
    }
}

ViewModel 中实现：

import UIKit
class UserViewModel: BaseViewModel<UserApi> {
    func login(pwd: String?, account: String?, complete: @escaping ((Country)->Void)) {
        provider.request(.login, responseHandler: { response in
            DebugPrint("value = \(String(describing: response.value))")
            DebugPrint("values = \(String(describing: response.values))")
            DebugPrint(response.message)
            if let province = response.value {
                complete(province)
            }
        })
    }
}

二、 NotifcationCenterExtension

通过对NotificationCenter封装后，开发者在定义通知名称的时候，只需要在枚举NotificationName 中添加对应的case就可以了，方便简单

enum NotificationName: String {
    // 用户登录成功
    case loginSuccess
    // 用户退出登录
    case logout
}

调用时代码可以更加简洁了，而且可以和调用系统通知格式保持一致：

    // 调用自定义的通知名称
    NotificationCenter.post(name: .loginSuccess, object: nil, userInfo: nil)
    // 调用系统的通知名称
    NotificationCenter.post(name: .UIKeyboardDidHide, object: nil, userInfo: nil)

PS:项目中所用服务端接口为本地服务,实现方式为Python+Flask+MongoDB，如有需要，请部署项目MVVM-Service