Moya最新版本11.0.2

由于前段時(shí)間寫(xiě)了這篇文章雏婶，最新Moya已更新最新版本过椎，故此也更新了下用法，本人已使用荸频，故特意奉上最新的使用demo供參考菱肖。
Moya11.0.2Demo

Moya簡(jiǎn)介

Moya 是你的 app 中缺失的網(wǎng)絡(luò)層。不用再去想在哪兒（或者如何）安放網(wǎng)絡(luò)請(qǐng)求旭从，Moya 替你管理稳强。

Moya有幾個(gè)比較好的特性:

• 編譯時(shí)檢查正確的API端點(diǎn)訪問(wèn).

• 使你定義不同端點(diǎn)枚舉值對(duì)應(yīng)相應(yīng)的用途更加明晰.

• 提高測(cè)試地位從而使單元測(cè)試更加容易.

Swift我們用Alamofire來(lái)做網(wǎng)絡(luò)庫(kù).而Moya在Alamofire的基礎(chǔ)上又封裝了一層,如下流程圖說(shuō)明Moya的簡(jiǎn)單工作流程圖:

簡(jiǎn)單流程圖

** Moya**的官方下載地址點(diǎn)我強(qiáng)大的Moya,有具體的使用方法在demo里面有說(shuō)明。

本文主要介紹一下Moya的用法

• 設(shè)置請(qǐng)求頭部信息
• 設(shè)置超時(shí)時(shí)間
• 自定義插件
• 自簽名證書(shū)

注意：以下所出現(xiàn)的NetAPIManager跟官網(wǎng)上demo的** GitHub**是一樣類型的文件和悦，都是這個(gè)enum實(shí)現(xiàn)一個(gè)協(xié)議TargetType退疫，點(diǎn)進(jìn)去可以看到TargetType定義了我們發(fā)送一個(gè)網(wǎng)絡(luò)請(qǐng)求所需要的東西，什么baseURL鸽素，parameter褒繁，method等一些計(jì)算性屬性，我們要做的就是去實(shí)現(xiàn)這些東西馍忽，當(dāng)然有帶默認(rèn)值的我們可以不去實(shí)現(xiàn)棒坏，但是設(shè)置頭部信息跟超時(shí)時(shí)間就要修改這些系統(tǒng)默認(rèn)設(shè)置了燕差。

為了看得更加清楚，貼上NetAPIManager文件的內(nèi)容

//
//  NetAPIManager.swift
//  NN110
//
//  Created by 陳亦海 on 2017/5/12.
//  Copyright ? 2017年 陳亦海. All rights reserved.
//

import Foundation
import Moya


enum NetAPIManager {
    case Show
    case upload(bodyData: Data)
    case download
    case request(isTouch: Bool, body: Dictionary<String, Any>? ,isShow: Bool)
}


extension NetAPIManager: TargetType {
    var baseURL: URL {//服務(wù)器地址
        
        switch self {
        case .request( _, _, _):
            return URL(string: "https://www.pmphmall.com")!
        default:
            return URL(string: "https://httpbin.org")!
        }
        
        
    }
    
    var path: String {//具體某個(gè)方法的路徑
        switch self {
        case .Show:
            return ""
        case .upload(_):
            return ""
        case .request(_, _, _):
            return "/app/json.do"
        case .download:
            return ""
        }
    }
    
    var method: Moya.Method {//請(qǐng)求的方法 get或者post之類的
        switch self {
        case .Show:
            return .get
        case .request(_, _, _):
            return .post
        default:
            return .post
        }
    }
    
    var parameters: [String: Any]? {//請(qǐng)求的get post給服務(wù)器的參數(shù)
        switch self {
        case .Show:
            return nil
        case .request(_, _, _):
            return ["msg":"H4sIAAAAAAAAA11SSZJFIQi7EqPAEgTvf6TP62W7sMoSQhKSWDrs6ZUKVWogLwYV7RjHFBZJlNlzloN6LVqID4a+puxqRdUKVNLwE1TRcZIC/fjF2rPotuXmb84r1gMXbiASZIZbhQdKEewJlz41znDkujCHuQU3dU7G4/PmVRnwArMLXukBv0J23XVahNO3VX35wlgce6TLUzzgPQJFuHngAczl6VhaNXpmRLxJBlMml6gdLWiXxTdO7I+iEyC7XuTirCQXOk4dotgArgkH/InxVjfNTnE/uY46++hyAiLFuFL4cv1Z8WH5DgB2GnvFXMh5gm53Tr13vqqrEYtcdXfkNsMwKB+9sAQ77grNJmquFWOhfXA/DELlMB0KKFtHOc/ronj1ml+Z7qas82L3VWiCVQ+HEitjTVzoFw8RisFN/jJxBY4awvq427McXqnyrfCsl7oeEU6wYgW9yJtj1lOkx0ELL5Fw4z071NaVzRA9ebxWXkFyothgbB445cpRmTC+//F73r1kOyQ3lTpec12XNDR00nnq5/YmJItW3+w1z27lSOLqgVctrxG4xdL9WVPdkH1tkiZ/pUKBGhADAAA="]
        default:
            return nil
        
        }
    }
    
    var sampleData: Data { //編碼轉(zhuǎn)義
       return "{}".data(using: String.Encoding.utf8)!
    }
    
    var task: Task { //一個(gè)請(qǐng)求任務(wù)事件
        
        switch self {

        
        case let .upload(data):
        return .upload(.multipart([MultipartFormData(provider: .data(data), name: "file", fileName: "gif.gif", mimeType: "image/gif")]))
            
        default:
            return .request

       }

     }
    
    var parameterEncoding: ParameterEncoding {//編碼的格式
        switch self {
        case .request(_, _, _):
            return URLEncoding.default
        default:
            return URLEncoding.default
        }
        
    }
    //以下兩個(gè)參數(shù)是我自己寫(xiě)俊抵，用來(lái)控制網(wǎng)絡(luò)加載的時(shí)候是否允許操作谁不，跟是否要顯示加載提示坐梯，這兩個(gè)參數(shù)在自定義插件的時(shí)候會(huì)用到
    var touch: Bool { //是否可以操作
        
        switch self {
        case .request(let isTouch, _, _):
            return isTouch
        default:
            return false
        }
        
    }
    
    var show: Bool { //是否顯示轉(zhuǎn)圈提示
        
        switch self {
        case .request( _, _,let isShow):
            return isShow
        default:
            return false
        }
        
    }
    
    
}

如何設(shè)置Moya請(qǐng)求頭部信息

頭部信息的設(shè)置在開(kāi)發(fā)過(guò)程中很重要徽诲，如服務(wù)器生成的token，用戶唯一標(biāo)識(shí)等
我們直接上代碼吵血，不說(shuō)那么多理論的東西谎替，哈哈

// MARK: - 設(shè)置請(qǐng)求頭部信息
let myEndpointClosure = { (target: NetAPIManager) -> Endpoint<NetAPIManager> in
    
    
    let url = target.baseURL.appendingPathComponent(target.path).absoluteString
    let endpoint = Endpoint<NetAPIManager>(
        url: url,
        sampleResponseClosure: { .networkResponse(200, target.sampleData) },
        method: target.method,
        parameters: target.parameters,
        parameterEncoding: target.parameterEncoding
    )

    //在這里設(shè)置你的HTTP頭部信息
    return endpoint.adding(newHTTPHeaderFields: [
        "Content-Type" : "application/x-www-form-urlencoded",
        "ECP-COOKIE" : ""
        ])
    
}

如何設(shè)置請(qǐng)求超時(shí)時(shí)間

// MARK: - 設(shè)置請(qǐng)求超時(shí)時(shí)間
let requestClosure = { (endpoint: Endpoint<NetAPIManager>, done: @escaping MoyaProvider<NetAPIManager>.RequestResultClosure) in
    
    guard var request = endpoint.urlRequest else { return }
    
    request.timeoutInterval = 30    //設(shè)置請(qǐng)求超時(shí)時(shí)間
    done(.success(request))
}

自定義插件

自定義插件必須PluginType協(xié)議的兩個(gè)方法willSend與didReceive

//
//  MyNetworkActivityPlugin.swift
//  NN110
//
//  Created by 陳亦海 on 2017/5/10.
//  Copyright ? 2017年 CocoaPods. All rights reserved.
//

import Foundation
import Result
import Moya


/// Network activity change notification type.
public enum MyNetworkActivityChangeType {
    case began, ended
}

/// Notify a request's network activity changes (request begins or ends).
public final class MyNetworkActivityPlugin: PluginType {
    
    
    
    public typealias MyNetworkActivityClosure = (_ change: MyNetworkActivityChangeType, _ target: TargetType) -> Void
    let myNetworkActivityClosure: MyNetworkActivityClosure
    
    public init(newNetworkActivityClosure: @escaping MyNetworkActivityClosure) {
        self.myNetworkActivityClosure = newNetworkActivityClosure
    }
    
    // MARK: Plugin
    
    /// Called by the provider as soon as the request is about to start
    public func willSend(_ request: RequestType, target: TargetType) {
        myNetworkActivityClosure(.began,target)
    }
    
    /// Called by the provider as soon as a response arrives, even if the request is cancelled.
    public func didReceive(_ result: Result<Moya.Response, MoyaError>, target: TargetType) {
        myNetworkActivityClosure(.ended,target)
    }
}

使用自定義插件方法

// MARK: - 自定義的網(wǎng)絡(luò)提示請(qǐng)求插件
let myNetworkPlugin = MyNetworkActivityPlugin { (state,target) in
    if state == .began {
        //        SwiftSpinner.show("Connecting...")
        
        let api = target as! NetAPIManager
        if api.show {
            print("我可以在這里寫(xiě)加載提示")
        }
        
        if !api.touch {
            print("我可以在這里寫(xiě)禁止用戶操作，等待請(qǐng)求結(jié)束")
        }

        print("我開(kāi)始請(qǐng)求\(api.touch)")
        
        UIApplication.shared.isNetworkActivityIndicatorVisible = true
    } else {
        //        SwiftSpinner.show("request finish...")
        //        SwiftSpinner.hide()
        print("我結(jié)束請(qǐng)求")
        UIApplication.shared.isNetworkActivityIndicatorVisible = false
        
    }
}

自簽名證書(shū)

在16年的WWDC中蹋辅，Apple已表示將從2017年1月1日起钱贯，所有新提交的App必須強(qiáng)制性應(yīng)用HTTPS協(xié)議來(lái)進(jìn)行網(wǎng)絡(luò)請(qǐng)求。默認(rèn)情況下非HTTPS的網(wǎng)絡(luò)訪問(wèn)是禁止的并且不能再通過(guò)簡(jiǎn)單粗暴的向Info.plist中添加NSAllowsArbitraryLoads
設(shè)置繞過(guò)ATS(App Transport Security)的限制（否則須在應(yīng)用審核時(shí)進(jìn)行說(shuō)明并很可能會(huì)被拒）侦另。所以還未進(jìn)行相應(yīng)配置的公司需要盡快將升級(jí)為HTTPS的事項(xiàng)提上進(jìn)程了秩命。本文將簡(jiǎn)述HTTPS及配置數(shù)字證書(shū)的原理并以配置實(shí)例和出現(xiàn)的問(wèn)題進(jìn)行說(shuō)明，希望能對(duì)你提供幫助褒傅。(比心~)

1. 一種是向權(quán)威認(rèn)證機(jī)構(gòu)購(gòu)買(mǎi)的證書(shū)，服務(wù)端使用該種證書(shū)時(shí)芭梯，因?yàn)樘O(píng)果系統(tǒng)內(nèi)置了其受信任的簽名根證書(shū)险耀，所以客戶端不需額外的配置。為了證書(shū)安全玖喘，在證書(shū)發(fā)布機(jī)構(gòu)公布證書(shū)時(shí)甩牺，證書(shū)的指紋算法都會(huì)加密后再和證書(shū)放到一起公布以防止他人偽造數(shù)字證書(shū)。而證書(shū)機(jī)構(gòu)使用自己的私鑰對(duì)其指紋算法加密累奈，可以用內(nèi)置在操作系統(tǒng)里的機(jī)構(gòu)簽名根證書(shū)來(lái)解密贬派，以此保證證書(shū)的安全。
2. 另一種是自己制作的證書(shū)澎媒，即自簽名證書(shū)搞乏。好處是不需要花錢(qián)購(gòu)2買(mǎi)，但使用這種證書(shū)是不會(huì)受信任的旱幼，所以需要我們?cè)诖a中將該證書(shū)配置為信任證書(shū).

自簽名證書(shū)具體實(shí)現(xiàn):
我們?cè)谑褂米院灻C書(shū)來(lái)實(shí)現(xiàn)HTTPS請(qǐng)求時(shí)查描，因?yàn)椴幌駲C(jī)構(gòu)頒發(fā)的證書(shū)一樣其簽名根證書(shū)在系統(tǒng)中已經(jīng)內(nèi)置了，所以我們需要在App中內(nèi)置自己服務(wù)器的簽名根證書(shū)來(lái)驗(yàn)證數(shù)字證書(shū)柏卤。首先將服務(wù)端生成的.cer格式的根證書(shū)添加到項(xiàng)目中冬三，注意在添加證書(shū)要一定要記得勾選要添加的targets。這里有個(gè)地方要注意：蘋(píng)果的ATS要求服務(wù)端必須支持TLS 1.2或以上版本缘缚；必須使用支持前向保密的密碼勾笆；證書(shū)必須使用SHA-256或者更好的簽名hash算法來(lái)簽名，如果證書(shū)無(wú)效桥滨，則會(huì)導(dǎo)致連接失敗窝爪。由于我在生成的根證書(shū)時(shí)簽名hash算法低于其要求，在配置完請(qǐng)求時(shí)一直報(bào)NSURLErrorServerCertificateUntrusted = -1202錯(cuò)誤齐媒，希望大家可以注意到這一點(diǎn)蒲每。

那么如何在Moya中使用自簽名的證書(shū)來(lái)實(shí)現(xiàn)HTTPS網(wǎng)絡(luò)請(qǐng)求呢，請(qǐng)期待下回我專門(mén)分享......需要自定義一個(gè)Manager管理

綜合使用的方法如下

定義一個(gè)公用的Moya請(qǐng)求服務(wù)對(duì)象

let MyAPIProvider = MoyaProvider<NetAPIManager>(endpointClosure: myEndpointClosure,requestClosure: requestClosure, plugins: [NetworkLoggerPlugin(verbose: true, responseDataFormatter: JSONResponseDataFormatter),myNetworkPlugin])

// MARK: -創(chuàng)建一個(gè)Moya請(qǐng)求
func sendRequest(_ postDict: Dictionary<String, Any>? = nil,
                 success:@escaping (Dictionary<String, Any>)->(),
                 failure:@escaping (MoyaError)->()) -> Cancellable? {
    
   let request = MyAPIProvider.request(.Show) { result in    
        switch result {
        case let .success(moyaResponse):
            
            
            do {
                let any = try moyaResponse.mapJSON()
                let data =  moyaResponse.data
                let statusCode =  moyaResponse.statusCode
                MyLog("\(data) --- \(statusCode) ----- \(any)")
                
                success(["":""])
                

            } catch {
                
            }
            
           
            
        case let .failure(error):
            
            print(error)
            failure(error)
        }
    }
    
    return request
}

取消所有的Moya請(qǐng)求

// MARK: -取消所有請(qǐng)求
func cancelAllRequest() {
//    MyAPIProvider.manager.session.invalidateAndCancel()  //取消所有請(qǐng)求
    MyAPIProvider.manager.session.getTasksWithCompletionHandler { dataTasks, uploadTasks, downloadTasks in
        dataTasks.forEach { $0.cancel() }
        uploadTasks.forEach { $0.cancel() }
        downloadTasks.forEach { $0.cancel() }
    }
    
    //let sessionManager = Alamofire.SessionManager.default
    //sessionManager.session.getTasksWithCompletionHandler { dataTasks, uploadTasks, downloadTasks in
    //    dataTasks.forEach { $0.cancel() }
    //    uploadTasks.forEach { $0.cancel() }
    //    downloadTasks.forEach { $0.cancel() }
    //}

}

完畢喻括，待續(xù)更高級(jí)的用法...