Swift Academy · 강의

사용 사례와 리포지토리 패턴

사용 사례를 Swift 프로토콜로 정의하고 리포지토리 인터페이스를 구현합니다.

사용 사례와 리포지토리 패턴은(는) CoddyKit의 무료 Swift Academy 강의입니다. 이것은 4개 중 2번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 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 { ... }

리포지토리란 무엇입니까

리포지토리는 데이터 소스를 추상화합니다. 호출자는 스위프트 프로토콜과 상호작용하고, 구현은 네트워크, 코어 데이터 또는 메모리 내 저장소일 수 있습니다.

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 { ... }
}

테스트를 위한 메모리 내 리포지토리

I/O 없이 빠르고 결정적인 테스트를 수행할 수 있도록 메모리 내 리포지토리를 제공하십시오.

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
  }
}

리포지토리와 서비스 비교

리포지토리: 단일 엔터티 유형에 대한 CRUD를 담당합니다. 서비스: 여러 엔터티를 조정하거나 직접 저장하지 않고 외부 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 AI 튜터), CoddyKit PRO로 업그레이드하면 Swift Academy 강의 전체를 잠금 해제할 수 있습니다. Swift Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“사용 사례와 리포지토리 패턴”에서 뭘 배우나요?

사용 사례를 Swift 프로토콜로 정의하고 리포지토리 인터페이스를 구현합니다. 브라우저에서 직접 실행하는 실습 코드로 Swift Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

Swift Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 Swift Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 2번째 강의입니다.

“사용 사례와 리포지토리 패턴” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 Swift Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 Swift Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

← Swift Academy(으)로 돌아가기