Какво е Retrofit и как се използва в разработката за…

Retrofit — това е тип-сигурен клиент за HTTP заявки за Android и Java. Той опростява взаимодействието с REST API, използвайки анотации за описание на заявките.

Основни предимства:

Типова безопасност: Заявките и отговорите са представени като Java (или Kotlin) обекти, което намалява броя на грешките по време на изпълнение.
Лесна употреба: Обявяването на HTTP методи с помощта на анотации прави кода по-четим и поддържан.
Конфигурируемост: Лесно добавяне на interceptors за логиране, удостоверяване и други задачи.
Интеграция с конвертери: Поддържа различни конвертери за парсинг на отговори (JSON, XML и др.) от кутията (например Gson, Jackson).

Използване:

Добавяне на зависимости:

// build.gradle (на ниво приложение)
dependencies {
    implementation 'com.squareup.retrofit2:retrofit:<latest_version>'
    // Изберете конвертер за вашите данни (тук пример за Gson)
    implementation 'com.squareup.retrofit2:converter-gson:<latest_version>'
}

Дефиниране на API интерфейс: Създава се Java/Kotlin интерфейс, който обявява всички Endpoint-и на API с помощта на анотации.

// ApiService.java
import retrofit2.Call;
import retrofit2.http.GET;
import retrofit2.http.Path;
import java.util.List;

public interface ApiService {

    @GET("users/{userId}") // GET заявка към URL "users/{userId}"
    Call<User> getUser(@Path("userId") int userId); // @Path за поставяне на стойност в URL

    @GET("posts") // GET заявка към URL "posts"
    Call<List<Post>> getPosts();
}

// User.java (пример POJO за отговор)
public class User {
    private int id;
    private String name;
    // getters и setters
}

// Post.java (пример POJO за отговор)
public class Post {
    private int id;
    private int userId;
    private String title;
    private String body;
    // getters и setters
}

Създаване на Retrofit екземпляр:

// RetrofitClient.java
import retrofit2.Retrofit;
import retrofit2.converter.gson.GsonConverterFactory;

public class RetrofitClient {

    private static final String BASE_URL = "https://api.example.com/"; // Основен URL на вашия API
    private static Retrofit retrofit;

    public static Retrofit getRetrofitInstance() {
        if (retrofit == null) {
            retrofit = new Retrofit.Builder()
                    .baseUrl(BASE_URL) // Настройка на основния URL
                    .addConverterFactory(GsonConverterFactory.create()) // Добавяне на конвертер
                    .build();
        }
        return retrofit;
    }

    public static ApiService getApiService() {
        return getRetrofitInstance().create(ApiService.class); // Създаване на API сервизен екземпляр
    }
}

Изпълнение на заявки:

// В Activity, Fragment или ViewModel
import retrofit2.Call;
import retrofit2.Callback;
import retrofit2.Response;

// ...

ApiService apiService = RetrofitClient.getApiService();

// Асинхронна заявка за получаване на потребител по ID
Call<User> userCall = apiService.getUser(1);
userCall.enqueue(new Callback<User>() { // enqueue за асинхронно изпълнение в друг поток
    @Override
    public void onResponse(Call<User> call, Response<User> response) {
        if (response.isSuccessful() && response.body() != null) {
            User user = response.body();
            // Обработка на получения user
        } else {
            // Обработка на грешка (например, response.code(), response.errorbody())
        }
    }

    @Override
    public void onFailure(Call<User> call, Throwable t) {
        // Обработка на грешка при мрежа или друго изключение
        t.printStackTrace();
    }
});

// Асинхронна заявка за получаване на списък с постове
Call<List<Post>> postsCall = apiService.getPosts();
postsCall.enqueue(new Callback<List<Post>>() {
    @Override
    public void onResponse(Call<List<Post>> call, Response<List<Post>> response) {
        if (response.isSuccessful() && response.body() != null) {
            List<Post> posts = response.body();
            // Обработка на списъка с постове
        } else {
            // Обработка на грешка
        }
    }

    @Override
    public void onFailure(Call<List<Post>> call, Throwable t) {
        // Обработка на грешка
        t.printStackTrace();
    }
});

Retrofit абстрахира нискоуровневите детайли на работа с HTTP, позволявайки да се фокусираш върху логиката на приложението.

Какво е Retrofit и как се използва в разработката за Android?