Making Retrofit Work For You (SV DevFest 2016)

Retrofit's recently-released version 2 is the easiest way to do HTTP in your applications. Once set up, Retrofit is designed to make declaring endpoints as simple as a method on an interface with annotations. Behind that simplicity, though, there is a lot of power and knowing how to use and configure it can make even the most problematic APIs easy to use.

This talk will focus on configuring three parts of Retrofit:

* Endpoint declarations on interfaces which define how requests are created and sent and how their responses are read and parsed.

* Serialization customization that goes beyond just choosing between JSON or Protocol Buffers.

* Execution mechanisms which enable synchronous or asynchronous requests, integration with third-party libraries, and custom error handling.

You will not need prior Retrofit experience, although the focus will specifically be on configuring and customizing its behavior.

Transcript

1. Making Retrofit Work For You Jake Wharton
2. Retrofit interface ApiService { }A
3. Retrofit interface ApiService { List<User> search( String query, SortOrder order); }A
4. Retrofit interface ApiService { List<User> search( String query, SortOrder order); }A class HttpApiService implements ApiService { // ... }
5. Retrofit interface ApiService { List<User> search( String query, SortOrder order); }A
6. Retrofit interface ApiService { @GET("/search") List<User> search( String query, SortOrder order); }A
7. Retrofit interface ApiService { @GET("/search") List<User> search( @Query("q") String query, SortOrder order); }A
8. Retrofit interface ApiService { @GET("/search")Z List<User> search( @Query("q") String query, @Query("sort") SortOrder order); }A
9. Retrofit interface ApiService { @GET("/search")Z Call<List<User>> search( @Query("q") String query, @Query("sort") SortOrder order); }A
10. Retrofit interface ApiService { @GET("/search/{category}")Z Call<List<User>> search( @Path("category") String category, @Query("q") String query, @Query("sort") SortOrder order); }A
11. Retrofit interface ApiService { @GET("/search/{category}") Call<List<User>> search( @Path("category") String category, @Query("q") String query, @Query("sort") SortOrder order); @POST("/upload/image") Call<Void> uploadImage( @Body Image image); }A
12. Retrofit interface ApiService { @GET("/search/{category}") Call<List<User>> search( @Path("category") String category, @Query("q") String query, @Query("sort") SortOrder order); @POST("/upload/image") @Headers("SomeHeader: SomeValue") Call<Void> uploadImage( @Body Image image); }A
13. Retrofit interface ApiService { // ... }A
14. Retrofit interface ApiService { // ... }A Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com")
 .build();
15. Retrofit interface ApiService { // ... }A Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com")
 .build(); ApiService service = retrofit.create(ApiService.class);
16. Retrofit interface ApiService { // ... }A Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com")
 .build(); ApiService service = retrofit.create(ApiService.class);
17. HTTP Client Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com")
 .build();
18. HTTP Client Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com")
 .build(); Foo foo = retrofit.create(Foo.class);
19. HTTP Client Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com")
 .build(); Foo foo = retrofit.create(Foo.class); Bar bar = retrofit.create(Bar.class);
20. HTTP Client Retrofit retrofitFoo = new Retrofit.Builder()
 .baseUrl("http://foo.example.com")
 .build(); Foo foo = retrofitFoo.create(Foo.class); Retrofit retrofitBar = new Retrofit.Builder()
 .baseUrl("http://bar.example.com")
 .build(); Bar bar = retrofitBar.create(Bar.class);
21. HTTP Client Retrofit retrofitFoo = new Retrofit.Builder()
 .baseUrl("http://foo.example.com") .client(new OkHttpClient())
 .build(); Foo foo = retrofitFoo.create(Foo.class); Retrofit retrofitBar = new Retrofit.Builder()
 .baseUrl("http://bar.example.com") .client(new OkHttpClient())
 .build(); Bar bar = retrofitBar.create(Bar.class);
22. HTTP Client Retrofit retrofitFoo = new Retrofit.Builder()
 .baseUrl("http://foo.example.com") .client(new OkHttpClient())
 .build(); Foo foo = retrofitFoo.create(Foo.class); Retrofit retrofitBar = new Retrofit.Builder()
 .baseUrl("http://bar.example.com") .client(new OkHttpClient())
 .build(); Bar bar = retrofitBar.create(Bar.class); OkHttpClient client =
23. HTTP Client OkHttpClient client = new OkHttpClient(); Retrofit retrofitFoo = new Retrofit.Builder()
 .baseUrl("http://foo.example.com") .client(client)
 .build(); Foo foo = retrofitFoo.create(Foo.class); Retrofit retrofitBar = new Retrofit.Builder()
 .baseUrl("http://bar.example.com") .client(client)
 .build(); Bar bar = retrofitBar.create(Bar.class); new OkHttpClient()
24. HTTP Client OkHttpClient client = new OkHttpClient(); Retrofit retrofitFoo = new Retrofit.Builder()
 .baseUrl("http://foo.example.com") .client(client)
 .build(); Foo foo = retrofitFoo.create(Foo.class); Retrofit retrofitBar = new Retrofit.Builder()
 .baseUrl("http://bar.example.com") .client(client)
 .build(); Bar bar = retrofitBar.create(Bar.class);
25. HTTP Client OkHttpClient client = new OkHttpClient();
26. HTTP Client OkHttpClient client = new OkHttpClient(); OkHttpClient clientFoo = client.newBuilder() .addInterceptor(new FooInterceptor()) .build();
27. HTTP Client OkHttpClient client = new OkHttpClient(); OkHttpClient clientFoo = client.newBuilder() .addInterceptor(new FooInterceptor()) .build(); OkHttpClient clientBar = client.newBuilder() .readTimeout(30, SECONDS) .writeTimeout(30, SECONDS) .build();
28. HTTP Client interface Service {
 @GET("/user")
 Call<User> user();
 
 @POST("/login")
 Call<User> login(@Body LoginRequest request);
 @GET("/logout")
 Call<Void> logout();
 }X
29. HTTP Client interface Service {
 @GET("/user") // Requires authentication.
 Call<User> user();
 
 @POST("/login") // Does not require authentication.
 Call<User> login(@Body LoginRequest request);
 @GET("/logout") // Requires authentication.
 Call<Void> logout();
 }X
30. HTTP Client class ServiceInterceptor implements Interceptor {
 @Override public Response intercept(Chain chain) {
 Request request = chain.request();
 return chain.proceed(request);
 }B
 }A
31. HTTP Client class ServiceInterceptor implements Interceptor {
 @Override public Response intercept(Chain chain) {
 Request request = chain.request(); 
 if (!request.url().encodedPath().equals("/login")) {
 request = request.newBuilder()
 .addHeader("Authorization", "hunter2")
 .build();
 } 
 return chain.proceed(request);
 }B
 }A
32. HTTP Client class ServiceInterceptor implements Interceptor {
 @Override public Response intercept(Chain chain) {
 Request request = chain.request(); 
 if (!request.url().encodedPath().equals("/login")) {
 request = request.newBuilder()
 .addHeader("Authorization", "hunter2")
 .build();
 } 
 return chain.proceed(request);
 }
 }
33. HTTP Client interface Service {
 @GET("/user") // Requires authentication.
 Call<User> user();
 
 @POST("/login") // Does not require authentication.
 Call<User> login(@Body LoginRequest request);
 @GET("/logout") // Requires authentication.
 Call<Void> logout();
 }X
34. HTTP Client interface Service {
 @GET("/user") // Requires authentication.
 Call<User> user();
 
 @POST("/login") // Does not require authentication.
 Call<User> login(@Body LoginRequest request);
 
 @POST("/forgotPassword") // Does not require authentication.
 Call<Void> forgotPassword(@Body ForgotPasswordRequest request);
 @GET("/logout") // Requires authentication.
 Call<Void> logout();
 }X
35. HTTP Client interface Service {
 @GET("/user") // Requires authentication.
 Call<User> user();
 
 @POST("/login") // Does not require authentication.
 Call<User> login(@Body LoginRequest request);
 
 @POST("/forgotPassword") // Does not require authentication.
 Call<Void> forgotPassword(@Body ForgotPasswordRequest request);
 @GET("/logout") // Requires authentication.
 Call<Void> logout();
 }X class ServiceInterceptor implements Interceptor {
 @Override public Response intercept(Chain chain) {
 Request request = chain.request(); 
 if (!request.url().encodedPath().equals("/login")) {
 request = request.newBuilder()
 .addHeader("Authorization", "hunter2")
 .build();
 } 
 return chain.proceed(request);
 }
 }
36. HTTP Client interface Service {
 @GET("/user") // Requires authentication.
 Call<User> user();
 
 @POST("/login") // Does not require authentication.
 Call<User> login(@Body LoginRequest request);
 
 @POST("/forgotPassword") // Does not require authentication.
 Call<Void> forgotPassword(@Body ForgotPasswordRequest request);
 @GET("/logout") // Requires authentication.
 Call<Void> logout();
 }X
37. HTTP Client interface Service {
 @GET("/user")
 Call<User> user();
 
 @POST("/login") // Does not require authentication.
 Call<User> login(@Body LoginRequest request);
 
 @POST("/forgotPassword") // Does not require authentication.
 Call<Void> forgotPassword(@Body ForgotPasswordRequest request);
 @GET("/logout")
 Call<Void> logout();
 }X
38. HTTP Client interface Service {
 @GET("/user")
 Call<User> user();
 
 @POST("/login") @Headers("No-Authentication: true")
 Call<User> login(@Body LoginRequest request);
 
 @POST("/forgotPassword") @Headers("No-Authentication: true")
 Call<Void> forgotPassword(@Body ForgotPasswordRequest request);
 @GET("/logout")
 Call<Void> logout();
 }X 
 
 
 
 // Does not require authentication. 
 
 
 // Does not require authentication.
39. HTTP Client interface Service {
 @GET("/user")
 Call<User> user();
 
 @POST("/login") @Headers("No-Authentication: true")
 Call<User> login(@Body LoginRequest request);
 
 @POST("/forgotPassword") @Headers("No-Authentication: true")
 Call<Void> forgotPassword(@Body ForgotPasswordRequest request);
 @GET("/logout")
 Call<Void> logout();
 }X 
 
 
 
 // Does not require authentication. 
 
 
 // Does not require authentication.
40. HTTP Client class ServiceInterceptor implements Interceptor {
 @Override public Response intercept(Chain chain) {
 Request request = chain.request(); 
 if (!request.url().encodedPath().equals("/login")) {
 request = request.newBuilder()
 .addHeader("Authorization", "hunter2")
 .build();
 }C 
 return chain.proceed(request);
 }B
 }A
41. HTTP Client class ServiceInterceptor implements Interceptor {
 @Override public Response intercept(Chain chain) {
 Request request = chain.request(); 
 if (request.header("No-Authentication") == null) {
 request = request.newBuilder()
 .addHeader("Authorization", "hunter2")
 .build();
 }C 
 return chain.proceed(request);
 }B
 }A 
 
 
 ! url().encodedPath().equals("/login")
42. HTTP Client class ServiceInterceptor implements Interceptor {
 @Override public Response intercept(Chain chain) {
 Request request = chain.request(); 
 if (request.header("No-Authentication") == null) {
 request = request.newBuilder()
 .addHeader("Authorization", "hunter2")
 .build();
 }C 
 return chain.proceed(request);
 }B
 }A
43. Converters
44. Converters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com")
 .build();
45. Converters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com")
 .build(); interface Service {
 @GET("/user")
 Call<ResponseBody> user();
 }X
46. Converters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com")
 .addConverterFactory(GsonConverterFactory.create())
 .build(); interface Service {
 @GET("/user")
 Call<ResponseBody> user();
 }X
47. Converters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com")
 .addConverterFactory(GsonConverterFactory.create())
 .build(); interface Service {
 @GET("/user")
 Call<ResponseBody> user();
 }X
48. Converters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com")
 .addConverterFactory(GsonConverterFactory.create())
 .build(); interface Service {
 @GET("/user")
 Call<User> user();
 }X 
 
 
 
 
 ResponseBody

49. Converters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com")
 .addConverterFactory(GsonConverterFactory.create())
 .build(); interface Service {
 @GET("/user")
 Call<User> user();
 }X
50. Converters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com")
 .addConverterFactory(GsonConverterFactory.create())
 .build();
51. Converters Retrofit retrofitFoo = new Retrofit.Builder()
 .baseUrl("http://foo.example.com")
 .addConverterFactory(GsonConverterFactory.create())
 .build(); Retrofit retrofitBar = new Retrofit.Builder()
 .baseUrl("http://bar.example.com")
 .addConverterFactory(GsonConverterFactory.create())
 .build();
52. Converters Retrofit retrofitFoo = new Retrofit.Builder()
 .baseUrl("http://foo.example.com")
 .addConverterFactory(GsonConverterFactory.create())
 .build(); Retrofit retrofitBar = new Retrofit.Builder()
 .baseUrl("http://bar.example.com")
 .addConverterFactory(GsonConverterFactory.create())
 .build();
53. Converters Retrofit retrofitFoo = new Retrofit.Builder()
 .baseUrl("http://foo.example.com")
 .addConverterFactory(GsonConverterFactory.create())A
 .build(); Retrofit retrofitBar = new Retrofit.Builder()
 .baseUrl("http://bar.example.com")
 .addConverterFactory(GsonConverterFactory.create())B
 .build();
54. Converters GsonConverterFactory gsonFactory = GsonConverterFactory.create(); Retrofit retrofitFoo = new Retrofit.Builder()
 .baseUrl("http://foo.example.com")
 .addConverterFactory(gsonFactory)A
 .build(); Retrofit retrofitBar = new Retrofit.Builder()
 .baseUrl("http://bar.example.com")
 .addConverterFactory(gsonFactory)B
 .build(); GsonConverterFactory.create()
55. Converters GsonConverterFactory gsonFactory = GsonConverterFactory.create(); Retrofit retrofitFoo = new Retrofit.Builder()
 .baseUrl("http://foo.example.com")
 .addConverterFactory(gsonFactory)
 .build(); Retrofit retrofitBar = new Retrofit.Builder()
 .baseUrl("http://bar.example.com")
 .addConverterFactory(gsonFactory)
 .build();
56. Converters Gson gson = new Gson(); GsonConverterFactory gsonFactory = GsonConverterFactory.create(gson); Retrofit retrofitFoo = new Retrofit.Builder()
 .baseUrl("http://foo.example.com")
 .addConverterFactory(gsonFactory)
 .build(); Retrofit retrofitBar = new Retrofit.Builder()
 .baseUrl("http://bar.example.com")
 .addConverterFactory(gsonFactory)
 .build();
57. Converters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com")
 .addConverterFactory(GsonConverterFactory.create())
 .build(); interface Service {
 @GET("/user")
 Call<User> user();
 }X
58. Converters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com")
 .addConverterFactory(GsonConverterFactory.create())
 .build(); interface Service {
 @GET("/user")
 Call<User> user(); 
 @GET("/friends")
 Call<Friends> friends();
 }X
59. Converters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com")
 .addConverterFactory(GsonConverterFactory.create())
 .build(); interface Service {
 @GET("/user")
 Call<User> user(); // <-- proto 
 @GET("/friends")
 Call<Friends> friends(); // <-- json
 }X
60. Converters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addConverterFactory(ProtoConverterFactory.create())
 .addConverterFactory(GsonConverterFactory.create())
 .build(); interface Service {
 @GET("/user")
 Call<User> user(); // <-- proto 
 @GET("/friends")
 Call<Friends> friends(); // <-- json
 }X
61. Converters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addConverterFactory(ProtoConverterFactory.create())
 .addConverterFactory(GsonConverterFactory.create())
 .build(); interface Service {
 @GET("/user")
 Call<User> user(); 
 @GET("/friends")
 Call<Friends> friends();
 }X
62. Converters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addConverterFactory(ProtoConverterFactory.create())
 .addConverterFactory(GsonConverterFactory.create())
 .build(); interface Service {
 @GET("/user")
 Call<User> user(); 
 @GET("/friends")
 Call<Friends> friends();
 }X
63. Converters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addConverterFactory(ProtoConverterFactory.create()) User ?
 .addConverterFactory(GsonConverterFactory.create())
 .build(); interface Service {
 @GET("/user")
 Call<User> user(); 
 @GET("/friends")
 Call<Friends> friends();
 }X
64. Converters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addConverterFactory(ProtoConverterFactory.create()) User ✓
 .addConverterFactory(GsonConverterFactory.create())
 .build(); interface Service {
 @GET("/user")
 Call<User> user(); 
 @GET("/friends")
 Call<Friends> friends();
 }X
65. Converters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addConverterFactory(ProtoConverterFactory.create())
 .addConverterFactory(GsonConverterFactory.create())
 .build(); interface Service {
 @GET("/user")
 Call<User> user(); 
 @GET("/friends")
 Call<Friends> friends();
 }X
66. Converters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addConverterFactory(ProtoConverterFactory.create())
 .addConverterFactory(GsonConverterFactory.create())
 .build(); interface Service {
 @GET("/user")
 Call<User> user(); 
 @GET("/friends")
 Call<Friends> friends();
 }X
67. Converters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addConverterFactory(ProtoConverterFactory.create())
 .addConverterFactory(GsonConverterFactory.create())
 .build(); interface Service {
 @GET("/user")
 Call<User> user(); 
 @GET("/friends")
 Call<Friends> friends();
 }X
68. Converters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addConverterFactory(ProtoConverterFactory.create()) Friends ?
 .addConverterFactory(GsonConverterFactory.create())
 .build(); interface Service {
 @GET("/user")
 Call<User> user(); 
 @GET("/friends")
 Call<Friends> friends();
 }X
69. Converters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addConverterFactory(ProtoConverterFactory.create()) Friends ✗
 .addConverterFactory(GsonConverterFactory.create())
 .build(); interface Service {
 @GET("/user")
 Call<User> user(); 
 @GET("/friends")
 Call<Friends> friends();
 }X
70. Converters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addConverterFactory(ProtoConverterFactory.create()) Friends ✗
 .addConverterFactory(GsonConverterFactory.create()) 
 .build(); interface Service {
 @GET("/user")
 Call<User> user(); 
 @GET("/friends")
 Call<Friends> friends();
 }X
71. Converters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addConverterFactory(ProtoConverterFactory.create()) Friends ✗
 .addConverterFactory(GsonConverterFactory.create()) Friends ?
 .build(); interface Service {
 @GET("/user")
 Call<User> user(); 
 @GET("/friends")
 Call<Friends> friends();
 }X
72. Converters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addConverterFactory(ProtoConverterFactory.create()) Friends ✗
 .addConverterFactory(GsonConverterFactory.create()) Friends ✓
 .build(); interface Service {
 @GET("/user")
 Call<User> user(); 
 @GET("/friends")
 Call<Friends> friends();
 }X
73. Converters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addConverterFactory(ProtoConverterFactory.create())
 .addConverterFactory(GsonConverterFactory.create())
 .build(); interface Service {
 @GET("/user")
 Call<User> user(); 
 @GET("/friends")
 Call<Friends> friends();
 }X
74. Converters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com")
 .addConverterFactory(GsonConverterFactory.create()) .addConverterFactory(ProtoConverterFactory.create())
 .build(); interface Service {
 @GET("/user")
 Call<User> user(); 
 @GET("/friends")
 Call<Friends> friends();
 }X
75. Converters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com")
 .addConverterFactory(GsonConverterFactory.create()) .addConverterFactory(ProtoConverterFactory.create()) // No!
 .build(); interface Service {
 @GET("/user")
 Call<User> user(); 
 @GET("/friends")
 Call<Friends> friends();
 }X
76. Converters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addConverterFactory(ProtoConverterFactory.create())
 .addConverterFactory(GsonConverterFactory.create())
 .build(); interface Service {
 @GET("/user")
 Call<User> user(); 
 @GET("/friends")
 Call<Friends> friends();
 }X
77. Converters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addConverterFactory(ProtoConverterFactory.create())
 .addConverterFactory(GsonConverterFactory.create())
 .build(); interface Service {
 @GET("/user")
 Call<User> user(); // <-- proto 
 @GET("/friends")
 Call<Friends> friends(); // <-- json
 }X
78. Converters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addConverterFactory(ProtoConverterFactory.create())
 .addConverterFactory(GsonConverterFactory.create())
 .build(); interface Service {
 @GET("/user")
 Call<User> user(); // <-- xml 
 @GET("/friends")
 Call<Friends> friends(); // <-- json
 }X
79. Converters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addConverterFactory(SimpleXmlConverterFactory.create())
 .addConverterFactory(GsonConverterFactory.create())
 .build(); interface Service {
 @GET("/user")
 Call<User> user(); // <-- xml 
 @GET("/friends")
 Call<Friends> friends(); // <-- json
 }X
80. Converters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addConverterFactory(SimpleXmlConverterFactory.create())
 .addConverterFactory(GsonConverterFactory.create())
 .build(); interface Service {
 @GET("/user")
 Call<User> user(); // <-- xml 
 @GET("/friends")
 Call<Friends> friends(); // <-- json
 }X
81. Converters interface Service {
 @GET("/user")
 Call<User> user(); // <-- xml 
 @GET("/friends")
 Call<Friends> friends(); // <-- json
 }X
82. Converters interface Service {
 @GET("/user")
 Call<User> user(); // <-- xml 
 @GET("/friends")
 Call<Friends> friends(); // <-- json
 }X @interface Xml {}
83. Converters interface Service {
 @GET("/user")
 Call<User> user(); // <-- xml 
 @GET("/friends")
 Call<Friends> friends(); // <-- json
 }X @interface Xml {} @interface Json {}
84. Converters interface Service {
 @GET("/user") @Xml
 Call<User> user(); // <-- xml 
 @GET("/friends") @Json
 Call<Friends> friends(); // <-- json
 }X @interface Xml {} @interface Json {}
85. Converters interface Service {
 @GET("/user") @Xml
 Call<User> user(); // <-- xml 
 @GET("/friends") @Json
 Call<Friends> friends(); // <-- json
 }X @interface Xml {} @interface Json {}
86. Converters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addConverterFactory(SimpleXmlConverterFactory.create())X
 .addConverterFactory(GsonConverterFactory.create())
 .build();
87. Converters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addConverterFactory(new XmlOrJsonConverterFactory())X
 .build(); 
 SimpleXmlConverterFactory.create() 
 .addConverterFactory(GsonConverterFactory.create())
88. Converters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addConverterFactory(new XmlOrJsonConverterFactory())X
 .build();
89. Converters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addConverterFactory(new XmlOrJsonConverterFactory())X
 .build(); class XmlOrJsonConverterFactory extends Converter.Factory { }G
90. Converters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addConverterFactory(new XmlOrJsonConverterFactory())X
 .build(); class XmlOrJsonConverterFactory extends Converter.Factory { final Converter.Factory xml = SimpleXmlConverterFactory.create(); }G
91. Converters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addConverterFactory(new XmlOrJsonConverterFactory())X
 .build(); class XmlOrJsonConverterFactory extends Converter.Factory { final Converter.Factory xml = SimpleXmlConverterFactory.create(); final Converter.Factory json = GsonConverterFactory.create(); }G
92. Converters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addConverterFactory(new XmlOrJsonConverterFactory())X
 .build(); class XmlOrJsonConverterFactory extends Converter.Factory { final Converter.Factory xml = SimpleXmlConverterFactory.create(); final Converter.Factory json = GsonConverterFactory.create(); @Override public Converter<ResponseBody, ?> responseBodyConverter() { }V }G
93. Converters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addConverterFactory(new XmlOrJsonConverterFactory())X
 .build(); class XmlOrJsonConverterFactory extends Converter.Factory { final Converter.Factory xml = SimpleXmlConverterFactory.create(); final Converter.Factory json = GsonConverterFactory.create(); @Override public Converter<ResponseBody, ?> responseBodyConverter( Type type, Annotation[] annotations, Retrofit retrofit) { }V }G
94. Converters class XmlOrJsonConverterFactory extends Converter.Factory { final Converter.Factory xml = SimpleXmlConverterFactory.create(); final Converter.Factory json = GsonConverterFactory.create(); @Override public Converter<ResponseBody, ?> responseBodyConverter( Type type, Annotation[] annotations, Retrofit retrofit) { }V }G
95. Converters class XmlOrJsonConverterFactory extends Converter.Factory { final Converter.Factory xml = SimpleXmlConverterFactory.create(); final Converter.Factory json = GsonConverterFactory.create(); @Override public Converter<ResponseBody, ?> responseBodyConverter( Type type, Annotation[] annotations, Retrofit retrofit) { }V }G
96. Converters class XmlOrJsonConverterFactory extends Converter.Factory { final Converter.Factory xml = SimpleXmlConverterFactory.create(); final Converter.Factory json = GsonConverterFactory.create(); @Override public Converter<ResponseBody, ?> responseBodyConverter( Type type, Annotation[] annotations, Retrofit retrofit) { for (Annotation annotation : annotations) { }F }V }G
97. Converters class XmlOrJsonConverterFactory extends Converter.Factory { final Converter.Factory xml = SimpleXmlConverterFactory.create(); final Converter.Factory json = GsonConverterFactory.create(); @Override public Converter<ResponseBody, ?> responseBodyConverter( Type type, Annotation[] annotations, Retrofit retrofit) { for (Annotation annotation : annotations) { if (annotation.getClass() == Xml.class) { }I }F }V }G
98. Converters class XmlOrJsonConverterFactory extends Converter.Factory { final Converter.Factory xml = SimpleXmlConverterFactory.create(); final Converter.Factory json = GsonConverterFactory.create(); @Override public Converter<ResponseBody, ?> responseBodyConverter( Type type, Annotation[] annotations, Retrofit retrofit) { for (Annotation annotation : annotations) { if (annotation.getClass() == Xml.class) { return xml.responseBodyConverter(type, annotations, retrofit); }I }F }V }G
99. Converters class XmlOrJsonConverterFactory extends Converter.Factory { final Converter.Factory xml = SimpleXmlConverterFactory.create(); final Converter.Factory json = GsonConverterFactory.create(); @Override public Converter<ResponseBody, ?> responseBodyConverter( Type type, Annotation[] annotations, Retrofit retrofit) { for (Annotation annotation : annotations) { if (annotation.getClass() == Xml.class) { return xml.responseBodyConverter(type, annotations, retrofit); }I if (annotation.getClass() == Json.class) { return json.responseBodyConverter(type, annotations, retrofit); }I }F }V }G
100. Converters class XmlOrJsonConverterFactory extends Converter.Factory { final Converter.Factory xml = SimpleXmlConverterFactory.create(); final Converter.Factory json = GsonConverterFactory.create(); @Override public Converter<ResponseBody, ?> responseBodyConverter( Type type, Annotation[] annotations, Retrofit retrofit) { for (Annotation annotation : annotations) { if (annotation.getClass() == Xml.class) { return xml.responseBodyConverter(type, annotations, retrofit); }I if (annotation.getClass() == Json.class) { return json.responseBodyConverter(type, annotations, retrofit); }I }F return null; }V }G
101. Converters class AnnotatedConverterFactory extends Converter.Factory { final Map<Class<?>, Converter.Factory> factories; AnnotationConverterFactory(Map<Class<?>, Converter.Factory> factories) { this.factories = new LinkedHashMap<>(factories); } @Override public Converter<ResponseBody, ?> responseBodyConverter( Type type, Annotation[] annotations, Retrofit retrofit) { for (Annotation annotation : annotations) { Converter.Factory factory = factories.get(annotation.getClass()); if (factory != null) { return factory.responseBodyConverter(type, annotations, retrofit); }I }F return null; }V }G
102. Converters class AnnotatedConverterFactory extends Converter.Factory { // ... }G
103. Converters class AnnotatedConverterFactory extends Converter.Factory { // ... class Builder { final Map<Class<?>, Converter.Factory> factories = new LinkedHashMap<>(); Builder add(Class<? extends Annotation> cls, Converter.Factory factory) { if (cls == null) throw new NullPointerException("cls == null"); if (factory == null) throw new NullPointerException("factory == null"); factories.add(cls, factory); return this; } AnnotationConverterFactory build() { return new AnnotatedConverterFactory(factories); } }G
104. Converters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addConverterFactory(new XmlOrJsonConverterFactory())X
 .build();
105. Converters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addConverterFactory(AnnotatedConverterFactory.builder() .add(Xml.class, SimpleXmlConverterFactory.create()) .add(Json.class, GsonConverterFactory.create()) .build())X
 .addConverterFactory(GsonConverterFactory.create())
 .build(); 
 new XmlOrJsonConverterFactory()
106. Converters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com")
 .addConverterFactory(GsonConverterFactory.create())
 .build(); interface Service {
 @GET("/user")
 Call<User> user();
 }X
107. Converters {X "id": "1345235987", "name": "Shrek", "location": "Swamp" }X
108. Converters {Y "meta": { "code": 200, "time": 287, }, "notifications": {}, "response": {X "id": "1345235987", "name": "Shrek", "location": "Swamp" }X }Y
109. Converters {Y "meta": { "code": 200, "time": 287, }, "notifications": {}, "response": {X "id": "1345235987", "name": "Shrek", "location": "Swamp" }X }Y
110. Converters {Y "meta": { "code": 200, "time": 287, }, "notifications": {}, "response": {X "id": "1345235987", "name": "Shrek", "location": "Swamp" }X }Y
111. Converters {Y "meta": { "code": 200, "time": 287, }, "notifications": {}, "response": {X "id": "1345235987", "name": "Shrek", "location": "Swamp" }X }Y
112. Converters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com")
 .addConverterFactory(GsonConverterFactory.create())
 .build(); interface Service {
 @GET("/user")
 Call<User> user();
 }X
113. Converters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com")
 .addConverterFactory(GsonConverterFactory.create())
 .build(); interface Service {
 @GET("/user")
 Call<User> user();
 }X class Envelope<T> { Meta meta; List<Notification> notifications; T response; }Z
114. Converters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com")
 .addConverterFactory(GsonConverterFactory.create())
 .build(); interface Service {
 @GET("/user")
 Call<Envelope<User>> user();
 }X class Envelope<T> { Meta meta; List<Notification> notifications; T response; }Z
115. Converters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com")
 .addConverterFactory(GsonConverterFactory.create())
 .build(); interface Service {
 @GET("/user")
 Call<Envelope<User>> user();
 }X class Envelope<T> { Meta meta; List<Notification> notifications; T response; }Z
116. Converters class EnvelopingConverter extends Converter.Factory { @Override public Converter<ResponseBody, ?> responseBodyConverter( Type type, Annotation[] annotations, Retrofit retrofit) { }B }A
117. Converters class EnvelopingConverter extends Converter.Factory { @Override public Converter<ResponseBody, ?> responseBodyConverter( Type type, Annotation[] annotations, Retrofit retrofit) { }B }A
118. Converters class EnvelopingConverter extends Converter.Factory { @Override public Converter<ResponseBody, ?> responseBodyConverter( Type type, Annotation[] annotations, Retrofit retrofit) { }B }A
119. Converters class EnvelopingConverter extends Converter.Factory { @Override public Converter<ResponseBody, ?> responseBodyConverter( Type type, Annotation[] annotations, Retrofit retrofit) { }B }A
120. Converters class EnvelopingConverter extends Converter.Factory { @Override public Converter<ResponseBody, ?> responseBodyConverter( Type type, Annotation[] annotations, Retrofit retrofit) { type = // Envelope.class parameterized with type }B }A
121. Converters class EnvelopingConverter extends Converter.Factory { @Override public Converter<ResponseBody, ?> responseBodyConverter( Type type, Annotation[] annotations, Retrofit retrofit) { type = TypeToken.getParameterized(Envelope.class, type).getType(); }B }A // Envelope.class parameterized with type
122. Converters class EnvelopingConverter extends Converter.Factory { @Override public Converter<ResponseBody, ?> responseBodyConverter( Type type, Annotation[] annotations, Retrofit retrofit) { type = TypeToken.getParameterized(Envelope.class, type).getType(); Converter<ResponseBody, Envelope<?>> delegate = retrofit.nextResponseBodyConverter(this, type, annotations); }B }A
123. Converters class EnvelopingConverter extends Converter.Factory { @Override public Converter<ResponseBody, ?> responseBodyConverter( Type type, Annotation[] annotations, Retrofit retrofit) { type = TypeToken.getParameterized(Envelope.class, type).getType(); Converter<ResponseBody, Envelope<?>> delegate = retrofit.nextResponseBodyConverter(this, type, annotations); return new Converter<ResponseBody, ?>() { }; }B }A
124. Converters class EnvelopingConverter extends Converter.Factory { @Override public Converter<ResponseBody, ?> responseBodyConverter( Type type, Annotation[] annotations, Retrofit retrofit) { type = TypeToken.getParameterized(Envelope.class, type).getType(); Converter<ResponseBody, Envelope<?>> delegate = retrofit.nextResponseBodyConverter(this, type, annotations); return new Converter<ResponseBody, ?>() { @Override public Object convert(ResponseBody body) { } }; }B }A
125. Converters class EnvelopingConverter extends Converter.Factory { @Override public Converter<ResponseBody, ?> responseBodyConverter( Type type, Annotation[] annotations, Retrofit retrofit) { type = TypeToken.getParameterized(Envelope.class, type).getType(); final Converter<ResponseBody, Envelope<?>> delegate = retrofit.nextResponseBodyConverter(this, type, annotations); return new Converter<ResponseBody, ?>() { @Override public Object convert(ResponseBody body) { Envelope<?> envelope = delegate.convert(body); }B }; }B }A
126. Converters class EnvelopingConverter extends Converter.Factory { @Override public Converter<ResponseBody, ?> responseBodyConverter( Type type, Annotation[] annotations, Retrofit retrofit) { type = TypeToken.getParameterized(Envelope.class, type).getType(); final Converter<ResponseBody, Envelope<?>> delegate = retrofit.nextResponseBodyConverter(this, type, annotations); return new Converter<ResponseBody, ?>() { @Override public Object convert(ResponseBody body) { Envelope<?> envelope = delegate.convert(body); return envelope.response; }B }; }B }A
127. Converters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com")
 .addConverterFactory(GsonConverterFactory.create())
 .build(); interface Service {
 @GET("/user")
 Call<Envelope<User>> user();
 }X class Envelope<T> { Meta meta; List<Notification> notifications; T response; }Z
128. Converters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addConverterFactory(new EnvelopingConverter())
 .addConverterFactory(GsonConverterFactory.create())
 .build(); interface Service {
 @GET("/user")
 Call<Envelope<User>> user();
 }X class Envelope<T> { Meta meta; List<Notification> notifications; T response; }Z
129. Converters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addConverterFactory(new EnvelopingConverter())
 .addConverterFactory(GsonConverterFactory.create())
 .build(); interface Service {
 @GET("/user")
 Call<User> user();
 }X class Envelope<T> { Meta meta; List<Notification> notifications; T response; }Z
130. Converters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addConverterFactory(new EnvelopingConverter())
 .addConverterFactory(GsonConverterFactory.create())
 .build(); interface Service {
 @GET("/user")
 Call<User> user();
 }X class Envelope<T> { Meta meta; List<Notification> notifications; T response; }Z
131. Converters class EnvelopingConverter extends Converter.Factory { @Override public Converter<ResponseBody, ?> responseBodyConverter( Type type, Annotation[] annotations, Retrofit retrofit) { type = TypeToken.getParameterized(Envelope.class, type).getType(); final Converter<ResponseBody, Envelope<?>> delegate = retrofit.nextResponseBodyConverter(this, type, annotations); return new Converter<ResponseBody, ?>() { @Override public Object convert(ResponseBody body) { Envelope<?> envelope = delegate.convert(body); return envelope.response; }B }; }B }A
132. Converters class EnvelopingConverter extends Converter.Factory { @Override public Converter<ResponseBody, ?> responseBodyConverter( Type type, Annotation[] annotations, Retrofit retrofit) { type = TypeToken.getParameterized(Envelope.class, type).getType(); final Converter<ResponseBody, Envelope<?>> delegate = retrofit.nextResponseBodyConverter(this, type, annotations); return new Converter<ResponseBody, ?>() { @Override public Object convert(ResponseBody body) { Envelope<?> envelope = delegate.convert(body); // Handle notifications, record timing information. return envelope.response; }B }; }B }A
133. Converters class EmptyToNullConverter extends Converter.Factory { @Override public Converter<ResponseBody, ?> responseBodyConverter( Type type, Annotation[] annotations, Retrofit retrofit) { }B }A
134. Converters class EmptyToNullConverter extends Converter.Factory { @Override public Converter<ResponseBody, ?> responseBodyConverter( Type type, Annotation[] annotations, Retrofit retrofit) { Converter<ResponseBody, ?> delegate = retrofit.nextResponseBodyConverter(this, type, annotations); }B }A
135. Converters class EmptyToNullConverter extends Converter.Factory { @Override public Converter<ResponseBody, ?> responseBodyConverter( Type type, Annotation[] annotations, Retrofit retrofit) { Converter<ResponseBody, ?> delegate = retrofit.nextResponseBodyConverter(this, type, annotations); return new Converter<ResponseBody, ?>() { @Override public Object convert(ResponseBody body) { }G }; }B }A
136. Converters class EmptyToNullConverter extends Converter.Factory { @Override public Converter<ResponseBody, ?> responseBodyConverter( Type type, Annotation[] annotations, Retrofit retrofit) { Converter<ResponseBody, ?> delegate = retrofit.nextResponseBodyConverter(this, type, annotations); return new Converter<ResponseBody, ?>() { @Override public Object convert(ResponseBody body) { if (body.contentLength() == 0) return null; }G }; }B }A
137. Converters class EmptyToNullConverter extends Converter.Factory { @Override public Converter<ResponseBody, ?> responseBodyConverter( Type type, Annotation[] annotations, Retrofit retrofit) { final Converter<ResponseBody, ?> delegate = retrofit.nextResponseBodyConverter(this, type, annotations); return new Converter<ResponseBody, ?>() { @Override public Object convert(ResponseBody body) { if (body.contentLength() == 0) return null; return delegate.convert(body); }G }; }B }A
138. Converters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addConverterFactory(new EnvelopingConverter())
 .addConverterFactory(GsonConverterFactory.create())
 .build(); interface Service {
 @GET("/user")
 Call<User> user();
 }X class Envelope<T> { Meta meta; List<Notification> notifications; T response; }Z
139. Converters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addConverterFactory(new EmptyToNullConverter()) .addConverterFactory(new EnvelopingConverter())
 .addConverterFactory(GsonConverterFactory.create())
 .build(); interface Service {
 @GET("/user")
 Call<User> user();
 }X class Envelope<T> { Meta meta; List<Notification> notifications; T response; }Z
140. Converters
141. Converters interface DribbbleSearchService { @GET("search") Call<List<Shot>> search(@Query("q") String query, @Query("page") Integer page, @Query("per_page") Integer pageSize, @Query("s") @SortOrder String sort); }
142. Converters interface DribbbleSearchService { @GET("search") Call<List<Shot>> search(@Query("q") String query, @Query("page") Integer page, @Query("per_page") Integer pageSize, @Query("s") @SortOrder String sort); }
143. Converters /** * Dribbble API does not have a search endpoint so we have * to do gross things :( */ class DribbbleSearchConverter { // ... }
144. Converters /** * Dribbble API does not have a search endpoint so we have * to do gross things :( */ class DribbbleSearchConverter { // ... }
145. Converters /** * Dribbble API does not have a search endpoint so we have * to do gross things :( */ class DribbbleSearchConverter { // ... } http://jakes.link/plaid-converter
146. Converters List<Shot>
147. Converters List<Shot>
148. Converters List<Shot> DribbbleSearchConverter
149. Converters List<Shot> <html> DribbbleSearchConverter
150. Converters List<Shot> <html> Jsoup DribbbleSearchConverter
151. Converters List<Shot> <html> Jsoup Shot DribbbleSearchConverter
152. Converters List<Shot> DribbbleSearchConverter
153. Call Adapters
154. Call Adapters interface Service {
 @GET("/user")
 Call<User> user();
 }X 
 
 Call<User>

155. Call Adapters interface Service {
 @GET("/user")
 Call<User> user();
 }X Call<User> Call.Factory (aka OkHttpClient)
156. Call Adapters interface Service {
 @GET("/user")
 Call<User> user();
 }X Call<User> Call Call.Factory (aka OkHttpClient)
157. Call Adapters interface Service {
 @GET("/user")
 Call<User> user();
 }X Call<User> Call<User> Call Call.Factory (aka OkHttpClient)
158. Call Adapters interface Service {
 @GET("/user")
 Call<User> user();
 }X Call<User> Call<User> Call Call.Factory (aka OkHttpClient)
159. Call Adapters interface Service {
 @GET("/user")
 Call<User> user();
 }X Call<User> Call<User> Call Call.Factory (aka OkHttpClient) CallAdapter
160. Call Adapters interface Service {
 @GET("/user")
 Call<User> user();
 }X Call<User> Call<User> Call Call.Factory (aka OkHttpClient) CallAdapter
161. Call Adapters interface Service {
 @GET("/user")
 Call<User> user();
 }X Call<User> Call<User> Call Call.Factory (aka OkHttpClient) CallAdapter
162. Call Adapters interface Service {
 @GET("/user")
 Call<User> user();
 }X
163. Call Adapters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com")
 .build(); interface Service {
 @GET("/user")
 Call<User> user();
 }X
164. Call Adapters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addCallAdapterFactory(RxJavaCallAdapterFactory.create())
 .build(); interface Service {
 @GET("/user")
 Call<User> user();
 }X
165. Call Adapters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addCallAdapterFactory(RxJavaCallAdapterFactory.create())
 .build(); interface Service {
 @GET("/user")
 Observable<User> user();
 }X 
 
 
 
 Call
166. Call Adapters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addCallAdapterFactory(RxJavaCallAdapterFactory.create())
 .build(); interface Service {
 @GET("/user")
 Observable<User> user();
 }X Observable<User> Call<User> Call Call.Factory (aka OkHttpClient) CallAdapter
167. Call Adapters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addCallAdapterFactory(RxJavaCallAdapterFactory.create())
 .build(); interface Service {
 @GET("/user")
 Observable<User> user();
 }X Observable<User> Call<User> Call Call.Factory (aka OkHttpClient) CallAdapter
168. Call Adapters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addCallAdapterFactory(RxJavaCallAdapterFactory.create())
 .build(); interface Service {
 @GET("/user")
 Observable<User> user();
 }X Observable<User> Call<User> Call Call.Factory (aka OkHttpClient) CallAdapter
169. Call Adapters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addCallAdapterFactory(RxJavaCallAdapterFactory.create())
 .build(); interface Service {
 @GET("/user")
 Observable<User> user();
 }X
170. Call Adapters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addCallAdapterFactory(RxJavaCallAdapterFactory.create())
 .build(); interface Service {
 @GET("/user")
 Observable<User> user(); @GET("/friends") Call<List<User>> friends();
 }X
171. Call Adapters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addCallAdapterFactory(RxJavaCallAdapterFactory.create()) .addCallAdapterFactory(new BuiltInCallFactory()) // implict!
 .build(); interface Service {
 @GET("/user")
 Observable<User> user(); @GET("/friends") Call<List<User>> friends();
 }X
172. Call Adapters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addCallAdapterFactory(RxJavaCallAdapterFactory.create()) .addCallAdapterFactory(new BuiltInCallFactory()) // implict!
 .build(); interface Service {
 @GET("/user")
 Observable<User> user(); @GET("/friends") Call<List<User>> friends();
 }X
173. Call Adapters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addCallAdapterFactory(RxJavaCallAdapterFactory.create()) .addCallAdapterFactory(new BuiltInCallFactory()) // implict!
 .build(); interface Service {
 @GET("/user")
 Observable<User> user(); @GET("/friends") Call<List<User>> friends();
 }X
174. Call Adapters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addCallAdapterFactory(RxJavaCallAdapterFactory.create()) ? .addCallAdapterFactory(new BuiltInCallFactory()) // implict!
 .build(); interface Service {
 @GET("/user")
 Observable<User> user(); @GET("/friends") Call<List<User>> friends();
 }X
175. Call Adapters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addCallAdapterFactory(RxJavaCallAdapterFactory.create()) ✓ .addCallAdapterFactory(new BuiltInCallFactory()) // implict!
 .build(); interface Service {
 @GET("/user")
 Observable<User> user(); @GET("/friends") Call<List<User>> friends();
 }X
176. Call Adapters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addCallAdapterFactory(RxJavaCallAdapterFactory.create()) .addCallAdapterFactory(new BuiltInCallFactory()) // implict!
 .build(); interface Service {
 @GET("/user")
 Observable<User> user(); @GET("/friends") Call<List<User>> friends();
 }X
177. Call Adapters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addCallAdapterFactory(RxJavaCallAdapterFactory.create()) .addCallAdapterFactory(new BuiltInCallFactory()) // implict!
 .build(); interface Service {
 @GET("/user")
 Observable<User> user(); @GET("/friends") Call<List<User>> friends();
 }X
178. Call Adapters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addCallAdapterFactory(RxJavaCallAdapterFactory.create()) .addCallAdapterFactory(new BuiltInCallFactory()) // implict!
 .build(); interface Service {
 @GET("/user")
 Observable<User> user(); @GET("/friends") Call<List<User>> friends();
 }X
179. Call Adapters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addCallAdapterFactory(RxJavaCallAdapterFactory.create()) ? .addCallAdapterFactory(new BuiltInCallFactory()) // implict!
 .build(); interface Service {
 @GET("/user")
 Observable<User> user(); @GET("/friends") Call<List<User>> friends();
 }X
180. Call Adapters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addCallAdapterFactory(RxJavaCallAdapterFactory.create()) ✗ .addCallAdapterFactory(new BuiltInCallFactory()) // implict!
 .build(); interface Service {
 @GET("/user")
 Observable<User> user(); @GET("/friends") Call<List<User>> friends();
 }X
181. Call Adapters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addCallAdapterFactory(RxJavaCallAdapterFactory.create()) ✗ .addCallAdapterFactory(new BuiltInCallFactory()) // implict!
 .build(); interface Service {
 @GET("/user")
 Observable<User> user(); @GET("/friends") Call<List<User>> friends();
 }X
182. Call Adapters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addCallAdapterFactory(RxJavaCallAdapterFactory.create()) ✗ .addCallAdapterFactory(new BuiltInCallFactory()) // implict! ?
 .build(); interface Service {
 @GET("/user")
 Observable<User> user(); @GET("/friends") Call<List<User>> friends();
 }X
183. Call Adapters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addCallAdapterFactory(RxJavaCallAdapterFactory.create()) ✗ .addCallAdapterFactory(new BuiltInCallFactory()) // implict! ✓
 .build(); interface Service {
 @GET("/user")
 Observable<User> user(); @GET("/friends") Call<List<User>> friends();
 }X
184. Call Adapters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addCallAdapterFactory(RxJavaCallAdapterFactory.create()) .addCallAdapterFactory(new BuiltInCallFactory()) // implict!
 .build(); interface Service {
 @GET("/user")
 Observable<User> user(); @GET("/friends") Call<List<User>> friends();
 }X
185. Call Adapters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addCallAdapterFactory(RxJavaCallAdapterFactory.create())
 .build(); interface Service {
 @GET("/user")
 Observable<User> user(); @GET("/friends") Call<List<User>> friends();
 }X
186. Call Adapters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addCallAdapterFactory(RxJavaCallAdapterFactory.create()) .addCallAdapterFactory(Java8CallAdapterFactory.create())
 .build(); interface Service {
 @GET("/user")
 Observable<User> user(); @GET("/friends") Call<List<User>> friends();
 }X
187. Call Adapters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addCallAdapterFactory(RxJavaCallAdapterFactory.create()) .addCallAdapterFactory(Java8CallAdapterFactory.create())
 .build(); interface Service {
 @GET("/user")
 Observable<User> user(); @GET("/friends") Call<List<User>> friends(); @GET("/enemies") CompletableFuture<List<User>> enemies();
 }X
188. Call Adapters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addCallAdapterFactory(RxJavaCallAdapterFactory.create())
 .build(); interface Service {
 @GET("/user")
 Observable<User> user();
 }X
189. Call Adapters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addCallAdapterFactory( RxJavaCallAdapterFactory.createWithScheduler(io()))
 .build(); interface Service {
 @GET("/user")
 Observable<User> user();
 }X
190. Call Adapters class RxObserveOnCallAdapterFactory extends CallAdapter.Factory { @Override public CallAdapter<?, ?> get( Type returnType, Annotation[] annotations, Retrofit retrofit) { }B }A
191. Call Adapters class RxObserveOnCallAdapterFactory extends CallAdapter.Factory { @Override public CallAdapter<?, ?> get( Type returnType, Annotation[] annotations, Retrofit retrofit) { if (getRawType(returnType) != Observable.class) { return null; }C }B }A
192. Call Adapters class RxObserveOnCallAdapterFactory extends CallAdapter.Factory { @Override public CallAdapter<?, ?> get( Type returnType, Annotation[] annotations, Retrofit retrofit) { if (getRawType(returnType) != Observable.class) { return null; }C CallAdapter<Object, Observable<?>> delegate = retrofit.nextCallAdapter(this, returnType, annotations); }B }A
193. Call Adapters class RxObserveOnCallAdapterFactory extends CallAdapter.Factory { @Override public CallAdapter<?, ?> get( Type returnType, Annotation[] annotations, Retrofit retrofit) { if (getRawType(returnType) != Observable.class) { return null; }C CallAdapter<Object, Observable<?>> delegate = retrofit.nextCallAdapter(this, returnType, annotations); return new CallAdapter<Observable<?>>() { @Override public Observable<?> adapt(Call<Object> call) { }E }D }B }A
194. Call Adapters class RxObserveOnCallAdapterFactory extends CallAdapter.Factory { @Override public CallAdapter<?, ?> get( Type returnType, Annotation[] annotations, Retrofit retrofit) { if (getRawType(returnType) != Observable.class) { return null; }C CallAdapter<Object, Observable<?>> delegate = retrofit.nextCallAdapter(this, returnType, annotations); return new CallAdapter<Observable<?>>() { @Override public Observable<?> adapt(Call<Object> call) { Observable<?> o = delegate.adapt(call); }E }D }B }A
195. Call Adapters class RxObserveOnCallAdapterFactory extends CallAdapter.Factory { @Override public CallAdapter<?, ?> get( Type returnType, Annotation[] annotations, Retrofit retrofit) { if (getRawType(returnType) != Observable.class) { return null; }C CallAdapter<Object, Observable<?>> delegate = retrofit.nextCallAdapter(this, returnType, annotations); return new CallAdapter<Observable<?>>() { @Override public Observable<?> adapt(Call<Object> call) { Observable<?> o = delegate.adapt(call); return o.observeOn(mainThread()); }E }D }B }A
196. Call Adapters class RxObserveOnCallAdapterFactory extends CallAdapter.Factory { @Override public CallAdapter<?, ?> get( Type returnType, Annotation[] annotations, Retrofit retrofit) { if (getRawType(returnType) != Observable.class) { return null; }C CallAdapter<Object, Observable<?>> delegate = retrofit.nextCallAdapter(this, returnType, annotations); return new CallAdapter<Observable<?>>() { @Override public Observable<?> adapt(Call<Object> call) { Observable<?> o = delegate.adapt(call); return o.observeOn(mainThread()); }E @Override public Type responseType() { return delegate.responseType(); } }D }B }A
197. Call Adapters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addCallAdapterFactory( RxJavaCallAdapterFactory.createWithScheduler(io()))
 .build(); interface Service {
 @GET("/user")
 Observable<User> user();
 }X
198. Call Adapters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com") .addCallAdapterFactory(new RxObserveOnCallAdapterFactory()) .addCallAdapterFactory( RxJavaCallAdapterFactory.createWithScheduler(io()))
 .build(); interface Service {
 @GET("/user")
 Observable<User> user();
 }X
199. Call Adapters Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com")
 .build(); interface Service {
 @GET("/user")
 Call<User> user();
 }X
200. Call Adapters interface Service {
 @GET("/user")
 Call<User> user();
 }X
201. Call Adapters interface Service {
 @GET("/user")
 Call<User> user();
 }X Response<User> response = call.execute(); // or enqueue()
202. Call Adapters interface Service {
 @GET("/user")
 Call<User> user();
 }X Response<User> response = call.execute(); // or enqueue() if (!response.isSuccessful()) { // handle error body? }
203. Call Adapters interface Service {
 @GET("/user")
 Call<User> user();
 }X Response<User> response = call.execute(); // or enqueue() if (!response.isSuccessful()) { ResponseBody errorBody = response.errorBody(); }
204. Call Adapters interface Call<R, E> { Response<R, E> execute(); void enqueue(Callback<R, E> cb); } interface Callback<R, E> { void onResponse(Response<R, E> response); void onFailure(IOException e); } interface Response<R, E> { R body(); E error(); }
205. Call Adapters interface Call<R, E> { Response<R, E> execute(); void enqueue(Callback<R, E> cb); } interface Callback<R, E> { void onResponse(Response<R, E> response); void onFailure(IOException e); } interface Response<R, E> { R body(); E error(); }
206. Call Adapters interface Call<R, E> { Response<R, E> execute(); void enqueue(Callback<R, E> cb); }1 interface Callback<R, E> { void onResponse(Response<R, E> response);A void onFailure(IOException e); }2 interface Response<R, E> { R body(); E error(); }3
207. Call Adapters interface Call<R, E> { Response<R, E> execute(); void enqueue(Callback<R, E> cb); }1 interface Callback<R, E> { void onSuccess(R body);A void onError(E errorBody); void onFailure(IOException e); }2 Response Response< , > response interface Response<R, E> { R body(); E error(); }3
208. Call Adapters interface Call<R, E> { Response<R, E> execute(); void enqueue(Callback<R, E> cb); }1 interface Callback<R, E> { void onSuccess(R body);A void onClientError(E errorBody); void onServerError(String message); void onUnauthenticated(); void onFailure(IOException e); }2
209. Mock Mode
210. Mock Mode interface Service {
 @GET("/user")
 Call<User> user();
 }X
211. Mock Mode interface Service {
 @GET("/user")
 Call<User> user();
 }X Service service = retrofit.create(Service.class);
212. Mock Mode interface Service {
 @GET("/user")
 Call<User> user();
 }X Service service = retrofit.create(Service.class); class MockService implements Service { @Override public Call<List<User>> user() { return Calls.success( Arrays.asList(new User("Alice"), new User("Bob"))); } }
213. Mock Mode interface Service {
 @GET("/user")
 Call<User> user();
 }X Service service = retrofit.create(Service.class); class MockService implements Service { @Override public Call<List<User>> user() { return Calls.success( Arrays.asList(new User("Alice"), new User("Bob"))); }B }A Service fakeService = new MockService();
214. Mock Mode class MockService implements Service { @Override public Call<List<User>> user() { return Calls.success( Arrays.asList(new User("Alice"), new User("Bob"))); }B }A
215. Mock Mode class MockService implements Service { final BehaviorDelegate<Service> delegate; MockService(BehaviorDelegate<Service> delegate) { this.delegate = delegate; }C @Override public Call<List<User>> user() { return Calls.success( Arrays.asList(new User("Alice"), new User("Bob")));Z }B }A
216. Mock Mode class MockService implements Service { final BehaviorDelegate<Service> delegate; MockService(BehaviorDelegate<Service> delegate) { this.delegate = delegate; }C @Override public Call<List<User>> user() { List<User> response = Arrays.asList(new User("Alice"), new User("Bob"));Z return delegate.returningResponse(response).user(); }B }A Calls.success( )
217. Mock Mode Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com")
 .build();
218. Mock Mode Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com")
 .build(); NetworkBehavior behavior = NetworkBehavior.create();
219. Mock Mode Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com")
 .build(); NetworkBehavior behavior = NetworkBehavior.create(); MockRetrofit mockRetrofit = new MockRetrofit.Builder() .networkBehavior(behavior) .build();
220. Mock Mode Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com")
 .build(); NetworkBehavior behavior = NetworkBehavior.create(); MockRetrofit mockRetrofit = new MockRetrofit.Builder() .networkBehavior(behavior) .build(); BehaviorDelegate<Service> delegate = mockRetrofit.create(Service.class);
221. Mock Mode Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com")
 .build(); NetworkBehavior behavior = NetworkBehavior.create(); MockRetrofit mockRetrofit = new MockRetrofit.Builder() .networkBehavior(behavior) .build(); BehaviorDelegate<Service> delegate = mockRetrofit.create(Service.class); Service mockService = new MockService(delegate);
222. Mock Mode Retrofit retrofit = new Retrofit.Builder()
 .baseUrl("http://example.com")
 .build(); NetworkBehavior behavior = NetworkBehavior.create(); MockRetrofit mockRetrofit = new MockRetrofit.Builder() .networkBehavior(behavior) .build(); BehaviorDelegate<Service> delegate = mockRetrofit.create(Service.class); Service mockService = new MockService(delegate);
223. Mock Mode NetworkBehavior behavior = NetworkBehavior.create();
224. Mock Mode NetworkBehavior behavior = NetworkBehavior.create(); behavior.setDelay(2, SECONDS);
225. Mock Mode NetworkBehavior behavior = NetworkBehavior.create(); behavior.setDelay(2, SECONDS); behavior.setVariancePercent(40);
226. Mock Mode NetworkBehavior behavior = NetworkBehavior.create(); behavior.setDelay(2, SECONDS); behavior.setVariancePercent(40); behavior.setFailurePercent(2);
227. Mock Mode
228. Mock Mode
229. Retrofit
230. Retrofit • HTTP client sends the bits across the wire.
231. Retrofit • HTTP client sends the bits across the wire. • Converters manipulate request/response data.
232. Retrofit • HTTP client sends the bits across the wire. • Converters manipulate request/response data. • Call adapters change execution mechanism.
233. Retrofit • HTTP client sends the bits across the wire. • Converters manipulate request/response data. • Call adapters change execution mechanism. • Mock mode creates a deterministic, fake server for testing.
234. jakewharton jakewharton jakewharton twitter.com/ google.com/+ .com Making Retrofit Work For You