Pattern Use Case e Repository
Definire gli use case come protocolli Swift e implementare interfacce repository.
Pattern Use Case e Repository è una lezione Swift Academy gratuita su CoddyKit. Questa è la lezione 2 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Swift Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Swift Academy include 4 lezioni in totale.
Che cos'è un caso d'uso?
Un caso d'uso (interactor) incapsula una singola azione di business e coordina le entità e i repository del dominio.
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)
}
}Responsabilità singola
Ogni caso d'uso svolge esattamente un'operazione. Più responsabilità richiedono più casi d'uso.
// One use case per business action:
struct FetchUserUseCase { ... }
struct UpdateUserUseCase { ... }
struct DeleteUserUseCase { ... }Il caso d'uso come protocollo
Definire un protocollo per il caso d'uso, in modo da poterlo simulare nei test del livello Presentation.
protocol PlacingOrder {
func execute(userId: Int) async throws -> Order
}
struct PlaceOrderUseCase: PlacingOrder { ... }Che cos'è un repository?
Un repository astrae la sorgente dei dati. Chi lo utilizza interagisce con un protocollo Swift; l'implementazione può usare la rete, Core Data o la memoria.
protocol OrderRepository {
func create(receipt: PaymentReceipt) async throws -> Order
func list(userId: Int) async throws -> [Order]
func cancel(orderId: Int) async throws
}Implementazione del repository
Il repository concreto traduce le chiamate del dominio in operazioni di rete o sul database.
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 { ... }
}Repository in memoria per i test
Fornire un repository in memoria per eseguire test rapidi e deterministici senza operazioni di 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 } }
}Composizione dei casi d'uso
I casi d'uso possono chiamare altri casi d'uso per condividere sotto-operazioni, mantenendo ciascuno focalizzato.
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
}
}Repository e service a confronto
Repository: operazioni CRUD su un singolo tipo di entità. Service: coordina più entità o chiama API esterne senza gestire direttamente la persistenza.
// 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 }Caching nei repository
I repository possono memorizzare i risultati nella cache in modo trasparente, senza che il caso d'uso conosca questo dettaglio dell'implementazione.
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) }
}Testabilità
Poiché i casi d'uso dipendono da repository definiti tramite protocollo, è possibile inserire stub per testare la logica di business in isolamento.
let repo = InMemoryOrderRepo()
let sut = PlaceOrderUseCase(orders: repo, ...)
let order = try await sut.execute(userId: 1)
XCTAssertEqual(repo.orders.count, 1)Traduzione degli errori
I repository devono tradurre gli errori del livello Data (rete, database) in errori del dominio prima di restituirli.
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
}
}Verifica rapida
Qual è la differenza fondamentale tra un Repository e un Service in Clean Architecture?
Riepilogo della lezione
I casi d'uso incapsulano singole azioni di business e dipendono dai protocolli dei repository. I repository astraggono le sorgenti dei dati tramite un protocollo. Usare repository in memoria per eseguire test rapidi. I repository traducono gli errori dell'infrastruttura in errori del dominio. I service coordinano operazioni su più entità.
Impara Swift con un tutor IA — gratis
Scrivi ed esegui vero codice nel tuo browser, ricevi aiuto istantaneo da un tutor IA disponibile 24/7, e riprendi da dove hai lasciato sul web o nell'app.
- Corsi
- 122
- Lezioni
- 409
Domande Frequenti
La lezione «Pattern Use Case e Repository» è gratuita?
Sì — il testo completo di «Pattern Use Case e Repository» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Swift Academy, passa a CoddyKit PRO. Il corso Swift Academy include 4 lezioni in totale.
Cosa imparerò in «Pattern Use Case e Repository»?
Definire gli use case come protocolli Swift e implementare interfacce repository. Eserciti Swift Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.
Ho bisogno di esperienza per iniziare Swift Academy?
Non è richiesta alcuna esperienza precedente. Swift Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 2 di 4.
Quanto tempo richiede la lezione «Pattern Use Case e Repository»?
La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.
Posso scrivere ed eseguire codice in questa lezione Swift Academy?
Sì. Ogni lezione Swift Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.
Tutte le lezioni di questo corso
- Livelli: dominio, dati e presentazione
- Pattern Use Case e Repository
- Inversione delle dipendenze con astrazioni basate su protocolli
- Collegare i livelli senza un framework DI