Что нужно создать в Retrofit чтобы приложение получало данные?

Архитектура запросов с Retrofit

Для получения данных в Android-приложении с использованием Retrofit необходимо создать несколько ключевых компонентов, образующих законченную цепочку работы с сетевыми запросами.

1. Модель данных (Data Class)

Сначала определяем data-классы Kotlin (или POJO в Java), которые будут представлять структуру ответа от сервера. Retrofit использует конвертеры (например, Gson или Moshi) для автоматической десериализации JSON в эти объекты.

data class User(
    @SerializedName("id") // Аннотация для сопоставления с полем JSON
    val id: Long,
    @SerializedName("name")
    val name: String,
    @SerializedName("email")
    val email: String
)

data class ApiResponse<T>(
    @SerializedName("data")
    val data: T,
    @SerializedName("status")
    val status: String
)

2. Интерфейс API-сервиса

Создаем интерфейс, в котором описываем конечные точки (endpoints) API с помощью аннотаций Retrofit. Это ключевой абстрактный уровень, определяющий контракт взаимодействия.

interface ApiService {
    @GET("users/{id}")
    suspend fun getUserById(@Path("id") userId: Long): ApiResponse<User>
    
    @GET("users")
    suspend fun getAllUsers(@Query("page") page: Int): ApiResponse<List<User>>
    
    @POST("users")
    suspend fun createUser(@Body user: User): ApiResponse<User>
    
    @Multipart
    @POST("upload")
    suspend fun uploadFile(@Part file: MultipartBody.Part): ApiResponse<String>
}

3. Построение Retrofit-клиента

Создаем экземпляр Retrofit с помощью билдера, где конфигурируем основные параметры:

object RetrofitClient {
    private const val BASE_URL = "https://api.example.com/v1/"
    
    private val okHttpClient = OkHttpClient.Builder()
        .connectTimeout(30, TimeUnit.SECONDS)
        .readTimeout(30, TimeUnit.SECONDS)
        .addInterceptor(HttpLoggingInterceptor().apply {
            level = HttpLoggingInterceptor.Level.BODY
        })
        .build()
    
    private val retrofit = Retrofit.Builder()
        .baseUrl(BASE_URL)
        .client(okHttpClient)
        .addConverterFactory(GsonConverterFactory.create())
        .addCallAdapterFactory(CoroutineCallAdapterFactory()) // Для корутин
        .build()
    
    val apiService: ApiService = retrofit.create(ApiService::class.java)
}

4. Ключевые компоненты конфигурации

Обязательные элементы:

• Базовый URL (baseUrl()) - корневой адрес API
• Конвертер (addConverterFactory()) - для преобразования JSON/XML в объекты
• HTTP-клиент (client()) - обычно экземпляр OkHttpClient с настройками

Опциональные, но важные элементы:

• Адаптеры вызовов (addCallAdapterFactory()) - для поддержки RxJava, корутин, LiveData
• Интерсепторы - для логирования, добавления заголовков, обработки ошибок
• Кастомные конвертеры - для специфичных форматов данных

5. Выполнение запроса

Пример использования в ViewModel с корутинами:

class UserViewModel : ViewModel() {
    private val _users = MutableStateFlow<List<User>>(emptyList())
    val users: StateFlow<List<User>> = _users.asStateFlow()
    
    fun loadUsers(page: Int) {
        viewModelScope.launch {
            try {
                val response = RetrofitClient.apiService.getAllUsers(page)
                if (response.status == "success") {
                    _users.value = response.data
                }
            } catch (e: Exception) {
                // Обработка ошибок сети
                Log.e("Retrofit", "Network error", e)
            }
        }
    }
}

6. Дополнительные улучшения

На практике также создают:

• Repository слой для абстракции источника данных
• Интерсепторы для аутентификации (добавление токенов)
• Кастомные обработчики ошибок через Response.isSuccessful
• Кэширование через OkHttp Cache
• Factory для создания сервисов с разными конфигурациями

Итоговая структура

Полная цепочка выглядит так: Модели данных → Интерфейс API → Retrofit клиент → Репозиторий → ViewModel/LiveData/StateFlow → UI. Такой подход обеспечивает чистую архитектуру, тестируемость и поддержку различных стратегий выполнения запросов (синхронных, асинхронных, реактивных). Retrofit минимизирует шаблонный код, позволяя сосредоточиться на бизнес-логике приложения, а не на рутинной работе с HTTP-запросами.