SwiftWorkers

Используйте протокольно-ориентированный подход для создания различной функциональности для вашего iOS/macOS-приложения, включая разработку слоя работы с REST и (в будущем) gRPC, файлами, базами данных и т.д.

В центре библиотеки стоит понятие "Работника" (Воркер, Worker), который предназначен для выполнения определенной задачи, например осуществления запроса к удаленному серверу. Все, что вам нужно - определить новый тип (нового работника), подписав его на необходимые протоколы. Вся базавоя функциональность определена в виде дефолтных реализаций протоколов и не требует от вас ее самостоятельной реализации. Ключевой особенность бибилиотеки является то, что благодаря протокольно-ориентированному подходу Работник всегда обладает только присущей ему функциональностью и данными, что позволяет избегать использования классов-комбайнов.

Это пример простейшего работника, осуществляющего REST-API запрос.

import SwiftWorkers

// Определение типа для нового работника
struct ExampleWorker: RestAPI.Worker {
    var baseUrlPath: String = "https://www.example.com"
    var urlEndpoint: String = "/request"
    var requestMethod: RestAPI.NetworkRequestMethod = .get
}

// Создание работника
let worker = ExampleWorker()
// Осуществление запроса
let worker.makeRequest()

При необходимости вы можете с легкостью расширить работника, наделив его дополнительной функциональностью. Для этого есть два подхода:

1. Переопределить доступные в протоколе свойства. К примеру, вы можете переопределить сессию, используемую для запроса:

// Переопределить свойство можно как в самом типе, так и в его расширении
// Конкретная реализация зависит от ваших требования
extension ExampleWorker {
    var session: URLSession {
        let configuration = URLSessionConfiguration.ephemeral
        return URLSession(configuration: configuration)
    }
}

2. Использовать дополнительные протоколы. К примеру, вы можете с легкостью добавить в тело запроса JSON с параметрами.

// Тип с параметрами, который будет закодирован в тело запроса
struct Options: Encodable {
    var name: String
    var description: String
}

// Использование протоколов доступно как в самом типе, так и в его расширении
// Конкретная реализация зависит от ваших требования
extension ExampleWorker: RestAPI.Request.ParameterEncodable {
    typealias Parameters = Options
    var encodingMethod: RestAPI.Request.EncodingMethod { .asJsonToBody }
}

// Теперь вам доступен новый метод для осуществления запроса
let options = Options(name: "New item", description: "New item description")
let worker.makeRequest(withParameters: options)

SwiftWorkers обладает большим количеством встроенной логики, поставляемой через протоколы.

Общие рекомендации по использованию

В качестве Работника вы можете использовать структуры, классы или акторы. Исходите из

Использование RestAPI