dagger post updated

Author: maciej-nowak

_drafts/2019-05-13-dagger.md

@@ -11,7 +11,7 @@ keywords: "dagger, wstrzykiwanie, zależności, moduł, komponent, podkomponent,
 ---
 
 ## Wstęp
-Proces budowania większości aplikacji niezależnie od środowiska polega na tworzeniu różnego typu obiektów, które często wymagają innych zależności i nierzadko mogą być współdzielone. Ręczna inicjalizacja wszystkich zależności bywa kosztowna, czasochłonna oraz może zwiększać nadmiarowość powtarzającego się kodu. Wzorzec `Wstrzykiwanie zależności` (`Dependency Injection`) jest realizacją paradygmatu `Odwrócenia sterowania` (`Inversion of Control`) i przejmuje odpowiedzialność inicjalizowania obiektów poprzez wstrzykiwanie oczekiwanych zależności w odpowiednie miejsca. Na podstawie zdefiniowanych reguł `Dagger` dokonuje analizy zależności oraz generuje kod odpowiedzalny za wiązanie obiektów, a jego użycie opiera się wyłącznie na wykorzystaniu adnotacji i kontroli kompilacji w celu analizy i weryfikacji zależności. Dagger upraszcza dostęp do współużytkowanych instancji, ułatwia proces testowania i refaktoryzacji oraz jest prosty w konfiguracji.
+Proces budowania większości aplikacji niezależnie od środowiska polega na tworzeniu różnego typu obiektów, które często wymagają innych zależności i nierzadko mogą być współdzielone. Ręczna inicjalizacja wszystkich zależności bywa kosztowna, czasochłonna oraz może zwiększać nadmiarowość powtarzającego się kodu (`boilerplate`). Wzorzec `Wstrzykiwanie zależności` (`Dependency Injection`) jest realizacją paradygmatu `Odwrócenia sterowania` (`Inversion of Control`) i przejmuje odpowiedzialność inicjalizowania obiektów poprzez wstrzykiwanie oczekiwanych zależności w odpowiednie miejsca. Na podstawie zdefiniowanych komponentów i modułów `Dagger` dokonuje analizy zależności oraz generuje kod odpowiedzalny za wiązanie obiektów, a jego użycie opiera się wyłącznie na wykorzystaniu adnotacji i kontroli kompilacji w celu analizy i weryfikacji zależności. Dzięki temu proces testowania, refaktoryzacji i dostęp do współużytkowanych instancji jest uproszczony.
 
 ## Wstrzykiwanie
 Obiekt oznaczony adnotacją `@Inject` oczekuje inicjalizacji poprzez wstrzyknięcie zależności z poziomu komponentu. Jeśli kilka instancji tego samego typu ma zostać wstrzyknięte wówczas należy dokonać rozróżnienia za pomocą adnotacji `@Named` o wartości zgodnej z deklaracją w module. Istnieje także możliwość definicji własnego kwalifikatora przy użyciu adnotacji `@Qualifier` w definicji adnotacji.
@@ -197,6 +197,21 @@ public @interface UserScope {
 Rozszerzenie funckjonalności komponentu może zostać zrealizowane za pomocą wskazania zależności w postaci komponentu bazowego w komponencie pochodnym. Innymi słowy komponent rozszerzający jest swego rodzaju delegatem i poza modułami przyjmuje także zależność komponentu, który jest dla niego dostawcą. Komponent bazowy dostarcza `API` w postaci metod zwracających dany oczekiwany typ zależności (podobnie jak robi to moduł).
 
 {% highlight java %}
+@Module
+public class UserModule {
+
+    private final UserActivity activity;
+
+    public UserModule(UserActivity activity) {
+        this.activity = activity;
+    }
+
+    @Provides @UserScope
+    public UserManager providesUserDependency() {
+        return new UserManager("global");
+    }
+}
+
 @UserScope
 @Component(dependencies = AppComponent.class, modules = UserModule.class)
 public interface UserComponent {
@@ -205,7 +220,7 @@ public interface UserComponent {
 }
 
 @Singleton
-@Component(modules={AppModule.class, ManagerModule.class})
+@Component(modules = {AppModule.class, ManagerModule.class})
 public interface AppComponent {
 
     //remove injection methods if child performs this and no need to use only base component
@@ -263,21 +278,6 @@ public class UserActivity extends AppCompatActivity {
 Rozwinięcie grafu drzewa może odbywać się przy użyciu podkomponentów, które rozszerzają zależności komponentu bazowego co sprawia, że komponenty te są ze sobą powiązane. Aby stworzyć komponent, który będzie podkomponentem należy oznaczyć go adnotacją `@Subcomponent`, dodać fabrykę w komponencie bazowym zwracającą podkomponent oraz dokonać inicjalizacji we właściwym zakresie.
 
 {% highlight java %}
-@Module
-public class UserModule {
-
-    private final UserActivity activity;
-
-    public UserModule(UserActivity activity) {
-        this.activity = activity;
-    }
-
-    @Provides @UserScope
-    public UserManager providesUserDependency() {
-        return new UserManager("global");
-    }
-}
-
 @UserScope
 @Subcomponent(modules = UserModule.class)
 public interface UserComponent {