Moya es una biblioteca de código abierto escrita en Swift que proporciona una capa de abstracción sobre las operaciones de red. Esta herramienta permite simplificar considerablemente la interacción con servicios HTTP, eliminando la necesidad de manipular directamente detalles de bajo nivel como configuraciones de sesiones, manejo de codificadores y decodificadores, o construcción manual de solicitudes.

La biblioteca está diseñada para integrarse perfectamente con el ecosistema Apple, soportando tanto iOS como macOS, y ofrece compatibilidad nativa con extensiones reactivas como RxSwift y ReactiveSwift para aquellos desarrolladores que prefieren paradigmas de programación reactiva.

Instalación mediante Swift Package Manager

Para incorporar Moya en tu proyecto, necesitas modificar el archivo Package.swift añadiendo la dependencia correspondiente. Se recomiennda utilizar la versión 15.0.0 o superior para garantizar compatibilidad con las versiones recientes de Swift.

dependencies: [
    .package(url: "https://github.com/Moya/Moya.git", from: "15.0.0")
]

Configuración de objetivos

Después de añadir la dependencia, asegúrate de incluir el producto apropiado en los objetivos de tu proyecto que requieran funcionalidad de red.

El patrón fundamental en Moya consiste en definir un enum que conforme al protocolo TargetType. Este enum representa los diferentes endpoints de tu API y encapsula toda la información necesaria para realizar las solicitudes.

import Moya

enum ServicioGitHub {
    case obtenerPerfil(usuario: String)
    case listarRepositorios(usuario: String)
    case obtenerGists(usuario: String)
}

extension ServicioGitHub: TargetType {
    var baseURL: URL {
        return URL(string: "https://api.github.com")!
    }
    
    var path: String {
        switch self {
        case .obtenerPerfil(let usuario):
            return "/users/\(usuario)"
        case .listarRepositorios(let usuario):
            return "/users/\(usuario)/repos"
        case .obtenerGists(let usuario):
            return "/users/\(usuario)/gists"
        }
    }
    
    var method: Moya.Method {
        return .get
    }
    
    var sampleData: Data {
        return Data()
    }
    
    var task: Task {
        return .requestPlain
    }
    
    var headers: [String: String]? {
        return ["Content-Type": "application/json"]
    }
}

Una vez configurado el proveedor, puedes realizar solicitudes HTTP de manera simplificada. El proveedor se encarga de gestionar la construcción de la solicitud, la serialización de respuestas y el manejo de errores.

import Foundation

class GestorSolicitudes {
    private let proveedor: MoyaProvider<ServicioGitHub>
    
    init() {
        self.proveedor = MoyaProvider<ServicioGitHub>()
    }
    
    func consultarPerfil(usuario: String, completion: @escaping (Result<Any, Error>) -> Void) {
        proveedor.request(.obtenerPerfil(usuario: usuario)) { resultado in
            switch resultado {
            case .success(let respuesta):
                do {
                    let json = try respuesta.mapJSON()
                    completion(.success(json))
                } catch {
                    completion(.failure(error))
                }
            case .failure(let error):
                completion(.failure(error))
            }
        }
    }
}

// Uso del gestor
let gestor = GestorSolicitudes()
gestor.consultarPerfil(usuario: "octocat") { resultado in
    switch resultado {
    case .success(let datos):
        print("Datos recibidos: \(datos)")
    case .failure(let error):
        print("Error en la solicitud: \(error.localizedDescription)")
    }
}

Separación de Responsabilidades

Es fundamental mantener la lógica de red aislada del resto de la aplicación. Se recomienda crear capas intermedias que traduzcan las respuestas crudas de la API en modelos de dominio que la aplicación pueda utilizar directamente.

Manejo de Errores

Implementa un sistema robusto de gestión de errores que diferencei entre fallos de red, errores de servidor y problemas de parseo. Esto permite mostrar mensajes significativos al usuario y tomar acciones correctivas apropiadas.

Estrategia de Almacenamiento en Caché

Para optimizar el rendimiento y reducir el consumo de datos, implementa políticas de caché utilizando bibliotecas como Cache o similares. Configura tiempos de expiración apropiados según la naturaleza de los datos solicitados.

RxMoya

Esta extensión permite utilizar Moya con RxSwift, habilitando el uso de operadores reactivos para transformar, encadenar y observar las respuestas de red de manera declarativa.

ReactiveMoya

Para proyectos que utilizan ReactiveSwift en lugar de RxSwift, esta extensión proporciona funcionalidad equivalente permitiendo la integración con el modelo de programación reactiva de Swift.