[URLSession] completion(nil) 대신 Result 타입 사용해보기

Result 타입은 성공과 실패 두 가지 가능한 결과를 나타내기 위해 사용된다.

Result 타입은 열거형으로, 성공 시에는 값을 반환하고 실패 시에는 오류를 반환한다.

 

enum Result<Success, Failure> where Failure : Error {
    case success(Success)
    case failure(Failure)
}

Success(연관값): 작업이 성공했을 때 반환되는 값의 타입.

Failure(연관값): 작업이 실패했을 때 반환되는 오류의 타입. Failure는 반드시 Error 프로토콜을 준수해야 한다.

 

 

 

그렇다면 Result 타입은 왜 쓰는건데?

• 명확한 오류 처리: Result 타입을 사용하면 성공과 실패를 명확하게 구분할 수 있다.
• 가독성 향상: 코드의 가독성이 향상되고, 오류 처리 로직이 간결해진다.
• 타입 안전성: Result 타입은 제네릭을 사용하므로, 성공과 실패에 대한 타입을 명확하게 지정할 수 있다.

 

 

Result 타입의 사용 예제

기존의 completion 클로저를 Result 타입으로 변환하여 사용해보기 

 

1. 기존 completion 클로저

기존의 completion 클로저는 ([Movie]?) -> Void 형태로 정의되었다. 

func fetchMovies(completion: @escaping ([Movie]?) -> Void) {
    // 네트워크 요청 및 응답 처리 로직
}

 

 

 

2. Result 타입을 사용하는 completion 클로저

// NetworkError 정의
enum NetworkError: Error {
    case invalidURL
    case noData
}

func fetchMovies(completion: @escaping (Result<[Movie], Error>) -> Void) {
    
    guard let url = URL(string: "https://api.example.com/movies") else {
        completion(.failure(NetworkError.invalidURL)) // 유효하지 않은 URL 오류 전달
        return
    }

    let task = URLSession.shared.dataTask(with: url) { data, response, error in
        if let error = error {
            completion(.failure(error)) // 네트워크 오류 전달
            return
        }
        
        guard let data = data else {
            completion(.failure(NetworkError.noData)) // 데이터가 없는 경우 오류 전달
            return
        }
        
        // JSON 디코딩
        do {
            let decoder = JSONDecoder()
            let result = try decoder.decode(MovieResponse.self, from: data)
            completion(.success(result.results)) // 성공적으로 디코딩된 영화 목록 전달
        } catch let jsonError {
            completion(.failure(jsonError)) // JSON 디코딩 오류 전달
        }
    }
    
    task.resume()
}

 

✅ completion(.failure(NetworkError.invalidURL))와 같이 .failure로 접근할 수 있는 이유?

Result 타입이 열거형(enum)으로 정의되어 있기 때문이다.

열거형 이름의 타입인 Result 생략 가능.

 

  

 

✅ completion(.success(result.results))에서 results는 result 객체의 속성!

struct MovieResponse: Decodable {
    let results: [Movie]
}

MovieResponse는 API 응답 데이터를 나타내는 구조체다.

 

MovieResponse 구조체는 results라는 속성을 가지고 있고, 이는 영화 목록을 나타낸다.

fetchMovies 함수 내에서 JSON 데이터를 디코딩할 때, MovieResponse 객체가 생성된다.

 

 

 

 

 

3. 뷰 컨트롤러에서 fetchMovies 사용하기

fetchMovies 함수를 뷰 컨트롤러에서 호출하고, 네트워크 요청을 통해 데이터를 받아와

테이블 뷰를 업데이트할 때 아래와 같이 사용할 수 있다.

import UIKit

class MoviesViewController: UIViewController, UITableViewDataSource {
    @IBOutlet weak var tableView: UITableView!
    
    var movies: [Movie] = []
    
    override func viewDidLoad() {
        super.viewDidLoad()
        tableView.dataSource = self
        
        // fetchMovies 함수 호출
        fetchMovies { result in
            DispatchQueue.main.async {
                switch result {
                case .success(let movies):
                    self.movies = movies
                    self.tableView.reloadData() // 테이블 뷰 업데이트
                case .failure(let error):
                    // 오류 처리
                     switch error {
       				 case NetworkError.invalidURL:
         			     print("Invalid URL error occurred.")
      				 case NetworkError.noData:
        			     print("No data returned from the server.")
    				 default:
            		     print("An error occurred: \(error.localizedDescription)")
                     }
                }
            }
        }
    }
    
    // UITableViewDataSource 메서드 구현
    func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
        return movies.count
    }

    func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
        let cell = tableView.dequeueReusableCell(withIdentifier: "MovieCell", for: indexPath)
        let movie = movies[indexPath.row]
        cell.textLabel?.text = movie.title
        return cell
    }
    
    // 오류 알림 표시 메서드
    private func showAlert(for error: Error) {
        let alert = UIAlertController(title: "Error", message: error.localizedDescription, preferredStyle: .alert)
        alert.addAction(UIAlertAction(title: "OK", style: .default))
        present(alert, animated: true)
    }
}

completion 클로저의 인자로 result가 전된다. result는 Result<[Movie], Error> 타입이다.

switch result를 통해 result의 성공(.success)과 실패(.failure)를 구분한다.