[swift] Swift Moya에서 이미지 다운로드 기능 구현하기

28 Nov 2023

swift

Moya는 Swift에서 사용하는 네트워크 라이브러리로, 간편한 API 호출을 할 수 있도록 도와줍니다. 이번에는 Moya를 사용하여 이미지 다운로드 기능을 구현하는 방법에 대해 알아보겠습니다.

1. Moya 설치

Moya를 사용하기 위해서는 먼저 프로젝트에 Moya를 설치해야 합니다. CocoaPods를 사용하는 경우, Podfile에 다음과 같이 Moya를 추가합니다.

pod 'Moya'

설치 후, Terminal에서 pod install 명령어를 실행하여 Moya를 다운로드합니다.

2. ImageDownloader 구현

이미지를 다운로드하기 위해, Moya의 Provider를 사용하는 ImageDownloader 클래스를 구현합니다. 다음과 같이 ImageDownloader.swift 파일을 생성합니다.

import Foundation
import Moya

class ImageDownloader {
    let provider = MoyaProvider<API>()
    
    func downloadImage(from url: URL, completion: @escaping (Result<Data, Error>) -> Void) {
        provider.request(.downloadImage(url: url)) { result in
            switch result {
            case .success(let response):
                completion(.success(response.data))
            case .failure(let error):
                completion(.failure(error))
            }
        }
    }
}

위의 코드에서, downloadImage 메서드는 Moya의 request 메서드를 사용하여 이미지를 다운로드하는 기능을 구현합니다.

MoyaProvider<API>의 제네릭 타입에는 API 요청을 정의하는 enum 타입이 들어갑니다. 따라서, 다음과 같이 API.swift 파일을 생성하여 API 요청을 정의합니다.

import Foundation
import Moya

enum API {
    case downloadImage(url: URL)
}

extension API: TargetType {
    var baseURL: URL {
        return URL(string: "http://www.example.com")!
    }
    
    var path: String {
        switch self {
        case .downloadImage:
            return "/image"
        }
    }
    
    var method: Moya.Method {
        return .get
    }
    
    var task: Task {
        switch self {
        case .downloadImage(let url):
            return .requestParameters(parameters: ["url": url], encoding: URLEncoding.default)
        }
    }
    
    var headers: [String : String]? {
        return nil
    }
    
    var sampleData: Data {
        // 이미지 다운로드 시 사용할 더미 데이터를 리턴합니다.
        return Data()
    }
}

위의 코드에서, API enum은 downloadImage 케이스 하나를 가집니다. TargetType 프로토콜을 따르도록 구현하여 각 API 요청에 대한 baseURL, path, method, task 등을 정의합니다.

3. 이미지 다운로드하기

이제 다운로드할 이미지의 URL을 생성하고, ImageDownloader를 사용하여 이미지를 다운로드하는 방법에 대해 알아보겠습니다.

let imageURL = URL(string: "http://www.example.com/image.jpg")!
let imageDownloader = ImageDownloader()

imageDownloader.downloadImage(from: imageURL) { result in
    switch result {
    case .success(let imageData):
        let image = UIImage(data: imageData)
        
        // 다운로드한 이미지를 사용하여 UI를 업데이트합니다.
        DispatchQueue.main.async {
            imageView.image = image
        }
        
    case .failure(let error):
        print("Error downloading image: \(error)")
    }
}

위의 코드에서, imageURL은 다운로드할 이미지의 URL을 가리킵니다. ImageDownloader 객체를 생성한 후, downloadImage 메서드에 imageURL을 전달하여 이미지를 다운로드합니다.

다운로드가 성공하면 imageData를 사용하여 UIImage 객체를 생성하고, 이를 이용해 UI를 업데이트합니다. 만약 다운로드 중에 에러가 발생하면, 해당 에러를 출력합니다.

이제 Moya를 사용하여 Swift에서 이미지 다운로드 기능을 구현하는 방법에 대해 알아보았습니다. Moya의 간편한 API 호출과 Error handling 기능을 적절히 활용하여 네트워크 기능을 구현할 수 있습니다.

참고 자료

Moya GitHub Repository