Swift URLSession HTTP 통신 - 1

🌐

URLSession : HTTP 통신하기

연관된 네트워크 데이터 전송 태스크들의 그룹을 조정하는 객체

 

개요

URLSession 및 관련 클래스들은 URL이 가리키는 엔드포인트로 데이터를 다운로드하거나 업로드하기 위한 API를 제공한다. URLSession은 앱이 실행중이지 않거나 앱이 일시정지 상태일때에도 백그라운드로 다운로드를 수행할 수 있도록 해준다.

URL Session의 종류

하나의 URL session에 속한 task들은 같은 session configuration 객체를 공유한다. 이 객체는 호스트당 생성 가능한 동시 접속갯수나 cellular 네트워크를 허용할 것인지와 같은 접속 동작을 정의한다.

1. shared기본적인 요청에 적합한 싱글톤 세션으로 자유롭게 커스터마이징할 수는 없지만 아주 제한적인 용도로만 사용한다면 편리하게 사용이 가능하다.

2. default sessionshared session과 상당히 비슷하게 동작하지만 더 많은 설정이 가능하며 delegate를 통해서 데이터를 점진적으로 받아오는 것이 가능

3. Ephemeral sessionshared session과 비슷하지만 캐시나 쿠키, 자격증명을 디스크에 기록하지 않는다.

4. Background session앱이 실행중이지 않을 때도 백그라운드에서 컨텐츠를 업로드하거나 다운로드할 수 있게 해준다.

 

URL Session Task의 종류

세션 내에서 데이터를 선택적으로 업로드하거나 서버로부터 데이터를 불러오는 Task를 생성할 수 있다. 데이터는 파일 형태가 될 수도 있고, 메모리 상의 NSData 객체 형태일 수도 있다.

1. Data taskNSData 객체를 사용해서 데이터를 전송하고 받는다. Data task는 짧고, 잦은 요청을 서버와 주고 받는 경우에 사용하도록 만들어졌다.

2. Upload taskdata Task와 비슷하지만 (주로 파일 형태로) 데이터를 보낼 수 있다. 또한 앱이 실행중이지 않을 때에도 백그라운드 업로드를 지원한다.

3. Download task파일의 형태로 데이터를 불러온다. 또한 앱이 실행중이지 않을 때 백그라운드 다운로드와 업로드를 지원한다.

Session Delegate 사용

한 세션 안에 있는 task들은 공통 delegate를 공유한다. delegate는 다양한 이벤트(인증 실패, 서버로부터 데이터 도착했을 때, 데이터가 캐시할 준비가 되었을 때 등등)가 발생했을때 정보를 제공하거나 받을 수 있게 해준다.

💡

Session 객체는 앱이 종료되거나 해당 session을 명시적으로 무효화하기 전까지 delegate에 대한 강한 참조를 유지한다. 만약 session을 무효화하지 않으면 앱이 종료되지 전까지 메모리 누수가 발생한다.

비동기성과 URL session

대부분의 네트워킹 API들과 마찬가지로 URLSession API는 비동기적이다. 이 API는 호출되는 메서드에 따라 두가지 방식으로 데이터를 반환한다.

• 전송이 성공적으로 끝났거나 에러가 발생한 경우 completion handler 블록을 호출

• 데이터가 수신되고 전송이 완료된 후에 delegate가 메서드를 호출

URLSession API는 Delegate를 통해서 정보들을 전달하는 것 외에도 status와 progress 프로퍼티를 제공함으로써 task의 현재 상태에 기반하여 프로그래밍적인 방식의 결정을 내리는데 도움을 준다.

URL Session은 또한 task의 취소, 재시작, 일시정지 및 재개를 지원하며 취소, 일시정지, 실패한 다운로드는 해당 지점부터 재개하도록 할 수 있다.

 

shared 세션 사용하기

• class var shared: URLSession 공유 싱글톤 세션 객체

세션 생성하기

• init(configuration: URLSessionConfiguration) 특정 session configuration으로 세션을 생성합니다.

• init(configuration: URLSessionConfiguration, delegate: URLSessionDelegate?, delegateQueue: OperationQeueu?) 특정 session configuration과 delegate, delegateQueue로 세션을 생성합니다.

• class URLSessionConfiguration URL session의 동작과 정책을 정의하는 configuration 객체

• var configuration: URLSessionConfiguration session configuration 객체의 복사본

Delegate로 작업하기

• var delegate: URLSessionDelegate? delegate는 이 객체가 만들어질 때 할당됩니다.

• protocol URLSessionDelegate URL session 인스턴스가 (세션 수명주기 변경 같은) 세션 수준의 이벤트를 처리하기 위해서 호출하는 메서드를 정의하는 프로토콜

• protocol URLSessionTaskDelegate URL session 인스턴스가 task 수준의 이벤트를 처리하기 위해서 호출하는 메서드를 정의하는 프로토콜

• var delegateQueue: OperationQueue 이 operation queue는 객체가 생성될 때 제공됩니다.

Data Task를 세션에 추가하기

• func dataTask(with: URL) -> URLSessionDataTask 특정 URL의 컨텐츠를 불러오는 task를 생성합니다.

• func dataTask(with: URL, completionHandler: (Data?, URLResponse?, Error?) -> Void) -> URLSessionDataTask 특정 URL의 컨텐츠를 불러와서 파일로 저장하고, 완료 후에 handler를 호출하는 download task를 생성합니다.

• func downloadTask(with: URLRequest) -> URLSessionDownloadTask 특정 URLRequest 객체를 기반으로 URL의 컨텐츠를 불러와서 파일에 저장하는 download task를 생성합니다.

• func downloadTask(with: URLRequest, completionHandler: (URL?, URLResponse?, Error?) -> Void) -> URLSessionDownloadTask 특정 URLRequest 객체를 기반으로 컨텐츠를 불러와서 파일로 저장하고, 완료 후에 handler를 호출하는 download task를 생성합니다.

• func downloadTask(withResumeData: Data) -> URLSessionDownloadTask 이전에 최소되었거나 실패한 다운로드를 재개하는 download task를 생성합니다.

• func downloadTask(withResumeData: Data, completionHandler: (URL?, URLResponse?, Error?) -> Void) -> URLSessionDownloadTask 이전에 최소되었거나 실패한 다운로드를 재개하고 완료 후에 handler를 호출하는 download task를 생성합니다.

• class URLSessionDownloadTask 다운로드된 데이터를 파일로 저장하는 URL session task

• protocol URLSessionDownloadDelegate A protocol defining methods that URL session instances call on their delegates to handle task-level events specific to data and upload tasks.

세션 관리

• func finishTasksAndInvalidate() 세션을 무효화하고 완료되지 않은 task를 완료시킵니다.

• func flush(completionHandler: () -> Void) Flushes cookies and credentials to disk, clears transient caches, and ensures that future requests occur on a new TCP connection.

• func getTasksWithCompletionHandler(([URLSessionDataTask], [URLSessionUploadTask], [URLSessionDownloadTask]) -> Void) 세션 내 모든 data, upload, download task들의 completion 콜백을 비동기 호출합니다.

• func getAllTasks(completionHandler: ([URLSessionTask]) -> Void) 세션 내 모든 task들의 completion 콜백을 비동기 호출합니다.

• func invalidateAndCancel() 모든 완료되지 않은 task들을 취소하고 세션을 무효화시킵니다.

• func reset(completionHandler: () -> Void) 모든 쿠키와 캐시, 자격증명 저장소를 비우고, 디스크 파일을 지우며, 진행중인 다운로드를 디스크로 옮겨서 향후에 요청이 새 소켓에서 발생할 수 있도록 합니다.

• var sessionDescription: String? 세션에 대해서 앱이 정의한 설명 레이블

에러 처리

• NSURLSessioin-Specific NSError userInfo Dictionary Keys NSURLSession API에서 반환한 NSError 객체와 함께 사용되는 키.

• Background Task Cancellation 백그라운드 task가 취소된 이유를 설명하는 상수

실습

---

 

🚥HTTP 통신 구현