Swift中的网络请求库Alamofire,相当于OC中的AFNetworking,在使用的过程中,我们一般都会对Alamofire做进一步的封装,可是结果大多不太理想。
所以就引出了今天的主角Moya,它是一个网络抽象层,封装的比较充分,并且是直接调用Alamofire,借用一下Moya的图如下。
Moya
下面就来说一下Moya的基本使用方法。
1、创建网络层.swift文件
这里我创建了一个WHService.swift文件
创建swift.文件
2、定义网络请求接口
实际上是定义一个枚举,枚举值就是每个网络请求API。
1
2
3
4
5
6
|
// 定义请求方法
enum WHService {
case
demo1
case
demo2(name:
String
)
case
demo3(name:
String
, score: Int)
}
|
3、扩展遵守协议,并实现协议方法
这一步我们创建一个扩展,并遵守TargetType协议,这个协议中有6个方法需要实现,具体意义看下面代码中的注释
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
|
extension WHService: TargetType {
// 请求服务器的根路径
var
baseURL: URL {
return
URL.init(string:
"https://httpbin.org"
)! }
// 每个API对应的具体路径
var
path:
String
{
switch
self {
case
.demo1:
return
"/get"
case
.demo2(name: _), .demo3(name: _, score: _):
return
"/post"
}
}
// 各个接口的请求方式,get或post
var
method: Moya.Method {
switch
self {
case
.demo1:
return
.
get
case
.demo2, .demo3:
return
.post
}
}
// 请求是否携带参数,如果需要参数,就做如demo2和demo3的设置
var
task: Task {
switch
self {
case
.demo1:
return
.requestPlain
// 无参数
case
let .demo2(name):
// 带有参数,注意前面的let
return
.requestParameters(parameters: [
"name"
: name], encoding: URLEncoding.
default
)
case
let .demo3(name, score):
// 带有参数,注意前面的let
return
.requestParameters(parameters: [
"name"
: name,
"score"
: score], encoding: URLEncoding.
default
)
}
}
// 单元测试使用
var
sampleData: Data {
switch
self {
case
.demo1, .demo3:
return
"just for test"
.utf8Encoded
case
.demo2(let name):
return
"{\"name\": \(name)\"}"
.utf8Encoded
}
}
// 请求头
var
headers: [
String
:
String
]? {
return
[
"Content-type"
:
"application/json"
]
}
}
|
4. 实现网络请求(推荐第5步的做法,可以忽略本条,直接查看第5步)
如下代码所示,首先创建一个MoyaProvider,并跟上,
然后直接调用request方法请求数据。
注意:request方法的参数就是上面定义的方法枚举,由此调用不同的API。达到了把网络请求封装到了WHService.swift中的需求。
1
2
3
4
5
6
7
8
9
10
11
12
|
let provider = MoyaProvider()
provider.request(.demo1) { (result)
in
switch
result {
case
let .success(moyaResponse):
let data = moyaResponse.data
// 获取到的数据
let statusCode = moyaResponse.statusCode
// 请求状态: 200, 401, 500, etc
case
let .failure(error):
print(error.localizedDescription)
}
}
|
5. 创建Network结构体实现网路请求
在WHService.swift中创建一个WHNetwork结构体,用单例创建MoyaProvider。
这样的好处是,可以在任何需要的地方通过WHNetwork调用任意API。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
|
// 网络请求结构体
struct WHNetwork {
// 请求成功的回调
typealias successCallback = (_ result: Any) -> Void
// 请求失败的回调
typealias failureCallback = (_ error: MoyaError) -> Void
// 单例
static
let provider = MoyaProvider()
// 发送网络请求
static
func request(
target: WHService,
success: @escaping successCallback,
failure: @escaping failureCallback
) {
provider.request(target) { result
in
switch
result {
case
let .success(moyaResponse):
do
{
try
success(moyaResponse.mapJSON())
// 测试用JSON数据
}
catch
{
failure(MoyaError.jsonMapping(moyaResponse))
}
case
let .failure(error):
failure(error)
}
}
}
}
|
完成了WHService.swift中的工作之后,现在我们在ViewController.swift中进行网络访问,来看一下效果。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
|
override
func viewDidLoad() {
super
.viewDidLoad()
WHNetwork.request(target: .demo1, success: { (result)
in
whLog(result)
}) { (error)
in
whLog(error.localizedDescription)
}
WHNetwork.request(target: .demo2(name:
"wuhao"
), success: { (result)
in
whLog(result)
}) { (error)
in
whLog(error.localizedDescription)
}
WHNetwork.request(target: .demo3(name:
"wuhao"
, score:
100
), success: { (result)
in
whLog(result)
}) { (error)
in
whLog(error.localizedDescription)
}
|
显然比较简洁,并且用闭包的方式获取到需要的数据。