[iOS] URLSession(1) - 기본 흐름

URLSession

아래 3가지를 잘 기억해보자

 

- URLSession

- URLSessionDataTask

- Response, CompletionHandler

 

---

URLSessionDataTask

- 요청을 하는 하나하나(Task)

- 일반 통신, 백그라운드 다운로드, 시크릿 모드 등 목적에 따라 다양한 Task로 종류가 나뉜다.

 

---

URLSessionDelegate

- + å로 무언가를 처리하고 싶을 때 사용한다.

- 중간 중간 데이터를 얼마나 받아왔는지 확인하고 싶을 때 사용한다.

- ex. 카카오톡 사진 10장 한 번에 저장 (다운로드 버튼을 누르면 한 장씩 다운로드 되는 것을 확인할 수 있다.)

- 일반 통신에서는 속도가 굉장히 빠른 편이기 때문에 Delegate까지 사용할 필요가 없다.

 

---

URLSession 사용하기

Session

애플이 제공하는 기본적인 형태 사용, 일반적인 요청 ➡️ shared(Singleton Session) 사용

좀 더 커스터마이즈하게 사용 ➡️ 생성자 사용

 

(1) shared

- 기본 세션

- 단순, 커스텀 불가, 응답은 클로저 형태로 전달, 백그라운드 형태는 처리 불가

 

(2) init(configuration: _)

- default : shared와 유사, 커스텀이 가능하고, 응답을 클로저 또는 Delegate 형태로 할 수 있음

- ephemeral : 정보를 휘발시키고자 할 때 사용

- background : 사용자가 앱을 쓰고 있지 않을 때 어떤 처리를 하고 싶을 때 사용 (ex. 백그라운드 재생)

 

 

---

 

DataTask

- resume 메서드를 반드시 작성해주어야 실행된다.

- 백그라운드 스레드에서 동작하게 된다. 그래서 UI 관련처리를 해주기 위해서는 메인 스레드로 전환해주어야 한다.

- 아예 구현부에서 메인 스레드로 바꿔주는 처리를 해주기도 한다.

let url = URL(string: "")!

URLSession.shared.dataTask(with: url) { data, response, error in

    // 아예 구현부에서 메인 스레드로 바꿔주는 처리를 해주기도 한다.
    DispatchQueue.main.async {
        guard error == nil else {
            completion(nil, .failedRequest)
            return
        }

        guard let data = data else {
            completion(nil, .noData)
            return
        }

        // HTTPURLResponse로 타입 캐스팅
        // URLResponse > HTTPURLResponse는 상속 관계
        guard let response = response as? HTTPURLResponse else {
            completion(nil, .invaildResponse)
            return
        }

        guard response.statusCode == 200 else {
            completion(nil, .failedRequest)
            return
        }

        do {
            let result = try JSONDecoder().decode(Lotto.self, from: data)
            completion(result, nil)

        } catch {
            completion(nil, .invaildData)
        }
    }

}.resume()

Completion의 인자로는 Data와 Error를 넘겨주게 된다. 네트워크 요청이 성공할수도 있고 실패할수도 있기 때문에 각각 옵셔널 타입이 되고 nil값을 전달하게 된다. 각각의 경우에 에러 처리를 하면서 nil값을 넘겨주는 작업이 상당히 귀찮기 때문에 Result라는 타입이 등장하게 되었는데 이 또한 근본적인 해결책이 되지 못해서 에러 처리를 좀 더 쉽게 할 수 있고, 그 흐름이 자연스러운 async, await API를 사용하게 된다.

 

---

사용 흐름

 

직접 네트워크 통신 코드를 viewDidLoad나 controller 단에서 작성해서 사용할 수 있겠지만 일반적으로 네트워크 코드를 메서드로 감싸놓기 때문에 구현부와 호출부를 분리해서 보도록 하겠다.

 

네트워크 매니저 코드 (구현부)

final class PersonAPIManager {
    
    static func requestPerson(query: String, completion: @escaping ((Person?, APIError?) -> Void)) {

        let url = URL(string: "https://api.themoviedb.org/3/search/person?api_key=APIKEY&language=en-US&query=\(query)&page=1&include_adult=false&region=ko-KR")!
        
        URLSession.shared.dataTask(with: component.url!) { data, response, error in
            
            DispatchQueue.main.async {
                guard error == nil else {
                    completion(nil, .failedRequest)
                    return
                }
                
                guard let data = data else {
                    completion(nil, .noData)
                    return
                }

                guard let response = response as? HTTPURLResponse else {
                    completion(nil, .invaildResponse)
                    return
                }
                
                guard response.statusCode == 200 else {
                    completion(nil, .failedRequest)
                    return
                }
                
                do {
                    let result = try JSONDecoder().decode(Person.self, from: data)
                    completion(result, nil)
                    
                } catch {
                    completion(nil, .invaildData)
                }
            }

        }.resume()
        
    }
}

 

호출부

Controller에서 호출

PersonAPIManager.requestPerson(query: "Squid") { person, error in
    guard let person = person else { return }
    self.list = person
    self.tableView.reloadData()
}

 

---

 

정리

URLSession 구조 및 흐름