Biblioteka Retrofit ułatwia życie programisty. Służy ona do czegoś co w dzisiejszych czasach jest niezbędne, czyli połączenia z internetem aby pozyskać tamtejsze zasoby. Wszystko to jest sprowadzane do niezbędnego minimum pisanego kodu. W tej prezentacji opisane zostaną te bardziej zaawansowane możliwości tej biblioteki, razem z drobnym wprowadzeniem czym ona właściwie jest i co potrafi.

1. Zaawansowany Retrofit

2. O mnie
● Maciej Puchalski
● Entuzjasta Androida
● Rowerzysta
● SoftwareHUT

3. Agenda
● Kod bez Retrofita
● Omówienie podstaw Retrofita
● Pokazanie wybranych zaawansowanych przykładów
● Jak rozwinąć Retrofita?

4. Kod do endpointa
String url =
"https://api.github.com/users/sennajavie/repos”;
URL obj = new URL(url);
HttpURLConnection con =
(HttpURLConnection) obj.openConnection();
con.setRequestMethod("GET");

5. final HashMap<String, String> requestParams =
new HashMap<>();
requestParams.put("User-Agent","Mozilla/5.0");
requestParams.put("Content-Type","message");
Kod do endpointa.

6. BufferedReader in = new BufferedReader(...);
String data;
StringBuffer response = new StringBuffer();
while ((data = in.readLine()) != null) {
response.append(data);
}
Kod do endpointa… czy to już koniec?

7. BufferedReader in = new BufferedReader(...);
String data;
StringBuffer response = new StringBuffer();
while ((data = in.readLine()) != null) {
response.append(data);
}
Kod do endpointa……….
in.close();

8. Stos kodu
in.close();

9. Wkracza Retrofit
}
in.close();

10. Wkracza Retrofit
}@GET("users/{user}/repos")
Call<List<Repository>>
getReposList(@Path("user") String user);
in.close();

12. interface ApiClient {
@GET("users/{user}/repos")
Call<List<Repository>>
getReposList(@Path("user") String user);
}
Kod do endpointa

13. GsonConverterFactory.create()
Endpoint - Skąd model?

14. ● Gson: com.squareup.retrofit2:converter-gson
● Jackson: com.squareup.retrofit2:converter-jackson
● Moshi: com.squareup.retrofit2:converter-moshi
● Protobuf: com.squareup.retrofit2:converter-protobuf
● Wire: com.squareup.retrofit2:converter-wire
● Simple XML: com.squareup.retrofit2:converter-simplexml
Convertery

15. interface ApiClient {
@GET("users/{user}/repos")
Call<List<Repository>>
getReposList(@Path("user") String user);
}
Kod do endpointa

16. users/{user}/repos
vs
/users/{user}/repos
Endpoint - Co z tym URLem?

17. https://api.github.com/dummy/ + users/{user}/repos =
https://api.github.com/dummy/users/{user}/repos
Endpoint - Co z tym URLem?

18. https://api.github.com/dummy/ + /users/{user}/repos =
https://api.github.com/users/{user}/repos
dummy?
Endpoint - Co z tym URLem?

19. interface ApiClient {
@GET
Call<List<Repository>>
getReposList(@Url String url,
@Path("user") String user);
}
Endpoint URL bonus!

20. interface ApiClient {
@GET("users/{user}/repos")
Call<List<Repository>>
getReposList(@Path("user") String user);
}
Kod do endpointa

21. interface ApiClient {
@FormUrlEncoded
@HTTP(method = "DELETE",
path = "users/{user}/repos",
hasBody = true)
Call<ResponseBody>
deleteRepo(@Body Repository repo,
@Field("Name") String value);
}
Endpoint - DELETE z BODY?!

22. interface ApiClient {
@FormUrlEncoded
@POST("users/newUser")
Call<ResponseBody>
postNewUser(@Field("id") int id,
@Field("name") String name,
@Field("mail") String mail);
}
Kod do endpointa

23. interface ApiClient {
@FormUrlEncoded
@GET("users/{user}/repos")
Call<List<Repository>>
getReposList(@Path("user") String user,
@Field("id") int id,
@Header("lang") String lang);
}
Zaawansowany kod do endpointa

24. gson = GsonConverterFactory.create();
Retrofit retrofit = new Retrofit.Builder()
.addConverterFactory(gson)
.baseUrl("https://api.github.com/")
.build();
return retrofit.create(ApiClient.class);
Utworzenie clienta

25. @Override
public okhttp3.Response intercept(Chain chain)
{
final Request request =
chain.request().newBuilder()
.addHeader("Authorization", "CODE")
.build();
return chain.proceed(request);
}
Client - Modyfikacja requestu

26. final OkHttpClient client =
new OkHttpClient.Builder()
.addInterceptor(new AuthHeaderInterceptor())
.build();
//..
retrofitBuilder.client(client)
//..
return retrofit.create(ApiClient.class);
Client - Modyfikacja requestu

27. final OkHttpClient client =
new OkHttpClient.Builder()
.addInterceptor(new AuthHeaderInterceptor())
.build();
//..
retrofitBuilder.client(client)
//..
return retrofit.create(ApiClient.class);
Client - Modyfikacja requestu

28. HttpLoggingInterceptor loggingInterceptor =
new HttpLoggingInterceptor();
loggingInterceptor.setLevel(
HttpLoggingInterceptor.Level.BODY);
Client - Debug

29. OkHttpClient.Builder()
.addInterceptor(loggingInterceptor)
.addInterceptor(authHeaderInterceptor)
OkHttpClient.Builder()
.addInterceptor(authHeaderInterceptor)
.addInterceptor(loggingInterceptor)
Client - Kolejność debugu!
+
-

30. reposCall=apiClient.getReposList("sennajavie");
reposCall.enqueue((call, response) -> {
List<Repository> repos= response.body();
});
Przykładowe użycie endpointa

31. +
Retrofit

32. Retrofit retrofit =
new Retrofit.Builder()
//...
.addCallAdapterFactory(
RxJavaCallAdapterFactory.create())
//...
.build();
RxJava + Retrofit

33. interface ApiClient {
@GET("users/{user}/repos")
Observable<List<Repository>>
getReposList(@Path("user") String user);
}
RxJava + Retrofit

34. reposObservable =
apiClient.getReposList("sennajavie");
reposObservable
.subscribeOn(Schedulers.io())
.observeOn(AndroidSchedulers.mainThread())
.subscribe((repos) -> {
repositories.get(0);
});
RxJava - Przykładowe użycie

35. reposObservable =
apiClient.getReposList("sennajavie");
reposObservable
.subscribeOn(Schedulers.io())
.observeOn(AndroidSchedulers.mainThread())
.subscribe((repos) -> {
repositories.get(0);
});
RxJava - Przykładowe użycie

36. reposObservable.
subscribeOn(Schedulers.io())
reposObservable.
observeOn(AndroidSchedulers.mainThread())
RxJava - Zarządzanie wątkami

37. RxJava - Zarządzanie wątkami
IO
Thread
Main
Thread
subscribe()
executeRequest() endOfExecute()
subscriber.onNext()
.subscribeOn(Schedulers.io())
.observeOn(AndroidSchedulers.mainThread())

38. CompositeSubscription foregroundSub;
public void appStarted() {
foregroundSub = new CompositeSubscription();
}
public void appStopped() {
foregroundSub.unsubscribe();
}
RxJava - Przerwanie działania

39. Subscriber<List<Repository>> reposSub =
(repos) -> {
repos.get(0);
};
foregroundSub.add(reposSub);
//…
reposObservable.subscribe(reposSub);
RxJava - Przerwanie działania

40. RxJava - Zarządzanie wątkami
IO
Thread
Main
Thread
subscribe()
executeRequest() endOfExecute()
subscriber.onNext()
.subscribeOn(Schedulers.io())
.observeOn(AndroidSchedulers.mainThread())
unsubscribe()

41. ● Krótki kod
● Możliwości
● Kontrola endpointa
● Integracja z RxJava
Reasumując...

42. puchalski.maciej.official@gmail.com
Dziękuję

43. Źródła
● https://unsplash.com/photos/PW0-vZD0wis
● https://unsplash.com/photos/AoSAOV2Vtro
● https://unsplash.com/search/elegant?photo=dgOJDAv96s8
● http://www.amphinicy.com/upload/blog/1000/30_rxjava.png
● http://atl.co.ug/big/wp-content/uploads/2015/05/Retrofit.jpg