Шаблоны сценария использования и репозитория
Определяйте сценарии использования как протоколы Swift и реализуйте интерфейсы репозиториев.
«Шаблоны сценария использования и репозитория» — бесплатный урок Swift Academy на CoddyKit. Это урок 2 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения Swift Academy, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс Swift Academy содержит 4 уроков всего.
Что такое вариант использования?
Вариант использования (интерактор) инкапсулирует одно бизнес-действие, координируя сущности предметной области и репозитории.
struct PlaceOrderUseCase {
let cart: CartRepository
let payment: PaymentService
let orders: OrderRepository
func execute(userId: Int) async throws -> Order {
let items = try await cart.items(for: userId)
let receipt = try await payment.charge(items: items)
return try await orders.create(receipt: receipt)
}
}Единственная ответственность
Каждый вариант использования выполняет ровно одну задачу. Несколько обязанностей означают, что нужны несколько вариантов использования.
// One use case per business action:
struct FetchUserUseCase { ... }
struct UpdateUserUseCase { ... }
struct DeleteUserUseCase { ... }Вариант использования как протокол
Определите протокол для варианта использования, чтобы его можно было заменить имитацией в тестах слоя представления.
protocol PlacingOrder {
func execute(userId: Int) async throws -> Order
}
struct PlaceOrderUseCase: PlacingOrder { ... }Что такое репозиторий?
Репозиторий абстрагирует источник данных. Вызывающий код взаимодействует с протоколом Swift, а реализацией может быть сеть, Core Data или хранилище в памяти.
protocol OrderRepository {
func create(receipt: PaymentReceipt) async throws -> Order
func list(userId: Int) async throws -> [Order]
func cancel(orderId: Int) async throws
}Реализация репозитория
Конкретный репозиторий преобразует вызовы предметной области в сетевые операции или операции с базой данных.
struct RemoteOrderRepository: OrderRepository {
func create(receipt: PaymentReceipt) async throws -> Order {
let dto = receipt.toDTO()
let data = try await api.post("/orders", body: dto)
return try JSONDecoder().decode(OrderDTO.self, from: data).toDomain()
}
func list(userId: Int) async throws -> [Order] { ... }
func cancel(orderId: Int) async throws { ... }
}Репозиторий в памяти для тестов
Предоставьте репозиторий в памяти для быстрых и детерминированных тестов без операций ввода-вывода.
final class InMemoryOrderRepo: OrderRepository {
var orders: [Order] = []
func create(receipt: PaymentReceipt) async throws -> Order {
let order = Order(id: orders.count + 1, items: receipt.items)
orders.append(order)
return order
}
func list(userId: Int) async throws -> [Order] { orders }
func cancel(orderId: Int) async throws { orders.removeAll { $0.id == orderId } }
}Составление вариантов использования
Варианты использования могут вызывать другие варианты использования для общих подопераций, сохраняя узкую направленность каждого из них.
struct CheckoutUseCase {
let validateCart: ValidateCartUseCase
let placeOrder: PlaceOrderUseCase
let notifyUser: NotifyUserUseCase
func execute(userId: Int) async throws -> Order {
try await validateCart.execute(userId: userId)
let order = try await placeOrder.execute(userId: userId)
try await notifyUser.execute(order: order)
return order
}
}Репозиторий и сервис
Репозиторий: операции создания, чтения, обновления и удаления для одного типа сущности. Сервис: координация нескольких сущностей или вызовов внешних API без прямого доступа к хранилищу.
// Repository: single entity
protocol UserRepository { func getUser(id: Int) async throws -> User }
// Service: cross-entity operation
protocol AuthService { func login(email: String, password: String) async throws -> Session }Кэширование в репозиториях
Репозитории могут прозрачно кэшировать результаты, не раскрывая варианту использования детали реализации.
struct CachedUserRepository: UserRepository {
private var cache: [Int: User] = [:]
private let remote: UserRepository
func getUser(id: Int) async throws -> User {
if let cached = cache[id] { return cached }
let user = try await remote.getUser(id: id)
cache[id] = user
return user
}
func saveUser(_ user: User) async throws { try await remote.saveUser(user) }
}Тестируемость
Поскольку варианты использования зависят от репозиториев-протоколов, вы можете внедрять заглушки и тестировать бизнес-логику изолированно.
let repo = InMemoryOrderRepo()
let sut = PlaceOrderUseCase(orders: repo, ...)
let order = try await sut.execute(userId: 1)
XCTAssertEqual(repo.orders.count, 1)Преобразование ошибок
Репозитории должны преобразовывать ошибки слоя данных (сетевые ошибки и ошибки базы данных) в ошибки предметной области перед возвратом результата.
func getUser(id: Int) async throws -> User {
do {
let data = try await api.get("/users/\(id)")
return try decode(data)
} catch let e as URLError where e.code == .notConnectedToInternet {
throw DomainError.offline
}
}Быстрая проверка
В чём заключается ключевое различие между репозиторием и сервисом в чистой архитектуре?
Итоги урока
Варианты использования инкапсулируют отдельные бизнес-действия и зависят от протоколов репозиториев. Репозитории абстрагируют источники данных за протоколом. Используйте репозитории в памяти для быстрых тестов. Репозитории преобразуют ошибки инфраструктуры в ошибки предметной области. Сервисы координируют операции с несколькими сущностями.
Часто задаваемые вопросы
Урок «Шаблоны сценария использования и репозитория» бесплатный?
Да — полный текст урока «Шаблоны сценария использования и репозитория» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс Swift Academy, подпишись на CoddyKit PRO. Курс Swift Academy содержит 4 уроков всего.
Чему я научусь в уроке «Шаблоны сценария использования и репозитория»?
Определяйте сценарии использования как протоколы Swift и реализуйте интерфейсы репозиториев. Ты практикуешь Swift Academy с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.
Нужен ли мне опыт, чтобы начать Swift Academy?
Предыдущий опыт не требуется. Swift Academy на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 2 из 4.
Сколько времени занимает урок «Шаблоны сценария использования и репозитория»?
Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.
Можно ли писать и запускать код в этом уроке Swift Academy?
Да. Каждый урок Swift Academy включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.
Все уроки этого курса
- Слои: предметная область, данные и представление
- Шаблоны сценария использования и репозитория
- Инверсия зависимостей с абстракциями протоколов
- Связывание слоёв без фреймворка DI