URLSession API 호출 정리

URLSession tutorial .md

IOS URLSession API 호출 정리

출처 [link]https://github.com/timojaask/URLSession-Cheat-Sheet/blob/master/README.md

Simple GET request

URLSession.shared.dataTask(with: url) { (data, response, error) in
    guard let statusCode = (response as? HTTPURLResponse)?.statusCode else {
        // request failed
        return
    }
    // handle status code
}.resume()

Query parameters

var urlComponents = URLComponents(string: "https://www.google.com")!
urlComponents.queryItems = [
    URLQueryItem(name: "foo1", value: "bar"),
    URLQueryItem(name: "foo2", value: "baz")
]
let url = urlComponents.url // https://www.google.com?foo1=bar&foo2=baz

Extension example

extension URL {
    init?(baseUrl: String, queryItems: [String: String]) {
        guard var urlComponents = URLComponents(string: baseUrl) else { return nil }
        urlComponents.queryItems = queryItems.map { URLQueryItem(name: $0.key, value: $0.value) }
        guard let finalUrlString = urlComponents.url?.absoluteString else { return nil }
        self.init(string: finalUrlString)
    }
}

Method, body and headers

var request = URLRequest(url: url)
request.httpMethod = "POST"
request.httpBody = data
request.addValue("application/json", forHTTPHeaderField: "Content-Type")
request.addValue("*/*", forHTTPHeaderField: "Accept")

Extension example

extension URLRequest {
    static func request(url: URL, headers: [String: String] = [:], method: String = "GET", data: Data? = nil) -> URLRequest {
        var request = URLRequest(url: url)
        request.httpMethod = method
        request.httpBody = data
        headers.forEach { header in
            request.addValue(header.value, forHTTPHeaderField: header.key)
        }
        return request
    }
}

JSON

From Dictionary to JSON object - 중요⭐️ 보통 POST 방식 json을 요청데이터로 넣을때 사용 httpBody

guard let data = try? JSONSerialization.data(withJSONObject: dictionary, options: [.prettyPrinted]) else {
    // JSON serialization failed
    return
}

URLSession Cheatsheet 2번째

출처 [link]https://github.com/alexpaul/iOS-UIKit/blob/main/URLSession-Cheatsheet.md

Vocabulary

• JSON
• endpoint
• RESTFul API
• URLSession
• URLSession.shared
• JSONDecoder(중요), JSONEncoder
• URL - simple
• URLRequest - URL에 플러스로 추가 세팅이 되어 있는것
• URLResponse - 응답
• HTTPURLResponse
• Status Code - HTTP 상태 코드 200번 대가 OK(서버 환경마다 다름)
• Data
• Codable - 인코더블이랑 디코더블이 합쳐진 타입에일리어스
• Encodable - Class 나 Struct Json 객체로 만드는 것
• Decodable - Json을 Class 나 Struct로 만드는것
• HTTP methods: GET, POST, PUT, DELETE, PATCH, UPDATE
• Asynchronous - 비동기처리 방식 Closure, Rx Observable, Combine Publisher, Async await
• Result - 응답 성공 데이터랑 에러가 같이 있는 제네릭 Enum Class Result<성공데이터, 커스텀에러데이터>
• @escaping closures
• capture list e.g [weak self], [unowned self]
• weak vs unowned

Using a closure to capture the Result of the asynchronous network request

Result type is an enum type that has two arguments, a success state and an failure state.

func fetchWebData(completion: @escaping (Result<[ModelObject], Error>) -> ()) {
 // netowrking code here
}

Perform a GET request using URLSession

URLSession.shared is a singleton instance on URLSession with basic networking configurations.

let dataTask = URLSession.shared.dataTask(with: url) { (data, response, error) in
  // networking code here
}
dataTask.resume()

Check that the HTTPURLResponse status code is within the valid range of 200...299 indicating a successful response

guard let httpResponse = response as? HTTPURLResponse,
      (200...299).contains(httpResponse.statusCode) else {
  print("bad status code")
  return
}

Converting JSON data to Swift objects - 와꾸 맞추는 작업⭐️

do {
  // 데이터 파싱
  let topLevelModel = try JSONDecoder().decode(TopLevelModel.self, from: jsonData)
  let modelObjects = topLevelModel.modelObjects
  completion(.success(modelObjects)
} catch {
  // decoding error : JSON -> Class, Struct 변경이 실패되었을때
  completion(.failure(error))
}

Using the Codable protocol to parse JSON to Swift model(s)

struct CovidCountriesWrapper: Codable {
  let countries: [CountrySummary]
  
  // CodingKeys allows us to rename properties
  enum CodingKeys: String, CodingKey {
    case countries = "Countries"
  }
}

struct CountrySummary: Codable {
  let country: String
  let totalConfirmed: Int
  let totalRecovered: Int
  
  enum CodingKeys: String, CodingKey {
    case country = "Country"
    case totalConfirmed = "TotalConfirmed"
    case totalRecovered = "TotalRecovered"
  }
}

The CodingKeys built-in enum type allows us to change JSON property names to our own custom names

In this example we change Countries to a more Swift naming conventional name countries.

struct CovidCountriesWrapper: Codable {
  let countries: [CountrySummary]
  
  // CodingKeys allows us to rename properties
  enum CodingKeys: String, CodingKey {
    case countries = "Countries"
  }
}

Completed API Client to fetch web data

 func fetchWebData(completion: @escaping (Result<[ModelObject], Error>) -> ()) {
    // 1. - endpoint URL string
    let endpointURLString = "https://........"
    
    // 2. - convert the string to an URL
    guard let url = URL(string: endpointURLString) else {
      print("bad url")
      return
    }
    
    // URL vs URLRequest
    
    // 3. - make the request using URLSession
    // .shared is an singleton instance on URLSession comes with basic configuration needed for most requests
    let dataTask = URLSession.shared.dataTask(with: url) { (data, response, error) in
      if let error = error {
        return completion(.failure(error))
      }
      
      // first we have to type cast URLResponse to HTTPURLRepsonse to get access to the status code
      // we verify the that status code is in the 200 range which signals all went well with the GET request
      guard let httpResponse = response as? HTTPURLResponse,
            (200...299).contains(httpResponse.statusCode) else {
        print("bad status code")
        return
      }
      
      if let jsonData = data {
        // convert data to our swift model
        do {
          let topLevelModel = try JSONDecoder().decode(TopLevelModel.self, from: jsonData)
          let modelObjects = topLevelModel.modelObjects
          completion(.success(modelObjects))
        } catch {
          // decoding error
          completion(.failure(error))
        }
      }
    }
    dataTask.resume()
  }