Éditeurs et abonnés personnalisés
Créez vos propres composants Combine.
Éditeurs et abonnés personnalisés est une leçon Swift Academy gratuite sur CoddyKit. Ceci est la leçon 4 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Swift Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Swift Academy comprend 4 leçons au total.
Au-delà des producteurs intégrés
Combine est fourni avec de nombreux producteurs, mais vous devez parfois encapsuler une API qui n'utilise pas Combine sous la forme d'un producteur, ou consommer des valeurs avec un contrôle précis de la contre-pression. Vous devez alors implémenter vous-même les protocoles de producteur et d'abonné.
Le protocole du producteur
Un producteur déclare ses types Output et Failure et implémente receive(subscriber:), où il remet un abonnement à l'abonné entrant.
protocol Publisher {
associatedtype Output
associatedtype Failure: Error
func receive<S: Subscriber>(subscriber: S)
where S.Input == Output, S.Failure == Failure
}Le rôle de l'abonnement
Lorsqu'un abonné se connecte, le producteur crée un objet abonnement. L'abonnement est le lien qui gère la demande et transmet les valeurs. Il est conforme à Subscription, qui étend Cancellable.
Un abonnement personnalisé
L'abonnement stocke l'abonné et répond aux demandes en émettant des valeurs.
final class CountSubscription<S: Subscriber>: Subscription
where S.Input == Int {
private var subscriber: S?
private var current = 0
init(subscriber: S) {
self.subscriber = subscriber
}
func request(_ demand: Subscribers.Demand) {
var remaining = demand
while remaining > 0 {
remaining -= 1
remaining += subscriber?.receive(current) ?? .none
current += 1
}
}
func cancel() {
subscriber = nil
}
}Un producteur personnalisé
Le producteur crée simplement l'abonnement et le transmet à l'abonné via receive(subscription:).
struct CountPublisher: Publisher {
typealias Output = Int
typealias Failure = Never
func receive<S: Subscriber>(subscriber: S)
where S.Input == Int, S.Failure == Never {
let subscription = CountSubscription(subscriber: subscriber)
subscriber.receive(subscription: subscription)
}
}Comprendre la demande
La contre-pression est le mécanisme de contrôle du flux de Combine. Un abonné demande une certaine Demand, et le producteur ne doit pas envoyer plus de valeurs que demandé. Renvoyer une demande depuis receive(_:) augmente la quantité autorisée.
Le protocole de l'abonné
Un abonné personnalisé implémente trois méthodes : il reçoit l'abonnement, puis chaque valeur, puis un achèvement.
protocol Subscriber {
associatedtype Input
associatedtype Failure: Error
func receive(subscription: Subscription)
func receive(_ input: Input) -> Subscribers.Demand
func receive(completion: Subscribers.Completion<Failure>)
}Un abonné personnalisé
Ici, un abonné demande d'abord deux valeurs, puis une valeur supplémentaire pour chaque valeur reçue, en les affichant au fur et à mesure.
final class PrintSubscriber: Subscriber {
typealias Input = Int
typealias Failure = Never
func receive(subscription: Subscription) {
subscription.request(.max(2))
}
func receive(_ input: Int) -> Subscribers.Demand {
print("Value:", input)
return .max(1)
}
func receive(completion: Subscribers.Completion<Never>) {
print("Done")
}
}Encapsuler une API de délégué
Une utilisation pratique des producteurs personnalisés consiste à relier une API de délégué ou de rappels à Combine, afin que du code ancien devienne combinable. Vous stockez l'abonné et transmettez les rappels du délégué sous forme d'appels à receive(_:).
Préférez les sujets quand c'est possible
Il est rarement nécessaire d'implémenter ces protocoles manuellement. Pour la plupart des intégrations, un PassthroughSubject ou un CurrentValueSubject est bien plus simple : il vous suffit d'appeler send(_:).
let subject = PassthroughSubject<Int, Never>()
subject
.sink { print($0) }
.store(in: &cancellables)
subject.send(1)
subject.send(2)Quand opter pour une solution personnalisée
Optez pour des implémentations personnalisées de producteurs et d'abonnés lorsque vous avez besoin :
- d'un contrôle précis de la contre-pression
- d'encapsuler efficacement une source complexe qui n'utilise pas Combine
- d'opérateurs réutilisables et sûrs du point de vue des types
Sinon, les sujets et les opérateurs intégrés sont les outils appropriés.
Vérification rapide
Évaluez vos connaissances sur les producteurs personnalisés.
Récapitulatif
Vous avez appris à implémenter les protocoles fondamentaux de Combine :
- un producteur crée un abonnement pour chaque abonné
- l'abonnement respecte la demande (contre-pression)
- l'abonné reçoit l'abonnement, les valeurs et l'achèvement
- préférez les sujets pour la plupart des intégrations
Comprendre ces mécanismes internes démystifie le fonctionnement de Combine dans son ensemble.
Questions Fréquemment Posées
La leçon « Éditeurs et abonnés personnalisés » est-elle gratuite ?
Oui — le texte complet de « Éditeurs et abonnés personnalisés » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Swift Academy, passe à CoddyKit PRO. Le cours Swift Academy comprend 4 leçons au total.
Qu'est-ce que j'apprendrai dans « Éditeurs et abonnés personnalisés » ?
Créez vos propres composants Combine. Tu pratiques Swift Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.
Dois-je avoir de l'expérience pour commencer Swift Academy ?
Aucune expérience préalable n'est requise. Swift Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 4 sur 4.
Combien de temps prend la leçon « Éditeurs et abonnés personnalisés » ?
La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.
Peux-tu écrire et exécuter du code dans cette leçon Swift Academy ?
Oui. Chaque leçon Swift Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.
Toutes les leçons de ce cours
- Transformer et combiner des flux
- Planificateurs et gestion des fils d’exécution
- Opérateurs de gestion des erreurs
- Éditeurs et abonnés personnalisés