[swift] Swift Moya에서 커스텀 네트워크 레이어 구현하기

28 Nov 2023

swift

Moya는 Swift에서 네트워크 작업을 쉽게 처리하기 위한 라이브러리입니다. 하지만 때로는 Moya 자체적으로 제공하는 네트워크 레이어 만으로는 요구사항을 충족시키지 못할 수도 있습니다. 그래서 이번 블로그 포스트에서는 Moya에서 커스텀 네트워크 레이어를 구현하는 방법을 알아보도록 하겠습니다.

Moya 커스텀 네트워크 레이어란?

Moya의 기본적인 네트워크 레이어는 Provider와 Target으로 구성됩니다. Provider는 실제로 네트워크 작업을 수행하고, Target은 API의 엔드포인트와 관련된 정보를 제공합니다. 하지만 때로는 이 기본 구성으로는 네트워크 작업을 충분히 커스터마이징할 수 없는 경우가 있습니다. 이럴 때에는 커스텀 네트워크 레이어를 구현하여 원하는 동작을 수행할 수 있습니다.

커스텀 네트워크 레이어 구현하기

Moya에서 커스텀 네트워크 레이어를 구현하려면 다음 단계를 따라야 합니다.

Moya의 TargetType을 구현하는 새로운 클래스를 생성합니다. 이 클래스에서 원하는 네트워크 동작을 정의할 수 있습니다.
생성한 클래스에 커스텀 동작을 추가합니다. 예를 들어, 인증 토큰을 header에 추가해야한다면, headers 프로퍼티를 구현하여 이를 처리할 수 있습니다.
커스텀 TargetType을 사용하여 Moya의 Provider를 생성합니다.
생성한 Provider를 사용하여 네트워크 작업을 호출합니다.

이렇게 하면 기본적인 Moya 네트워킹을 보다 세부적으로 커스터마이징할 수 있습니다.

예시 코드

import Moya

// 커스텀 TargetType
enum CustomAPI {
    case getUser(id: Int)
}

extension CustomAPI: TargetType {
    var baseURL: URL {
        return URL(string: "https://api.example.com")!
    }
    
    var path: String {
        switch self {
        case .getUser(let id):
            return "/user/\(id)"
        }
    }
    
    var method: Moya.Method {
        return .get
    }
    
    var task: Task {
        return .requestPlain
    }
    
    var headers: [String: String]? {
        return ["Authorization": "Bearer YOUR_AUTH_TOKEN"]
    }
}

// 커스텀 Provider 생성
let customProvider = MoyaProvider<CustomAPI>()

위의 예시 코드에서는 CustomAPI라는 커스텀 TargetType을 정의하고, 사용자 정보를 요청하는 API를 구현했습니다. 또한, headers 프로퍼티를 통해 요청 시 인증 토큰을 header에 추가할 수 있도록 했습니다.

이제 customProvider를 사용하여 네트워크 작업을 호출할 수 있습니다.

결론

이번 블로그 포스트에서는 Moya에서 커스텀 네트워크 레이어를 구현하는 방법을 알아봤습니다. Moya를 사용하여 네트워킹 작업을 보다 세부적으로 커스터마이징할 수 있게 되었습니다. 커스텀 네트워크 레이어를 사용하면 복잡한 네트워크 요구사항을 쉽게 처리할 수 있습니다.

참고: Moya GitHub Repository