swift ---Moya的设计之道
1.初识
Moya是一个基于Alamofire开发的,轻量级的Swift网络层。Moya的可扩展性非常强,可以方便的RXSwift,PromiseKit和ObjectMapper结合。
path 就是API的地址了
method 请求的方式:get/post
parameters API参数,以Map形式提交
parameterEncoding 参数的格式
task 该条请API求的方式,request、upload、download
sampleData 这个是做单元测试模拟的数据,必须要实现,只在单元测试文件中有作用
extension UApi: TargetType {
/*
path 就是API的地址了
method 请求的方式:get/post
parameters API参数,以Map形式提交
parameterEncoding 参数的格式
task 该条请API求的方式,request、upload、download
sampleData 这个是做单元测试模拟的数据,必须要实现,只在单元测试文件中有作用
*/
private struct UApiKey {
static var key = "fopen"
}
var baseURL: URL { return URL(string: "http://app.u17.com/v3/appV3_3/ios/phone")! }
var path:String{
switchself{
case .searchHot: return "search/hotkeywordsnew"
case .searchRelative: return "search/relative"
case .searchResult: return "search/searchResult"
}
}
varmethod:Moya.Method{return.get}
vartask:Task{
var parmeters = ["time": Int32(Date().timeIntervalSince1970),
"device_id": UIDevice.current.identifierForVendor!.uuidString,
"key":UApiKey.key,
"model":"none",
"target":"U17_3.0",
"version": Bundle.main.infoDictionary!["CFBundleShortVersionString"]!]
switchself{
case.searchRelative(letinputText):
parmeters["inputText"] = inputText
case.searchResult(letargCon,letq):
parmeters["argCon"] = argCon
parmeters["q"] = q
case.boutiqueList(letsexType):
parmeters["sexType"] = sexType
parmeters["v"] =3320101
default: break
} return.requestParameters(parameters: parmeters, encoding:URLEncoding.default)
}
var sampleData:Data{return"".data(using:String.Encoding.utf8)! }
var headers: [String:String]? {returnnil}
}
2.模块
通过功能划分,Moya大致分为几个模块
Request,包括TargetType,Endpoint,Cancellable集中类型
Provider,网络请求的枢纽,Provider会把TargetType转换成Endpoint再转换成URLRequest交给Alamofire去实际执行
Response,回调给上层的数据结构,支持filter,mapJSON等方法
Alamofire封装,通过桥接的方式对上层隐藏alamofire的细节
Plguins,插件。moya提供了插件来给给外部。包括四个方法,这里知道方法就好,后文会具体的讲解插件的方法在何时工作。Plugin提供了一种插件的机制让你可以在网络请求的关键节点插入代码,比如显示小菊花扽等。
Moya提供了四种Plugin:
AccessTokenPlugin OAuth的Token验证
CredentialsPlugin 证书
NetworkActivityPlugin 网络请求状态
NetworkLoggerPlugin 网络日志
3.与HandyJSON结合起来使用
extension Response {
func mapModel(_type:T.Type)throws->T{
let jsonString =String(data:data, encoding: .utf8)
guard letmodel =JSONDeserializer.deserializeFrom(json: jsonString)else{
throw MoyaError.jsonMapping(self)
}
return model
}
}
extension MoyaProvider {
@discardableResult
openfunc request(_target:Target,
model:T.Type,
completion: ((_returnData:T?) ->Void)?) ->Cancellable? {
return request(target, completion: { (result)in
guard let completion = completion else{return}
guard let returnData =try? result.value?.mapModel(ResponseData.self)else{
completion(nil)
return
}
completion(returnData?.data?.returnData)
})
}
}