Swinject: ce este, principiile Dependency Injection și cum funcționează

Ce este Swinject și Dependency Injection

Swinject este un container DI open-source pentru limbajul Swift, conceput pentru a simplifica injectarea dependențelor în aplicațiile pentru iOS, macOS și watchOS. Framework-ul utilizează abordarea Service Locator: serviciile sunt înregistrate într-un container central, iar containerul rezolvă automat graficul de dependențe la solicitarea unei instanțe.

Dependency Injection (DI) este un model de proiectare în care obiectul își primește dependențele din exterior, nu le creează în interior. Aceasta reduce cuplarea dintre componente, simplifică testarea modulară și permite înlocuirea implementărilor fără a modifica codul consumatorului.

Potrivit lui Martin Fowler (2004), DI este un caz particular al Inversion of Control și se implementează prin injectare prin constructor, proprietate sau metodă. Swinject automatizează acest proces, eliminând scrierea manuală a fabricilor și localizatorilor de servicii.

Aplicați Swinject în proiecte cu trei sau mai multe servicii care au dependențe încrucișate, unde construirea manuală a obiectelor duce la creșterea codului de inițializare și la scăderea testabilității.

Swinject se integrează strâns cu ecosistemul Apple și suportă toate versiunile Swift începând cu 3.0. Framework-ul este compatibil cu Objective-C prin punți, ceea ce permite implementarea lui în proiecte existente scrise în limbaj mixt fără migrarea completă a codului. Acest lucru este deosebit de relevant pentru aplicațiile mari cu o istorie de dezvoltare mai mare de cinci ani.

Cum funcționează containerul Swinject

Containerul Swinject este implementat prin clasa Container, care stochează registrul serviciilor înregistrate. La apelarea metodei resolve, containerul creează obiectul, rezolvând toate dependențele sale recursiv conform graficului de înregistrări.

Container și Service

Container este obiectul central în care se înregistrează corespondențele dintre abstractizare și implementarea sa. Service este protocolul care definește contractul, iar Component este clasa care implementează acest protocol. Înregistrarea se face prin metoda register, care primește tipul serviciului și fabrica.

let container = Container()
container.register(Networking.self) { _ in
    NetworkService()
}
let service = container.resolve(Networking.self)

Metoda resolve returnează o instanță a implementării concrete înregistrate pentru protocolul specificat. Dacă dependența nu este înregistrată, containerul aruncă o eroare fatală pentru detectarea rapidă a problemei în faza de dezvoltare.

Registration și servicii denumite

Fiecare înregistrare creează o intrare cu o funcție de fabrică și un scope selectat. Un serviciu poate avea mai multe înregistrări cu nume diferite, ceea ce permite selectarea unei implementări concrete după nume — util pentru medii diferite (dezvoltare, staging, producție).

Procesul de rezolvare a dependențelor (resolution) funcționează recursiv: când containerul creează o instanță a Component, analizează inițializatorul său și pentru fiecare parametru apelează resolve pentru tipul corespunzător. Dacă dependența are și ea propriile dependențe, procesul continuă până când întregul graf este complet construit. Adâncimea de imbricare este limitată doar de memoria disponibilă, dar în practică depășește rareori cinci niveluri.

Metode de injectare a dependențelor în Swinject

Swinject suportă trei metode principale de injectare a dependențelor, fiecare aplicabilă în funcție de contextul arhitectural.

Constructor Injection

Constructor Injection — injectarea dependențelor prin parametrii inițializatorului. Aceasta este metoda preferată, garantând că obiectul se află întotdeauna într-o stare corectă din momentul creării. Swinject rezolvă automat toate dependențele transmise constructorului.

class LoginViewModel {
    private let authService: AuthProtocol

    init(authService: AuthProtocol) {
        self.authService = authService
    }
}

container.register(AuthProtocol.self) { _ in
    AuthService()
}
container.register(LoginViewModel.self) { r in
    LoginViewModel(authService: r.resolve(AuthProtocol.self)!)
}

Property Injection

Property Injection — injectarea prin setarea proprietăților obiectului după inițializarea sa. Se utilizează când dependența este opțională sau nu poate fi transmisă prin constructor, de exemplu la lucrul cu Storyboard, unde view controller-ul este creat automat. Swinject suportă adnotarea @Inject pentru injectarea automată a proprietăților prin runtime fără apelarea explicită a resolve.

La utilizarea Property Injection este important să vă asigurați că dependența este setată înainte de prima accesare a obiectului. În caz contrar, proprietatea va rămâne nil, ceea ce va duce la un crash neașteptat. Swinject rezolvă această problemă prin mecanismul Implicitly Unwrapped Optional și verificarea strictă în faza de rezolvare a graficului de dependențe.

Method Injection

Method Injection — injectarea prin parametrii metodei. Se aplică pentru servicii care sunt necesare doar pentru executarea unei singure operații și nu ar trebui stocate ca stare permanentă a obiectului. Aceasta este cea mai puțin răspândită, dar utilă pentru callback-uri metodă de injectare.

Scope-uri în Swinject și rolul lor

ObjectScope — mecanismul care determină durata de viață a instanței create în interiorul containerului Swinject. Framework-ul oferă trei scope-uri încorporate cu posibilitatea de a crea scope-uri personalizate prin protocolul ObjectScopeProtocol.

ObjectScope.graph

Scope-ul graph — valoarea implicită. La fiecare apel resolve se creează o nouă instanță care trăiește doar pe durata rezolvării graficului de dependențe. Este o alegere sigură pentru serviciile fără stare, deoarece elimină scurgerile de memorie cauzate de memorarea în cache.

ObjectScope.container

Scope-ul container — singleton în cadrul containerului. Instanța este creată o dată la primul resolve și returnată la toate solicitările ulterioare. Potrivit pentru servicii cu stare partajată: cache de date, logger, setări ale aplicației.

ObjectScope.transient

Scope-ul transient — fiecare apel resolve creează o nouă instanță fără memorare în cache. Se utilizează pentru obiecte ușoare care nu trebuie reutilizate — de exemplu, pentru modulele de lucru cu o solicitare HTTP specifică.

Swinject în proiectele iOS

Integrarea Swinject într-un proiect iOS real începe cu inițializarea containerului la pornirea aplicației — în AppDelegate sau scenă. Se recomandă structurarea înregistrărilor prin Assembly: o clasă sau structură separată care grupează serviciile conexe.

Conform sondajului Swift Developer Community (2025), 43% dintre dezvoltatorii iOS folosesc containere DI în proiecte comerciale pentru gestionarea dependențelor stratului de rețea, repository-urilor și coordonatorilor de navigare. Swinject rămâne cea mai populară soluție datorită sintaxei minimale și compatibilității cu Objective-C.

Storyboard Injection — o capacitate unică a Swinject: containerul injectează automat dependențe în view controller-ele create din Storyboard, fără cod suplimentar în AppDelegate. Pentru aceasta se utilizează un resolver special transmis către UIStoryboard prin metoda init(container:), care interceptează crearea view controller-ului și injectează dependențele înregistrate.

În proiectele mari, Swinject poate fi combinat cu coordonatori de navigare: coordonatorul primește containerul și creează ecranele, rezolvând dependențele lor prin resolve, păstrând un punct unic de configurare pentru întreaga scenă.

Arhitectura cu Assembly — modelul recomandat pentru organizarea înregistrărilor. Fiecare Assembly grupează servicii conexe (de exemplu, NetworkingAssembly, DatabaseAssembly) și poate depinde de alte Assembly-uri. La inițializarea containerului, toate Assembly-urile se încarcă și își înregistrează serviciile, oferind o separare clară a responsabilităților și simplificând navigarea prin configurația DI în proiecte mari cu zeci de servicii.

Pentru depanarea graficului DI, Swinject oferă extensia SwinjectPropertyLoader, care încarcă configurația dintr-un fișier plist, și SwinjectStoryboard — integrarea cu storyboard-uri printr-o versiune specială a UIStoryboard. Aceste instrumente sunt deosebit de utile în faza de tranziție a unui proiect existent de la construirea manuală a obiectelor la DI: dezvoltatorul poate înregistra treptat servicii, verificând graficul de dependențe prin teste și înregistrarea erorilor de rezolvare, fără a opri dezvoltarea funcțiilor principale ale aplicației.

Swinject oferă, de asemenea, integrare cu RxSwift și Combine prin extensia SwinjectAutoregistration pentru rezolvarea automată a dependențelor după tipurile parametrilor inițializatorului fără înregistrarea explicită a fabricilor. Aceasta reduce volumul codului de înregistrare pentru servicii simple: este suficient să apelați container.register(ServiceProtocol.self) fără a specifica fabrica, iar Swinject va construi independent fabrica pe baza reflexiei Signal furnizată de mediul de execuție Swift. Această abordare este recomandată pentru servicii al căror constructor acceptă doar tipuri de bază și nu necesită logică complexă la creare.