[ URLSession ] 포켓몬 API로 서버에서 이미지 데이터 받아오는 흐름 찾기

1. URLSession으로 요청(request) - 포켓몬 API에서 링크 찾기

https://pokeapi.co/

 

 

 

2. 서버에서 내려준 데이터 분석 - JSON 형태  

 

 

 

3. URLSession 기본 사용법

1. URL 생성 및 검증
URL(string:) 메서드를 사용해 URL 객체를 생성하고 유효성을 검증한다.

guard let url = URL(string: "https://example.com/api") else {
    print("Invalid URL")
    return
}

 

2. URLRequest 객체 생성 (옵션)

기본 GET 요청은 URL 객체로 바로 생성할 수 있지만, HTTP 메서드 변경이나 헤더 설정이 필요하다면 URLRequest 객체를 생성한다.

 

var request = URLRequest(url: url)
request.httpMethod = "GET" // 기본값은 GET, 필요에 따라 변경 가능
request.addValue("application/json", forHTTPHeaderField: "Content-Type")

 

 

3. URLSession 객체 생성
애플이 제공하는 기본 세션 생성, 일반적인 요청은 URLSession.shared(Singleton Session)을 사용하고 

필요에 따라 생성자를 통한 커스텀 설정을 사용해 URLSessionConfiguration 객체를 생성할 수 있다.

// 기본 설정 -> 커스텀 불가, 응답은 클로저 형태로 전달, 백그라운드 형태 처리 불가
let session = URLSession.shared 

// 커스텀 설정
let session = URLSession(configuration: .default)

// default : shared와 유사하나 커스텀 가능, 응답은 클로저 또는 Delegate 형태로 전달
// ephemeral : 정보를 휘발시키고 싶을 때
// background : 앱을 쓰고 있지 않을 때 어떤 처리를 하고 싶을 때 사용 (ex. 백그라운드 재생)

 

 

4. Data Task 생성 및 시작 : 네트워크 요청은 비동기적으로 처리되므로 클로저를 사용해 응답을 처리한다. 

dataTask(with:  completionHandler:) 메서드를 사용하여 네트워크 요청을 수행하고, 데이터를 처리

 

네트워킹을 하는 코드들은 비동기 처리를 해야하는 이유는 CPU에 부하를 일으키는 작업으로

메인 스레드에서 실행 시키면 앱이 버벅 거릴 수 있다. 

 

그래서 .resume()이 실행된 다음에 .shared.dataTask 코드들이 실행된다. 

 

백그라운드 스레드에서 동작하기 때문에 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()

코드 출처 : https://taekki-dev.tistory.com/115

 

 

 

🌟 클로저 (data, response, error) in

• data: 서버에서 응답으로 받은 데이터. 성공적인 요청의 경우, 이 데이터는 서버가 반환한 내용이 된다.
• response: 서버의 응답 메타데이터. HTTP 상태 코드와 헤더 정보가 포함된다.
•  error: 요청 중 발생한 오류가 있으면 이 변수에 오류 정보가 담긴다.

let task = session.dataTask(with: request) { data, response, error in
    // 에러 처리
    if let error = error {
        print("Error: \(error.localizedDescription)")
        return
    }
    
    // 응답 상태 코드 확인
    if let httpResponse = response as? HTTPURLResponse {
        print("Status code: \(httpResponse.statusCode)")
        guard (200...299).contains(httpResponse.statusCode) else {
            print("Request failed with status code: \(httpResponse.statusCode)")
            return
        }
    }
    
    // 데이터 확인
    guard let data = data else {
        print("No data received")
        return
    }
    
    // 데이터 처리 (예: JSON 디코딩)
    // JSON 파싱 : 서버에서 받은 JSON 데이터를 JSONDecoder를 사용하여 Swift 구조체로 디코딩(변환)
    do {
        let json = try JSONSerialization.jsonObject(with: data, options: [])
        print("JSON response: \(json)")
    } catch {
        print("JSON decoding error: \(error.localizedDescription)")
    }
}

// 태스크 시작
task.resume()

 

 

 

📌 JSON 파싱

서버가 JSON 형식의 데이터를 응답으로 보내줄 때 이를 Swfit의 데이터 구졸 변환하는 과정

 

---

템플릿 코드

전체 코드 - NetworkManager 

class ImageRepository {
    func fetchRandomPokemonImage(completion: @escaping (UIImage?) -> Void) {
        let randomId = Int.random(in: 1...1000)
        let urlString = "https://pokeapi.co/api/v2/pokemon/\(randomId)"
        
        guard let url = URL(string: urlString) else {
            completion(nil)
            return
        }
        
        let task = URLSession.shared.dataTask(with: url) { data, response, error in
            // 데이터가 존재하고, 에러가 없는지 확인
            guard let data = data, error == nil,
                  // JSON 데이터를 파싱하여 딕셔너리로 변환
                  let json = try? JSONSerialization.jsonObject(with: data, options: []) as? [String: Any],
                  // JSON에서 'sprites' 딕셔너리를 가져옴
                  let sprites = json["sprites"] as? [String: Any],
                  // 'sprites' 딕셔너리에서 'front_default' URL 문자열을 가져옴
                  let imageUrlString = sprites["front_default"] as? String,
                  // URL 문자열을 URL 객체로 변환
                  let imageUrl = URL(string: imageUrlString) else {
                // 실패한 경우 completion 핸들러 호출
                completion(nil)
                return
            }
            
            // 성공한 경우 이미지 다운로드 메서드 호출
            self.downloadImage(from: imageUrl, completion: completion)
        }
        task.resume()
        
    }
    
    private func downloadImage(from url: URL, completion: @escaping (UIImage?) -> Void) {
        DispatchQueue.global().async {
            if let imageData = try? Data(contentsOf: url),
               let image = UIImage(data: imageData) {
                DispatchQueue.main.async {
                    completion(image)
                }
            } else {
                DispatchQueue.main.async {
                    completion(nil)
                }
            }
        }
    }
}

 

 

 

GET 요청

import Foundation

func performGetRequest(urlString: String, completion: @escaping (Data?, URLResponse?, Error?) -> Void) {
    // 1. URL 생성
    guard let url = URL(string: urlString) else {
        print("Invalid URL")
        return
    }

    // 2. URLSession 생성 (공유 인스턴스 사용)
    let session = URLSession.shared

    // 3. Data Task 생성 및 시작
    let task = session.dataTask(with: url) { data, response, error in
        // 4. 응답 처리
        completion(data, response, error)
    }

    task.resume() // 요청 시작
}

// 사용 예제
let url = "https://api.example.com/data"
performGetRequest(urlString: url) { data, response, error in
    if let error = error {
        print("Error: \(error.localizedDescription)")
        return
    }
    guard let data = data else {
        print("No data received")
        return
    }
    // 데이터 처리 (예: JSON 파싱)
    print(String(data: data, encoding: .utf8)!)
}

 

 

 

 

 

POST요청

import Foundation

func performPostRequest(urlString: String, parameters: [String: Any], completion: @escaping (Data?, URLResponse?, Error?) -> Void) {
    // 1. URL 생성
    guard let url = URL(string: urlString) else {
        print("Invalid URL")
        return
    }

    // 2. URLRequest 객체 생성 및 설정
    var request = URLRequest(url: url)
    request.httpMethod = "POST"
    request.addValue("application/json", forHTTPHeaderField: "Content-Type")

    do {
        // 3. 요청 바디 설정
        request.httpBody = try JSONSerialization.data(withJSONObject: parameters, options: [])
    } catch let error {
        print("Error serializing JSON: \(error.localizedDescription)")
        return
    }

    // 4. URLSession 생성 (공유 인스턴스 사용)
    let session = URLSession.shared

    // 5. Data Task 생성 및 시작
    let task = session.dataTask(with: request) { data, response, error in
        // 6. 응답 처리
        completion(data, response, error)
    }

    task.resume() // 요청 시작
}

// 사용 예제
let url = "https://api.example.com/submit"
let parameters = ["key1": "value1", "key2": "value2"]
performPostRequest(urlString: url, parameters: parameters) { data, response, error in
    if let error = error {
        print("Error: \(error.localizedDescription)")
        return
    }
    guard let data = data else {
        print("No data received")
        return
    }
    // 데이터 처리 (예: JSON 파싱)
    print(String(data: data, encoding: .utf8)!)
}