Neobis 2017 Mob Dev meetup

1. Working with API

2. Что такое Retrofit
Retrofit (согласно официальному сайту) — типобезопасный
HTTP-клиент для Android и Java. Он является
незаменимым инструментом для работы с API в клиент-
серверных приложениях. Каких-то лет 5 назад Android-
разработчикам для работы с сетью приходилось воротить
горы кода с обратными вызовами, AsyncTask'ами и
прочими «низкоуровневыми» вещами. И компания Square
выпустила такую замечательную библиотеку — Retrofit.

3. Добавляем в build.gradle
compile 'com.squareup.retrofit2:retrofit:2.3.0'
И ждем
Качаем Retrofit и OkHttp

4. База с endpoint
- Создаем класс типа Interface и описываем все наши
эндпоинты
public interface Endpoint { }
Пример на Kotlin

5. Формат ендпоинтов
Если нужно добавить динамически формировать урл то
используем Path
@GET("group/{id}/users")
Call<List<User>> groupList(@Path("id") int groupId);
Если нужно вставлять параметры в Get запрос типа
?sort=desc то
@Query("sort") String sort
Если список параметров query динамичен то используем
@QueryMap Map<String, String> options

6. Также мы можем отправлять обьекты как тело запроса.
@POST("users/new")
Call<User> createUser(@Body User user);
Также POST запросы должны быть в формате Form-encoded
@FormUrlEncoded
@POST("user/edit")
Call<User> updateUser(@Field("first_name") String first, @Field("last_name") String last);
Если же мы добавляем кастомные обьекты в виде фоток или
файлов то необходимо использовать MultiPart
@Multipart
@PUT("user/photo")
Call<User> updateUser(@Part("photo") RequestBody photo, @Part("description") RequestBody
description);

7. ApiClient.get().groupList(userId).enqueue(object: Callback<List<User>> {
override fun onResponse(call: Call<ListDayWeather>?, response:
Response<ListDayWeather>) {
if (response.isSuccessful) {
// viewInterface?.showUserList(response.body)
} else {
// viewInterface?.showAlert()
}
}
override fun onFailure(call: Call<ListDayWeather>?, t: Throwable?) {
viewInterface?.showNoInternet()
}
})
Пример запроса.

8. Нужно в каждый запрос
добавить хедеры?
Там где билдим http клиент добавляем следующее
okBuilder.addInterceptor { chain ->
val original = chain.request()
val request = original.newBuilder()
.header("lang", Storage.get().getLang())
.method(original.method(), original.body())
.build()
chain.proceed(request)
}

9. Или если нужно повторить запрос
после неуспешного вызова.
public static <T> void enqueueWithRetry(Call<T> call, final Callback<T> callback, MainActivityInterface
activityInterface) {
call.enqueue(new RetryableCallback<T>(call, activityInterface) {
@Override
public void onFinalResponse(Call<T> call, Response<T> response) {
if (activityInterface != null) { activityInterface.onSuccess(); }
callback.onResponse(call, response);
}
@Override
public void onFinalFailure(Call<T> call, Throwable t) {
if (activityInterface != null) { activityInterface.onErrorAfterRetry(); }
callback.onFailure(call, t);
}
});
}
И вызывать при запросе
ApiClient.get().groupList(userId).enqueue
Вместо enqueue enqueueWithRetry

10. Сам RetryableCallback
public abstract class RetryableCallback<T> implements Callback<T> {
private int totalRetries = 5;
private static final String TAG = RetryableCallback.class.getSimpleName();
private final Call<T> call;
private int retryCount = 0;
MainActivityInterface activityInterface;
public RetryableCallback(Call<T> call, MainActivityInterface activityInterface) {
this.call = call;
this.activityInterface = activityInterface;
}
@Override
public void onResponse(Call<T> call, Response<T> response) {
if (!isCallSuccess(response)) {
if (retryCount++ < totalRetries) {
Log.v(TAG, "Retrying API Call - (" + retryCount + " / " + totalRetries + ")");
if (activityInterface != null) {
activityInterface.onErrorInRetry();
}
retry();
} else {
onFinalResponse(call, response);
}

11. } else {
onFinalResponse(call, response);
}
}
@Override
public void onFailure(Call<T> call, Throwable t) {
Log.e(TAG, t.getMessage());
if (retryCount++ < totalRetries) {
Log.v(TAG, "Retrying API Call - (" + retryCount + " / " + totalRetries + ")");
if (activityInterface != null) {
activityInterface.onErrorInRetry();
}
retry();
} else {
onFinalFailure(call, t);
}
}
public void onFinalResponse(Call<T> call, Response<T> response) { }
public void onFinalFailure(Call<T> call, Throwable t) { }
private void retry() { call.clone().enqueue(this); }
public static boolean isCallSuccess(Response response) {
int code = response.code();
return (code >= 200 && code < 400);
}
}

12. Ссылки
http://square.github.io/retrofit/
https://blog.mindorks.com/android-development-best-
practices-83c94b027fd3
И статья вдохновившая меня.

13. Всем спасибо !