Android Apps with Dagger (SF Android Meetup, April 2014)

An introduction to dependency injection, the Dagger library, and how to combine the two in your Android applications.

http://www.meetup.com/sfandroid/events/171955222/

Transcript

1. Dagger Jake Wharton
2. Dependency Injection
3. Dependency Injection • Every single app has some form of dependency injection
4. Dependency Injection • Every single app has some form of dependency injection • Separate behavior of something from its required classes
5. Dependency Injection • Every single app has some form of dependency injection • Separate behavior of something from its required classes Tweeter
6. Dependency Injection • Every single app has some form of dependency injection • Separate behavior of something from its required classes Tweeter Twitter API
7. Dependency Injection • Every single app has some form of dependency injection • Separate behavior of something from its required classes Tweeter Twitter API HTTP Client
8. public  class  Tweeter  {      public  void  tweet(String  tweet)  {          TwitterApi  api  =  new  TwitterApi();          api.postTweet("JakeWharton",  tweet);      }   }
9. public  class  Tweeter  {      public  void  tweet(String  tweet)  {          TwitterApi  api  =  new  TwitterApi();          api.postTweet("JakeWharton",  tweet);      }   } public  class  TwitterApi  {      public  void  postTweet(String  user,  String  tweet)  {          OkHttpClient  client  =  new  OkHttpClient();          HttpUrlConnection  conn  =  client.open("...");          //  ...  POST  blah  blah  blah  ...      }   }
10. public  class  Tweeter  {      public  void  tweet(String  tweet)  {          TwitterApi  api  =  new  TwitterApi();          api.postTweet("JakeWharton",  tweet);      }   } Tweeter  tweeter  =  new  Tweeter();   tweeter.tweet("Hello,  #Dagger  Meetup!"); public  class  TwitterApi  {      public  void  postTweet(String  user,  String  tweet)  {          OkHttpClient  client  =  new  OkHttpClient();          HttpUrlConnection  conn  =  client.open("...");          //  ...  POST  blah  blah  blah  ...      }   }
11. public  class  TwitterApi  {      public  void  postTweet(String  user,  String  tweet)  {          OkHttpClient  client  =  new  OkHttpClient();          HttpUrlConnection  conn  =  client.open("...");          //  ...  POST  blah  blah  blah  ...      }   }
12. public  class  TwitterApi  {      private  final  OkHttpClient  client  =  new  OkHttpClient();          public  void  postTweet(String  user,  String  tweet)  {          HttpUrlConnection  conn  =  client.open("...");          //  ...  POST  blah  blah  blah  ...      }   }
13. public  class  TwitterApi  {      private  final  OkHttpClient  client;            public  TwitterApi(OkHttpClient  client)  {          this.client  =  client;      }          public  void  postTweet(String  user,  String  tweet)  {          HttpUrlConnection  conn  =  client.open("...");          //  ...  POST  blah  blah  blah  ...      }   }
14. public  class  Tweeter  {      public  void  tweet(String  tweet)  {          TwitterApi  api  =  new  TwitterApi();          api.postTweet("JakeWharton",  tweet);      }   }
15. public  class  Tweeter  {      public  void  tweet(String  tweet)  {          TwitterApi  api  =  new  TwitterApi(new  OkHttpClient());          api.postTweet("JakeWharton",  tweet);      }   }
16. public  class  Tweeter  {      private  final  TwitterApi  api  =  new  TwitterApi(new  OkHttpClient());            public  void  tweet(String  tweet)  {          api.postTweet("JakeWharton",  tweet);      }   }
17. public  class  Tweeter  {      private  final  TwitterApi  api  =  new  TwitterApi(new  OkHttpClient());      private  final  String  user;            public  Tweeter(String  user)  {          this.user  =  user;      }            public  void  tweet(String  tweet)  {          api.postTweet(user,  tweet);      }   }
18. Tweeter  tweeter  =  new  Tweeter();   tweeter.tweet("Hello,  #Dagger  Meetup!");
19. Tweeter  tweeter  =  new  Tweeter("JakeWharton");   tweeter.tweet("Hello,  #Dagger  Meetup!"); tweeter.tweet("Log  cabins!  #Dagger  @twoffice");   tweeter.tweet("mind  ==  blown.  #Dagger");   tweeter.tweet("Where’s  that  @jessewilson  character?");   tweeter.tweet("#Dagger,  #Dagger  bills  y’all");   tweeter.tweet("Leave  early  for  Beer  Hall,  anyone?  #Meetup  #Dagger");
20. Tweeter  tweeter  =  new  Tweeter("JakeWharton");   tweeter.tweet("Hello,  #Dagger  Meetup!"); tweeter.tweet("Log  cabins!  #Dagger  @twoffice");   tweeter.tweet("mind  ==  blown.  #Dagger");   tweeter.tweet("Where’s  that  @jessewilson  character?");   tweeter.tweet("#Dagger,  #Dagger  bills  y’all");   tweeter.tweet("Leave  early  for  Beer  Hall,  anyone?  #Meetup  #Dagger"); Timeline  timeline  =  new  Timeline("JakeWharton");   timeline.loadMore(20);   for  (Tweet  tweet  :  timeline.get())  {      System.out.println(tweet);   }
21. public  class  Timeline  {      private  final  List<Tweet>  tweetCache  =  new  ArrayList<>();      private  final  TwitterApi  api  =  new  TwitterApi(new  OkHttpClient());      private  final  String  user;            public  Timeline(String  user)  {          this.user  =  user;      }            public  List<Tweet>  get()  {  /*  ...  */  }      public  void  loadMore(int  amount)  {  /*  ...  */  }   }
22. public  class  Timeline  {      private  final  List<Tweet>  tweetCache  =  new  ArrayList<>();      private  final  TwitterApi  api;      private  final  String  user;            public  Timeline(TwitterApi  api,  String  user)  {          this.api  =  api;          this.user  =  user;      }            public  List<Tweet>  get()  {  /*  ...  */  }      public  void  loadMore(int  amount)  {  /*  ...  */  }   }
23. public  class  Tweeter  {      private  final  TwitterApi  api  =  new  TwitterApi(new  OkHttpClient());      private  final  String  user;            public  Tweeter(String  user)  {          this.user  =  user;      }            public  void  tweet(String  tweet)  {          api.postTweet(user,  tweet);      }   }
24. public  class  Tweeter  {      private  final  TwitterApi  api;      private  final  String  user;            public  Tweeter(TwitterApi  api,  String  user)  {          this.api  =  api;          this.user  =  user;      }            public  void  tweet(String  tweet)  {          api.postTweet(user,  tweet);      }   }
25. Tweeter  tweeter  =  new  Tweeter("JakeWharton");   tweeter.tweet("Hello,  #Dagger  Meetup!");   ! Timeline  timeline  =  new  Timeline("JakeWharton");   timeline.loadMore(20);   for  (Tweet  tweet  :  timeline.get())  {      System.out.println(tweet);   }
26. OkHttpClient  client  =  new  OkHttpClient();   TwitterApi  api  =  new  TwitterApi(client);   String  user  =  "JakeWharton";       Tweeter  tweeter  =  new  Tweeter(api,  user);   tweeter.tweet("Managing  my  own  dependencies  :(");       Timeline  timeline  =  new  Timeline(api,  user);   timeline.loadMore(20);   for  (Tweet  tweet  :  timeline.get())  {      System.out.println(tweet);   }
27. Dependency Injection • Every single app has some form of dependency injection • Separate the behavior from the classes required to perform it Tweeter Twitter API HTTP Client
28. Dependency Injection • Every single app has some form of dependency injection • Separate the behavior from the classes required to perform it Tweeter Twitter API HTTP Client Timeline
29. Dependency Injection • Every single app has some form of dependency injection • Separate the behavior from the classes required to perform it • How do we avoid the boilerplate that comes with the pattern?
30. We used Guice
31. We used Guice • All of our Java services heavily use Guice
32. We used Guice • All of our Java services heavily use Guice • Powerful, dynamic, well-tested, wide-spread, etc...
33. We used Guice • All of our Java services heavily use Guice • Powerful, dynamic, well-tested, wide-spread, etc... • Canonical standard for dependency injection
34. We used Guice • All of our Java services heavily use Guice • Powerful, dynamic, well-tested, wide-spread, etc... • Canonical standard for dependency injection • Configuration problems fail at runtime
35. We used Guice • All of our Java services heavily use Guice • Powerful, dynamic, well-tested, wide-spread, etc... • Canonical standard for dependency injection • Configuration problems fail at runtime • Slow initialization, slow injection, memory problems
36. “Object Graph” Goals
37. “Object Graph” Goals • Static analysis of all dependencies and injections
38. “Object Graph” Goals • Static analysis of all dependencies and injections • Fail as early as possible (compile-time, not runtime)
39. “Object Graph” Goals • Static analysis of all dependencies and injections • Fail as early as possible (compile-time, not runtime) • Eliminate reflection on methods and annotations at runtime
40. “Object Graph” Goals • Static analysis of all dependencies and injections • Fail as early as possible (compile-time, not runtime) • Eliminate reflection on methods and annotations at runtime • Have negligible memory impact
41. “Object Graph” Development
42. “Object Graph” Development • ~5 weeks of heads-down work by Jesse Wilson
43. “Object Graph” Development • ~5 weeks of heads-down work by Jesse Wilson • Bob Lee served as technical advisor
44. “Object Graph” Development • ~5 weeks of heads-down work by Jesse Wilson • Bob Lee served as technical advisor • “Giant” boolean switch in our applications
45. “Object Graph” Development • ~5 weeks of heads-down work by Jesse Wilson • Bob Lee served as technical advisor • “Giant” boolean switch in our applications • 2 weeks after, dropped Guice completely
46. “Object Graph” Development • ~5 weeks of heads-down work by Jesse Wilson • Bob Lee served as technical advisor • “Giant” boolean switch in our applications • 2 weeks after, dropped Guice completely • Renamed to Dagger before first release
47. Dagger
48. Dagger Tweeter Twitter API HTTP Client User Manager Shared Preferences Account Manager
49. Dagger Tweeter Twitter API HTTP Client User Manager Shared Preferences DAG-er Account Manager
50. Dagger
51. Dagger • ObjectGraph: central dependency manager and injector
52. Dagger • ObjectGraph: central dependency manager and injector • @Module + @Provides: mechanism for providing dependencies
53. Dagger • ObjectGraph: central dependency manager and injector • @Module + @Provides: mechanism for providing dependencies • @Inject: mechanism for requesting dependencies
54. Dagger • ObjectGraph: central dependency manager and injector • @Module + @Provides: mechanism for providing dependencies • @Inject: mechanism for requesting dependencies • Plus some other sugar, magic, and conventions
55. Providing Dependencies
56. Providing Dependencies • Modules are classes that provide dependencies
57. Providing Dependencies • Modules are classes that provide dependencies • @Module annotation on the class
58. Providing Dependencies • Modules are classes that provide dependencies • @Module annotation on the class • @Provider annotation on a method indicates that its return type is a dependency
59. ! public  class  NetworkModule  {   !    public  OkHttpClient  provideOkHttpClient()  {          return  new  OkHttpClient();      }       !    public  TwitterApi  provideTwitterApi(OkHttpClient  client)  {          return  new  TwitterApi(client);      }   ! }
60. ! public  class  NetworkModule  {   !    public  OkHttpClient  provideOkHttpClient()  {          return  new  OkHttpClient();      }       !    public  TwitterApi  provideTwitterApi(OkHttpClient  client)  {          return  new  TwitterApi(client);      }   ! } @Module
61. ! public  class  NetworkModule  {   !    public  OkHttpClient  provideOkHttpClient()  {          return  new  OkHttpClient();      }       !    public  TwitterApi  provideTwitterApi(OkHttpClient  client)  {          return  new  TwitterApi(client);      }   ! } ! !    @Provides   ! ! ! !    @Provides   ! ! ! @Module
62. ! public  class  NetworkModule  {   !    public  OkHttpClient  provideOkHttpClient()  {          return  new  OkHttpClient();      }       !    public  TwitterApi  provideTwitterApi(OkHttpClient  client)  {          return  new  TwitterApi(client);      }   ! } ! !    @Provides   ! ! ! !    @Provides   ! ! ! ! !                        @Singleton   ! ! ! !                        @Singleton   ! ! ! @Module
63. Providing Dependencies
64. Providing Dependencies OkHttpClient TwitterApi
65. Providing Dependencies OkHttpClient TwitterApi NetworkModule#provideOkHttpClient NetworkModule#provideTwitterApi
66. Providing Dependencies OkHttpClient TwitterApi NetworkModule#provideOkHttpClient NetworkModule#provideTwitterApi
67. Providing Dependencies OkHttpClient TwitterApi NetworkModule#provideOkHttpClient NetworkModule#provideTwitterApi
68. Providing Dependencies • Modules are classes that provide dependencies • @Module annotation on the class provides static analysis hints • @Provider annotation on a method indicates that its return type is a dependency
69. Providing Dependencies • Modules are classes that provide dependencies • @Module annotation on the class provides static analysis hints • @Provider annotation on a method indicates that its return type is a dependency • Designed to be composed together
70. @Module   public  class  TwitterModule  {      private  final  String  user;            public  TwitterModule(String  user)  {          this.user  =  user;      }            @Provides  @Singleton      public  Tweeter  provideTweeter(TwitterApi  api)  {          return  new  Tweeter(api,  user);      }          @Provides  @Singleton      public  Timeline  provideTimeline(TwitterApi  api)  {          return  new  Timeline(api,  user);      }   }
71. Providing Dependencies OkHttpClient   TwitterApi NetworkModule#provideOkHttpClient   NetworkModule#provideTwitterApi
72. Providing Dependencies OkHttpClient   TwitterApi NetworkModule#provideOkHttpClient   NetworkModule#provideTwitterApi Tweeter Timeline TwitterModule#provideTweeter TwitterModule#provideTimeline
73. Requesting Dependencies
74. Requesting Dependencies • @Inject annotation required
75. Requesting Dependencies • @Inject annotation required • Field injection and constructor injection only
76. Constructor Injection
77. Constructor Injection • @Inject on a single constructor
78. Constructor Injection • @Inject on a single constructor • All constructor arguments are dependencies
79. Constructor Injection • @Inject on a single constructor • All constructor arguments are dependencies • Dependencies can be stored in private and final fields
80. public  class  TweeterApp  {      private  final  Tweeter  tweeter;      private  final  Timeline  timeline;            @Inject      public  TweeterApp(Tweeter  tweeter,  Timeline  timeline)  {          this.tweeter  =  tweeter;          this.timeline  =  timeline;      }            //  ...   }
81. Constructor Injection • @Inject on a single constructor • All constructor arguments are dependencies • Dependencies can be stored in private and final fields
82. Constructor Injection • @Inject on a single constructor • All constructor arguments are dependencies • Dependencies can be stored in private and final fields • Dagger must create the object
83. Constructor Injection • @Inject on a single constructor • All constructor arguments are dependencies • Dependencies can be stored in private and final fields • Dagger must create the object • @Provides not required for downstream injection
84. Field Injection
85. Field Injection • @Inject on fields which are dependencies
86. Field Injection • @Inject on fields which are dependencies • Field may not be private or final
87. public  class  TweeterApp  {      @Inject  Tweeter  tweeter;      @Inject  Timeline  timeline;            //  ...   }
88. public  class  TweeterActivity  extends  Activity  {      @Inject  Tweeter  tweeter;      @Inject  Timeline  timeline;            //  ...   }
89. Field Injection • @Inject on fields which are dependencies • Field may not be private or final
90. Field Injection • @Inject on fields which are dependencies • Field may not be private or final • Injection happens after the object is “alive”
91. Field Injection • @Inject on fields which are dependencies • Field may not be private or final • Injection happens after the object is “alive” • Object often must be responsible for injecting itself
92. The ObjectGraph
93. The ObjectGraph • Central module (dependency) manager
94. The ObjectGraph • Central module (dependency) manager • Injector
95. ObjectGraph  og  =  ObjectGraph.create(          new  NetworkModule(),          new  TwitterModule("JakeWharton")   );
96. ObjectGraph  og  =  ObjectGraph.create(          new  NetworkModule(),          new  TwitterModule("JakeWharton")   ); //  Using  constructor  injection:   TweeterApp  app  =  og.get(TweeterApp.class);
97. ObjectGraph  og  =  ObjectGraph.create(          new  NetworkModule(),          new  TwitterModule("JakeWharton")   ); //  Using  constructor  injection:   TweeterApp  app  =  og.get(TweeterApp.class); //  Using  field  injection:   TweeterApp  app  =  new  TweeterApp();   og.inject(app);
98. The ObjectGraph • Central module (dependency) manager • Injector
99. The ObjectGraph • Central module (dependency) manager • Injector • Can be extended to create “scopes”
100. ObjectGraph  og  =  ObjectGraph.create(          new  NetworkModule(),          new  TwitterModule("JakeWharton")   );
101. ObjectGraph  og  =  ObjectGraph.create(          new  NetworkModule()   );
102. ObjectGraph  og  =  ObjectGraph.create(          new  NetworkModule(),          new  PersistenceModule(),          new  AccountModule()   );
103. ObjectGraph  og  =  ObjectGraph.create(          new  NetworkModule(),          new  PersistenceModule(),          new  AccountModule()   ); //  Inject  app  things  using  ‘og’...
104. ObjectGraph  og  =  ObjectGraph.create(          new  NetworkModule(),          new  PersistenceModule(),          new  AccountModule()   ); //  Later...   String  user  =  "JakeWharton"; //  Inject  app  things  using  ‘og’...
105. ObjectGraph  og  =  ObjectGraph.create(          new  NetworkModule(),          new  PersistenceModule(),          new  AccountModule()   ); //  Later...   String  user  =  "JakeWharton"; ObjectGraph  userOg  =  og.plus(new  TwitterModule(user)); //  Inject  app  things  using  ‘og’... //  Inject  user  things  using  ‘userOg’...
106. OkHttpClient TwitterApi NetworkModule
107. OkHttpClient TwitterApi NetworkModule PersistenceModule ! . . . AccountModule ! . . .
108. OkHttpClient TwitterApi NetworkModule PersistenceModule ! . . . AccountModule ! . . . og
109. OkHttpClient TwitterApi NetworkModule PersistenceModule ! . . . AccountModule ! . . . UserModule Tweeter Timeline og
110. OkHttpClient TwitterApi NetworkModule PersistenceModule ! . . . AccountModule ! . . . UserModule Tweeter Timeline og userOg
111. OkHttpClient TwitterApi NetworkModule PersistenceModule ! . . . AccountModule ! . . . UserModule Tweeter Timeline og userOg
112. OkHttpClient TwitterApi NetworkModule PersistenceModule ! . . . AccountModule ! . . . UserModule Tweeter Timeline og userOg
113. Android
114. Android • Entry objects are managed objects constructed by OS
115. Android • Entry objects are managed objects constructed by OS • Multiple services, activities, etc. required shared state
116. Android • Entry objects are managed objects constructed by OS • Multiple services, activities, etc. required shared state • Platform is very difficult to test
117. Android • Entry objects are managed objects constructed by OS • Multiple services, activities, etc. required shared state • Platform is very difficult to test • Build system allows for dynamic flavors and build types
118. Android • Entry objects are managed objects constructed by OS • Multiple services, activities, etc. required shared state • Platform is very difficult to test • Build system allows for dynamic flavors and build types • Many libraries require keeping singletons or long-lived objects
119. The ObjectGraph • Central module (dependency) manager • Injector • Can be extended to create “scopes”
120. The ObjectGraph • Central module (dependency) manager • Injector • Can be extended to create “scopes” • Eagerly or lazily created on the Application by convention
121. public  class  ExampleApp  extends  Application  {      private  ObjectGraph  objectGraph;          @Override  public  void  onCreate()  {          super.onCreate();   !        objectGraph  =  ObjectGraph.create(              new  ExampleModule()          );      }          public  ObjectGraph  getObjectGraph()  {          return  objectGraph;      }   }
122. public  class  ExampleActivity  extends  Activity  {      @Inject  Foo  foo;      @Inject  Bar  bar;          @Override      protected  void  onCreate(Bundle  savedInstanceState)  {          super.onCreate(savedInstanceState);              ExampleApp  app  =  (ExampleApp)  getApplication();          app.getObjectGraph().inject(this);              //  ...      }   }
123. The ObjectGraph • Central module (dependency) manager • Injector • Can be extended to create “scopes” • Eagerly or lazily created on the Application by convention
124. The ObjectGraph • Central module (dependency) manager • Injector • Can be extended to create “scopes” • Eagerly or lazily created on the Application by convention • Just another object instance
125. Listing Injection Points
126. Listing Injection Points • All injection points must be listed on a module
127. Listing Injection Points • All injection points must be listed on a module • Used for aggressive static analysis
128. Listing Injection Points • All injection points must be listed on a module • Used for aggressive static analysis • Potentially not needed for full compilation...
129. Listing Injection Points • All injection points must be listed on a module • Used for aggressive static analysis • Potentially not needed for full compilation... • ...but absolutely required for incremental compilation
130. @Module   public  class  ExampleModule  {      @Provides  @Singleton  Foo  provideFoo()  {          return  new  Foo();      }            @Provides  @Singleton  Bar  provideBar()  {          return  new  Bar();      }   }
131. @Module(      injects  =  {          ExampleActivity.class      }   )   public  class  ExampleModule  {      @Provides  @Singleton  Foo  provideFoo()  {          return  new  Foo();      }            @Provides  @Singleton  Bar  provideBar()  {          return  new  Bar();      }   }
132. Use in Android
133. Use in Android • Root ObjectGraph on Application
134. Use in Android • Root ObjectGraph on Application • Activities, services, fragments, views obtain and inject
135. Use in Android • Root ObjectGraph on Application • Activities, services, fragments, views obtain and inject • Modules and their “injects” segment parts of your app
136. Use in Android: .plus()
137. Use in Android: .plus() • Extend the graph with additional modules
138. Use in Android: .plus() • Extend the graph with additional modules • Allows creating “scopes” of dependencies
139. public  class  TweeterApp  extends  Application  {      private  ObjectGraph  objectGraph;          @Override  public  void  onCreate()  {          super.onCreate();   !        objectGraph  =  ObjectGraph.create(              new  NetworkModule(),              new  PersistenceModule(),              new  AccountModule(),          );      }          public  ObjectGraph  getObjectGraph()  {          return  objectGraph;      }   }
140. public  class  LandingActivity  extends  Activity  {      @Inject  UserManager  userManager;          @Override      protected  void  onCreate(Bundle  savedInstanceState)  {          super.onCreate(savedInstanceState);   !        ExampleApp  app  =  (ExampleApp)  getApplication();          app.getObjectGraph().inject(this);   !        if  (userManager.hasUser())  {              //  Start  TimelineActivity,  finish,  return...          }              //  Show  log  in  /  sign  up...      }   }
141. public  class  TimelineActivity  extends  Activity  {      @Inject  Timeline  timeline;      @Inject  Tweeter  tweeter;   !    @Override      protected  void  onCreate(Bundle  savedInstanceState)  {          super.onCreate(savedInstanceState);   !        ExampleApp  app  =  (ExampleApp)  getApplication();          ObjectGraph  og  =  app.getObjectGraph();   !        String  user  =  og.get(UserManager.class).getUser();          //  TODO  if  user  ==  null,  finish  and  start  LandingActivity...          og.plus(new  TwitterModule(user)).inject(this);              //  Set  up  timeline  and  tweeter  UI...      }   }
142. Use in Android: .plus()
143. Use in Android: .plus()
144. Sign Up Use in Android: .plus()
145. Use in Android: .plus() Forgot Password
146. @Module(      injects  =  {          SignUpView.class,  ForgotPasswordView.class      }   )   public  class  SignUpModule  {      private  final  SignUpActivity  signUpActivity;   !    public  SignUpModule(SignUpActivity  signUpActivity)  {          this.signUpActivity  =  signUpActivity;      }   !    @Provides  @Singleton  ActionBar  provideActionBar()  {          return  signUpActivity.getActionBar();      }   }
147. public  class  SignUpActivity  class  Activity  {      private  final  ObjectGraph  childOg;   !    @Override      protected  void  onCreate(Bundle  savedInstanceState)  {          super.onCreate(savedInstanceState);   !        ExampleApp  app  =  (ExampleApp)  getApplication();          ObjectGraph  og  =  app.getObjectGraph();   !        childOg  =  og.plus(new  SignUpModule(this));   !        //  Content  set  up  and  injection...      }   }
148. public  class  SignUpView  class  LinearLayout  {      @Inject  ActionBar  actionBar;   !    public  SignUpView(Context  context,  AttributeSet  attrs)  {          super(context,  attrs);          //  Note:  Injection  happens  by  parent  activity.      }   !    @Override  public  void  onAttachedToWindow()  {          super.onAttachedToWindow();          actionBar.setTitle(R.string.sign_up);      }   }
149. Use in Android: overrides
150. Use in Android: overrides • Modules whose dependencies override others
151. Use in Android: overrides • Modules whose dependencies override others • Only apply in the same ObjectGraph
152. Use in Android: overrides • Modules whose dependencies override others • Only apply in the same ObjectGraph • Useful for customizing flavors and testing
153. public  class  Timeline  {      private  final  List<Tweet>  tweetCache  =  new  ArrayList<>();      private  final  TwitterApi  api;      private  final  String  user;            public  Timeline(TwitterApi  api,  String  user)  {          this.api  =  api;          this.user  =  user;      }            public  List<Tweet>  get()  {  /*  ...  */  }      public  void  loadMore(int  amount)  {  /*  ...  */  }   }
154. public  class  MockTimeline  extends  Timeline  {      private  final  List<Tweet>  tweets  =  new  ArrayList<>();            @Inject  MockTimeline()  {          tweets.add(new  Tweet("MockUser",  "Hello,  mock  data!");      }            @Override  public  List<Tweet>  get()  {          return  tweets;      }   !    public  void  addTweet(Tweet  tweet)  {          tweets.add(new  Tweet("MockUser",  tweet),  0);      }   !    @Override  public  void  loadMore(int  amount)  {}   }
155. public  class  Tweeter  {      private  final  TwitterApi  api;      private  final  String  user;            public  Tweeter(TwitterApi  api,  String  user)  {          this.api  =  api;          this.user  =  user;      }            public  void  tweet(String  tweet)  {          api.postTweet(user,  tweet);      }   }
156. public  class  MockTweeter  extends  Tweeter  {      private  final  MockTimeline  timeline;            @Inject  MockTweeter(MockTimeline  timeline)  {          this.timeline  =  timeline;      }            @Override  public  void  tweet(String  tweet)  {          timeline.addTweet(tweet);      }   }
157. @Module(      overrides  =  true   )   public  class  MockTwitterModule  {      @Provides  @Singleton      public  Tweeter  provideTweeter(MockTweeter  mockTweeter)  {          return  mockTweeter;      }          @Provides  @Singleton      public  Timeline  provideTimeline(MockTimeline  mockTimeline)  {          return  mockTimeline;      }   }
158. ObjectGraph  og  =  ObjectGraph.create(      new  NetworkModule(),      new  TwitterModule("JakeWharton"),            new  MockTwitterModule()   );
159. Timeline  timeline  =  /*  injected  */   Tweeter  tweeter  =  /*  injected  */
160. Timeline  timeline  =  /*  injected  */   Tweeter  tweeter  =  /*  injected  */ for  (Tweet  tweet  :  timeline.get())  {      System.out.println(tweet);   }   //    MockUser:  Hello,  mock  data!
161. Timeline  timeline  =  /*  injected  */   Tweeter  tweeter  =  /*  injected  */ tweeter.tweet("Showing  off  more  mock  data!  #Dagger"); for  (Tweet  tweet  :  timeline.get())  {      System.out.println(tweet);   }   //    MockUser:  Hello,  mock  data!
162. Timeline  timeline  =  /*  injected  */   Tweeter  tweeter  =  /*  injected  */ for  (Tweet  tweet  :  timeline.get())  {      System.out.println(tweet);   }   //  MockUser:  Showing  off  more  mock  data!  #Dagger   //  MockUser:  Hello,  mock  data! tweeter.tweet("Showing  off  more  mock  data!  #Dagger"); for  (Tweet  tweet  :  timeline.get())  {      System.out.println(tweet);   }   //    MockUser:  Hello,  mock  data!
163. Mock Mode
164. Mock Mode • Modules which override all network-calling classes
165. Mock Mode • Modules which override all network-calling classes • Alternate implementations of network-calling classes which emulate a remote server but in-memory
166. Mock Mode • Modules which override all network-calling classes • Alternate implementations of network-calling classes which emulate a remote server but in-memory • Fake images and data included in debug builds
170. //  src/release/java   ! final  class  Modules  {      static  Object[]  list()  {          return  new  Object[]  {              new  WalletModule()          };      }   }
171. //  src/release/java   ! final  class  Modules  {      static  Object[]  list()  {          return  new  Object[]  {              new  WalletModule()          };      }   } //  src/debug/java   ! final  class  Modules  {      static  Object[]  list()  {          return  new  Object[]  {              new  WalletModule(),              new  DebugWalletModule()          };      }   }
172. public  class  WalletApp  extends  Application  {      private  ObjectGraph  objectGraph;          @Override  public  void  onCreate()  {          super.onCreate();   !        objectGraph  =  ObjectGraph.create(Modules.list());      }          public  ObjectGraph  getObjectGraph()  {          return  objectGraph;      }   }
173. Debug Drawer
174. Debug Drawer • Provides quick access to developer options and information
175. Debug Drawer • Provides quick access to developer options and information • Completely hidden from normal UI
176. Debug Drawer • Provides quick access to developer options and information • Completely hidden from normal UI • Contains controls for changing app behavior
182. U+2020 Sample App • Dagger • Retrofit • RxJava • Picasso • OkHttp • Butter Knife • Timber • Build Flavors
183. U+2020 Sample App • Dagger • Retrofit • RxJava • Picasso • OkHttp • Butter Knife • Timber • Build Flavors http://github.com/JakeWharton/u2020/
184. Dependency Injection
185. Dependency Injection • Do NOT ignore the pattern
186. Dependency Injection • Do NOT ignore the pattern • Do NOT make every class use the pattern
187. Dependency Injection • Do NOT ignore the pattern • Do NOT make every class use the pattern • Do NOT store dependencies as static fields
188. “Avoid Dependency Injection”
189. “Avoid Dependency Injection” Using a dependency injection framework such as Guice or RoboGuice may be attractive because they can simplify the code you write and provide an adaptive environment that's useful for testing and other configuration changes. However, these frameworks tend to perform a lot of process initialization by scanning your code for annotations, which can require significant amounts of your code to be mapped into RAM even though you don't need it. d.android.com/training/articles/memory.html#DependencyInjection
190. Dagger Performance
191. Dagger Performance • Annotation processor generates code to fulfill dependencies
192. Dagger Performance • Annotation processor generates code to fulfill dependencies • Happens automatically inside of javac
193. Dagger Performance • Annotation processor generates code to fulfill dependencies • Happens automatically inside of javac • Zero reflection on methods or fields
194. Dagger Performance • Annotation processor generates code to fulfill dependencies • Happens automatically inside of javac • Zero reflection on methods or fields • Debugger and developer friendly
195. The Future
196. The Future • Zero reflection... everywhere
197. The Future • Zero reflection... everywhere • Death to injects list
198. The Future • Zero reflection... everywhere • Death to injects list • Components encapsulate dependencies
199. The Future • Zero reflection... everywhere • Death to injects list • Components encapsulate dependencies • Scopes with dedicated annotations
200. The Future • Zero reflection... everywhere • Death to injects list • Components encapsulate dependencies • Scopes with dedicated annotations • http://squ.re/dagger2
201. http://square.github.io/dagger/
203. Questions?
204. squareup.com/careers