SwiftにてURLSessionの結果がエラーの場合、例外をスローするなどして呼び出し元で処理を行いたい。

Question

前提

SwiftでiOSアプリを作成しています。
この中で、URLSession を使用してAPIアクセスしているのですが、
エラーハンドリングについて質問になります。

Swift, iOSについて初心者で、調べ調べなんとかかんとかやっており、
Swiftではそんなやり方しない、というようなお作法などにも疎いため、
的はずれなことをやろうとしているかもしれません。

実現したいこと

APIアクセスの結果が、エラーあるいはレスポンスのステータスコードが成功以外の時、
例外をスローして外側でエラー時の処理をしたい。

発生している問題・エラーメッセージ

該当のソースコードに埋め込んだコメントここを throw にしたいの部分をthrowにすると、
Invalid conversion from throwing function of type '(Data?, URLResponse?, Error?) throws -> Void' to non-throwing function type '(Data?, URLResponse?, Error?) -> Void'
のエラーになる。

URLSession.shared.dataTaskのcompletionHandler が例外スローできるものではないので当然ではあるのですが...。

他の言語などで、APIリクエストする場合、HTTPステータスコードに合わせて、適当な例外をスローして、
呼び出し元で処理するということはあると思っておりまして。

該当のソースコード

func postApi() -> Void {
  guard let url = URL("hogegApiUrl") else {return}

  var request = URLRequest(url)
  request.httpMethod = "POST"
  request.setValue("Application/json", "Content-Type")

  URLSession.shared.dataTask(request) {(data, response, error) in 
    if let error = error {
      print("APIアクセス時にエラーが発生しました。: error={\(error)}")
      return // ここを throw error などにして、関数の呼び出し元で処理したい。
    }

    if let response = response as? HTTPURLResponse {
      if !(200...299).contains(response.statusCode) {
        print("レスポンスのステータスコードが成功以外でした。: response={\(response)}")
        return // ここも throw NSError() などにして、関数の呼び出し元で処理したい。
      }

      // リクエスト成功時の処理
      略

    }
  }.resume()

}

Comments

[hoshi-takanori]

async/await を使うとか。
https://qiita.com/satoru_pripara/items/90e78673ac8057b490f5

[usukuti_hanako]

ご助言ありがとうございます。

リンク先の内容をあまり理解できず、別の方法で自己解決となりました。

Answer 1

例外をスローするのではなく、呼び出し元から処理用のハンドラーを受け取る形で、
呼び出し元で行いたい処理を実行する形にしました。

func postApi(errorHandler: ((_ err: Error) -> Void)? , responseHandler: ((_ response: HTTPURLResponse) -> Void)? ) -> Void {
  // 引数として、エラー、レスポンスに対するコールバックハンドラを受け取るようにしました。

  guard let url = URL("hogegApiUrl") else {return}

  var request = URLRequest(url)
  request.httpMethod = "POST"
  request.setValue("Application/json", "Content-Type")

  URLSession.shared.dataTask(request) {(data, response, error) in 
    if let error = error {
      print("APIアクセス時にエラーが発生しました。: error={\(error)}")
      errorHandler(error)
      return
    }

    if let response = response as? HTTPURLResponse {
      if !(200...299).contains(response.statusCode) {
        print("レスポンスのステータスコードが成功以外でした。: response={\(response)}")
        responseHandler(response)
        return
      }

      // リクエスト成功時の処理
      略

    }
  }.resume()

}

// 呼び出し元

let hoge = Hoge()

hoge.postApi(errorHandler: errorHandler, responseHandler: responseHandler)

private func errorHandler(err: Error) -> Void {
  // エラー時にやりたい処理
  print("とりあえずログで出しておく。error={\(err)}")
}

private func responseHandler(res: HTTPURLResponse) -> Void {
  // レスポンスが成功以外の時にやりたい処理
  print("とりあえずログで出しておく。response={\(res)}")
}