Как определить функцию для выполнения запроса в Retrofit

«Как определить функцию для выполнения запроса в Retrofit» — вопрос из категории Сети, который задают на 23% собеседований Android Разработчик. Ниже — развёрнутый ответ с разбором ключевых моментов.

Ответ

interface ApiService {
    @GET("users/{id}")
    suspend fun getUser(@Path("id") userId: Int): User
}

// Использование
val retrofit = Retrofit.Builder()
    .baseUrl("https://api.example.com/")
    .addConverterFactory(GsonConverterFactory.create())
    .build()

val service = retrofit.create(ApiService::class.java)

// В корутине
val user = service.getUser(123)

Ключевые моменты:

  1. Создаем интерфейс с аннотированными методами
  2. @GET, @POST и др. определяют тип запроса
  3. Параметры отмечаются @Path, @Query, @Body и т.д.
  4. Для корутин используем suspend функции
  5. Для RxJava возвращаем Observable<T> или Single<T>