[Swift] URLSession에 대해서 알아보자

안녕하세요~

 

오늘은 URLSession에 대해서 정리하려고 합니다 : )

 

애플 개발자 문서를 참고하시면 좋을 것 같아 링크 남겨드립니다 😃

Apple Developer Documentation

 

---

 

URLSession이란?

URLSession은 네트워크 요청을 처리하는 API입니다.

URLSession은 비동기적으로 작동하며, HTTP, HTTPS 및 FTP 등의 프로토콜을 지원합니다.

 

URLSession은 NSURLSessionConfiguration 객체를 사용하여 세션을 구성하고, 다양한 유형의 작업을 처리하기 위한 URLSessionDataTask, URLSessionDownloadTask 및 URLSessionUploadTask와 같은 작업 클래스를 제공합니다.

 

URLSession은 다음과 같은 특징을 가지고 있습니다.

 

1. 데이터를 다운로드 / 업로드하는 등의 API를 제공해 주는 클래스로서 URL이 가리키는 End Point를 가지고 있습니다.

2. 데이터 전송, 동작 등을 어떻게 처리할지 정책을 설정할 수 있습니다.

3. 전송에서의 기본 정책은 Shared Session이고 이외에도 Session Configure를 이용해 Default, Ephemeral, Background Session을 생성할 수 있습니다.

 

종합해서 설명하면

URL을 통해 데이터를 다운로드 / 업로드를 할 수 있게 도와주는 API로서

네 가지의 Session Configure를 이용해서 정책을 설정할 수 있습니다.

 

URLSession의 종류

첫 번째, Shared Session

• 싱글턴 패턴 구조를 가지고 있으며 단순한 네트워크 요청에 사용합니다.
• 네트워크 응답은 Completion Handler를 이용해 전달받습니다.
• 장점 : 구현이 쉽습니다.
• 단점 : 백그라운드 전송은 지원하지 않습니다. 여기서 백그라운드 전송이라 하면 말 그대로 다른 작업 시에도 지속적으로 데이터를 다운로드 / 업로드할 수 있는 걸 말합니다. 또한 커스터마이징이 불가능합니다.

두 번째, Default Session

• Shared Session과 유사하지만 커스터마이징이 가능합니다.
• Delegate를 이용해 데이터를 점진적으로 받아오는 것이 가능합니다.

 

세 번째, Ephemeral Session

• Shared Session과 비슷하지만 캐시, 쿠키, 인증 정보와 같은 것을 기록하지 않습니다. 크롬의 시크릿 모드와 사파리의 시크릿 모드가 이와 비슷하니다.

 

네 번째, Background Session

• 앞서 말했던 Share Session에서는 불가능했던 백그라운드 기능을 제공하는 Session으로 다른 작업 시 혹은 해당 앱이 종료되더라도 데이터를 다운로드하거나 업로드할 수 있습니다.

 

URL Session Task의 종류

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

 

첫 번째, Data task

• NSData 객체를 사용해서 데이터를 전송하고 받습니다. Data task는 짧고, 잦은 요청을 서버와 주고받는 경우에 사용하도록 만들어졌습니다.
• HTTP / GET 요청을 처리

두 번째, Upload task

• data task와 비슷하지만 데이터를 보낼 수 있습니다. 또한 앱이 실행 중이지 않을 때에도 백그라운드 업로드를 지원하니다.
• HTTP / POST 요청을 처리

세 번째, Download task

• 파일의 형태로 데이터를 불러옵니다. 또한 앱이 실행 중이지 않을 때 백그라운드 다운로드를 지원합니다.
• HTTP / GET 요청을 처리

 

생성된 task를 resume() 메서드를 호출하여 실행할 수 있습니다.

 

URLRequest

URLRequest는 네트워크 요청에 대한 정보를 포함하는 객체입니다.

URLRequest는 NSURLRequest 클래스를 사용하여 생성됩니다.

URLRequest 객체는 요청 URL, HTTP 메서드, 헤더 등의 정보를 포함합니다.

이 정보는 URLSession 객체를 사용하여 요청을 만들 때 전달됩니다.

 

예제를 작성해보겠습니다.

let url = URL(string: "https://fu.com/data")
var request = URLRequest(url: url!)
request.httpMethod = "GET"

 

위 코드에서는 요청 URL을 생성하고, URLRequest를 생성합니다.

이후 HTTP 메서드를 GET으로 설정하여 요청을 만듭니다.

 

URLResponse

URLResponse는 네트워크 응답에 대한 정보를 포함하는 객체입니다.

URLResponse는 NSURLResponse 클래스를 사용하여 생성됩니다.

URLResponse 객체는 응답 상태 코드, 헤더 등의 정보를 포함합니다.

이 정보는 URLSession 객체를 사용하여 요청을 보낼 때 응답을 받을 때 전달됩니다.

 

아래는 HTTP GET 요청에 대한 응답을 받아 URLResponse 객체를 생성하는 예제입니다.

let task = URLSession.shared.dataTask(with: request) { data, response, error in
    guard let httpResponse = response as? HTTPURLResponse,
          (200...299).contains(httpResponse.statusCode) else {
        print("Error: invalid response")
        return
    }
    print("Response status code: \(httpResponse.statusCode)")
}
task.resume()

URLSession 객체를 사용하여 HTTP GET 요청을 보낸 이후 응답이 오면 URLResponse 객체를 생성하여 응답 상태 코드를 확인하는 예제입니다.

 

앞서 설명했던 shared session과 dataTask를 이용하고 있습니다. 앞서 구현했던 request를 사용해 요청할 URL, httpMethod를 네트워크 요청에 추가하고 있습니다.

 

URLSessionDataDelegate

위에 작성했던 예시에서 Completion Handler 형태로 응답을 받은 걸 확인하실 수 있습니다. 이 방법 말고도 URLSessionDataDelegate를 통해서도 응답을 확인할 수 있습니다.

 

URLSessionDataDelegate는 URLSession 객체와 함께 사용되며

URLSessionDataTask 및 URLSessionUploadTask와 함께 작동합니다.

 

이 델리게이트는 데이터를 수신할 때, 데이터를 다운로드할 때, 작업이 완료될 때 및 오류가 발생할 때 호출됩니다.

아래는 URLSessionDataDelegate를 구현하여 데이터를 수신하는 예제입니다.

class ViewController: UIViewController, URLSessionDataDelegate {
    
    override func viewDidLoad() {
    	super.viewDidLoad() 
    	
    }
    
    func getData() {
        let url = URL(string: "https://fu.com/data")
        var request = URLRequest(url: url!)
        request.httpMethod = "GET"
        let session = URLSession(configuration: .default, delegate: self, delegateQueue: nil)
        let task = session.dataTask(with: request)
        task.resume()
    }

    func urlSession(_ session: URLSession, dataTask: URLSessionDataTask, didReceive data: Data) {
        // 데이터를 수신할 때 호출되는 메서드
        print("받은 데이터: \(data)")
    }

    func urlSession(_ session: URLSession, task: URLSessionTask, didCompleteWithError error: Error?) {
        // 작업이 완료될 때 호출되는 메서드
        if let error = error {
            print("Error: \(error.localizedDescription)")
        } else {
            print("성공적으로 데이터를 ㅏㄷ았습니다.")
        }
    }
}

 

URLSession 객체를 생성할 때, delegate 매개변수에 self를 전달하여 이 델리게이트를 사용합니다.

이후 데이터를 수신하면, urlSession(:dataTask:didReceive:) 메서드가 호출됩니다.

작업이 완료되면, urlSession(:task:didCompleteWithError:) 메서드가 호출됩니다.

 

위의 예제에서는 데이터를 수신할 때마다 print문을 사용하고 있지만 실제 애플리케이션에서는 데이터를 저장하거나 UI에 표시하는 등의 작업을 수행하시면 됩니다.

 

---

 

URLSession, URLRequest, URLResponse에 대해서 정리해 봤습니다.

잘못된 점이 있다면 댓글로 남겨주세요 : )

 

그럼 이만 👋🏻 👋🏻 👋🏻