SplatNet2のライブラリを更新している

SplatNet2 ライブラリ

Swift で簡単に API を叩けるライブラリ、のつもりで作成したのだがあまりにもゴミコードだったので泣いています。

まあ簡単にいえば iksm_session をとってきたり更新したり、サーモンラン用のリザルトをとってきたりとできるコードだったのですがあまりに酷いので書き直すことにしました。

iOS13 以降には Combine という面白い仕組みがあるのでこれを利用すればクロージャの数を減らしつつ良いコードが書けそうな気がします。

Salmonia3 は以下の参考記事を利用させていただいて Realm にデータを書き込む際に Codable を使って一気に変換しているのですが、よく考えたら API のレスポンスをライブラリが上手く整形してやればこんな処理は不要なわけです。

【Swift4】Realm+Codable を使ったお手軽な DB Part.1（モデル編）

つまり、何らかのクラスや構造体を返してしまえばいちいちキーなんて使わなくてもメンバ変数を使ってパパっと値をとってこれるわけです。

ライブラリからエラーを起こさずに値が返ってきている時点でちゃんとデータが入っていることは間違いなく、（返り値に対する）バリデーションも不要になります。これはなんか高便利そうですね？

Combine + Alamofire

というわけで、以下の記事を参考に Combine を使ってタスクを渡してそれをクロージャで処理できるライブラリをつくることにしました。

Combine+Alamofire+SwiftUI で API 実行

クロージャを使う仕組みは@escapingを使うのと対して変わらないのですが、API を叩く際のプロトコルを決めておくことで新しいエンドポイントがでたときにも柔軟に対応することができます。

1
protocol APIProtocol {
2
    associatedtype ResponseType: Decodable
3

4
    var method: HTTPMethod { get }
5
    var baseURL: URL { get }
6
    var path: String { get set }
7
    var headers: [String: String[? { get }
8
    var allowConstrainedNetworkAccess: Bool { get }
9
}
10

11
extension APIProtocol {
12
    var baseURL: URL {
13
        return URL(string: "https://app.splatoon2.nintendo.net/api/")!
14
    }
15

16
    var headers: [String: String[? {
17
        return nil
18
    }
19

20
    var allowConstrainedNetworkAccess: Bool {
21
        return true
22
    }
23
}

そして API プロトコルを継承したリクエストプロトコルを作ります

1
protocol RequestProtocol: APIProtocol, URLRequestConvertible {
2
    var parameters: Parameters? { get }
3
    var encoding: JSONEncoding { get }
4
}
5

6
extension RequestProtocol {
7
    var encoding: JSONEncoding {
8
        return JSONEncoding.default
9
    }
10

11
    public func asURLRequest() throws -> URLRequest {
12
        var request = URLRequest(url: baseURL.appendingPathComponent(path))
13
        request.httpMethod = method.rawValue
14
        request.allHTTPHeaderFields = headers
15
        request.timeoutInterval = TimeInterval(5)
16
        request.allowsConstrainedNetworkAccess = allowConstrainedNetworkAccess
17

18
        if let params = parameters {
19
            request = try encoding.encode(request, with: params)
20
        }
21

22
        return request
23
    }
24
}

ここでは Alamofire の構造体が良かったのでそのまま利用したとのこと。なのでimport Alamofireを忘れないようにしましょう。

参考記事では URLEncoding を採用していますが、SplatNet2 はほぼすべてのリクエストで JSONEncoding しかつかわないので問題ないでしょう。唯一の例外が s2s API なのですがそれはそれでまた別の話。

なので Encoding として型は JSONEncoding ではなくて Encoding のようなものを持ちたかったのですが、それがなかったので少し別の方法を考えなくてはいけません。

asURLRequest()で URLRequest を作成してそれを Alamofire で実行するという仕組みです。

1
import Foundation
2
import Combine
3
import Alamofire
4
import SwiftyJSON
5

6
struct NetworkPublisher {
7

8
    private static let contentType = ["application/json"[
9
    private static let retryCount = 1
10
    static let decoder: JSONDecoder()
11

12
    static func publish<T: RequestProtocol, V: Decodable>(_ request: T) -> Future<V.ResponseType, APIError> {
13

14
        return Future { promise in
15
            let alamofire = AF.request(request)
16
                .validate(statusCode: 200...300)
17
                .validate(contentType: contentType)
18
                .cURLDescription { request in
19
                    print(request)
20
                }
21
                .responseJSON { response in
22
                    switch response.result {
23
                    case .success(let value):
24
                        do {
25
                            let json = try JSON(value).rawData()
26
                            let data = try decoder.decode(V.self, from: json)
27
                            print(data)
28
                            promise(.success(data))
29
                        } catch(let error) {
30
                            print(error)
31
                            promise(.failure(APIError.invalid))
32
                        }
33
                    case .failure(let error):
34
                        print(error)
35
                        promise(.failure(APIError.failure))
36
                    }
37
                }
38
            alamofire.resume()
39
        }
40
    }
41
}
42

43
public enum APIError: Error {
44
    case failure
45
    case invalid
46
    case requests
47
    case unavailable
48
    case upgrade
49
    case unknown
50
    case badrequests
51
}

今回は意味もなく（おい）SwiftyJSON を導入しているので JSONDecoder のところの記述が少し異なります。

まあ多分気にしなくても大丈夫。

進捗情報

とりあえずリザルトの ID をを指定すれば取得できるようにはなりました。

SplatNet2 のバグなのかは知らないのですが、イベントなしの WAVE のキーが water-levels とかいう謎な値になっています。まあひょっとしたら-と返すのがダサくてそうしたのかもしれません。

Wave も Event も Enum でそれぞれ値があるのですが、このまま文字列で返したほうがいいのかどうかは考えどころですね。

いまは Swift 風に LCC で変数名を設定していて、ネストも SplatNet2 準拠なのですが時刻のデータなどは普通にネストに入れてしまってもいいような気がします（startTime、endTime、playTime）の三つが並んでいるのが若干違和感。

で、ここまで書いておいてステージ ID が取れていないことに気付いたのですが、今日中に頑張って直したいと思います。