HTTP клиент на Kotlin: делаем запросы правильно

Введение в HTTP клиенты на Kotlin

Современная разработка на Kotlin немыслима без взаимодействия с удалёнными API и веб-сервисами. HTTP клиент — это фундаментальный инструмент, который позволяет вашему приложению отправлять запросы и получать ответы из интернета. Независимо от того, создаёте ли вы мобильное приложение, серверный бэкенд или десктопное приложение, умение правильно работать с HTTP запросами — обязательный навык для каждого Kotlin-разработчика.

В этой статье мы подробно разберём, какие библиотеки для работы с HTTP доступны в экосистеме Kotlin, как совершать GET и POST запросы, обрабатывать JSON и управлять асинхронностью. Вы узнаете, как избежать типичных ошибок и сделать ваш код надёжным и производительным.

Основные библиотеки для HTTP клиентов в Kotlin

1. Ktor Client

Ktor — это современный асинхронный фреймворк, созданный компанией JetBrains специально для Kotlin. Ktor Client поддерживает корутины, мультиплатформенность (JVM, Android, iOS, JS, Native) и предоставляет гибкий конфигурируемый движок.

Пример базового GET запроса с Ktor:

import io.ktor.client.*
import io.ktor.client.request.*
import io.ktor.client.statement.*

suspend fun fetchData(): String {
    val client = HttpClient()
    val response: HttpResponse = client.get("https://api.example.com/data")
    client.close()
    return response.bodyAsText()
}

2. OkHttp

OkHttp — одна из самых популярных библиотек для Java и Android, которая прекрасно работает и с Kotlin. Она отличается высокой производительностью, поддержкой HTTP/2, автоматическим пулом соединений и перехватчиками (interceptors).

Пример синхронного GET запроса с OkHttp:

import okhttp3.OkHttpClient
import okhttp3.Request

fun fetchData(): String {
    val client = OkHttpClient()
    val request = Request.Builder()
        .url("https://api.example.com/data")
        .build()
    
    client.newCall(request).execute().use { response ->
        return response.body?.string() ?: ""
    }
}

3. Fuel

Fuel — лёгкая и интуитивно понятная библиотека для Kotlin, построенная на основе OkHttp. Она предлагает функциональный стиль работы с запросами и удобную обработку результатов.

Пример GET запроса с Fuel:

import com.github.kittinunf.fuel.httpGet
import com.github.kittinunf.result.Result

fun fetchData() {
    "https://api.example.com/data"
        .httpGet()
        .responseString { _, _, result ->
            when (result) {
                is Result.Success -> println(result.value)
                is Result.Failure -> println(result.error)
            }
        }
}

Как правильно отправлять GET и POST запросы

GET запросы

GET запросы используются для получения данных с сервера. Параметры запроса обычно передаются в URL. При использовании Ktor параметры можно добавлять через блок parameter:

val client = HttpClient()
val response = client.get("https://api.example.com/search") {
    parameter("query", "Kotlin")
    parameter("page", 1)
}

Важно помнить: GET запросы не должны изменять состояние сервера и не должны содержать тело запроса. Все данные передаются через URL или заголовки.

POST запросы

POST запросы предназначены для отправки данных на сервер (например, создание нового ресурса). Тело запроса может быть в формате JSON, Form URL Encoded или Multipart.

Пример POST запроса с JSON телом через Ktor:

import io.ktor.client.request.*
import io.ktor.http.*

data class User(val name: String, val email: String)

suspend fun createUser(user: User): String {
    val client = HttpClient()
    val response = client.post("https://api.example.com/users") {
        contentType(ContentType.Application.Json)
        setBody(user)
    }
    client.close()
    return response.bodyAsText()
}

Для OkHttp отправка JSON выглядит так:

import okhttp3.MediaType.Companion.toMediaType
import okhttp3.RequestBody.Companion.toRequestBody

val json = """{"name":"John","email":"john@example.com"}"""
val mediaType = "application/json; charset=utf-8".toMediaType()
val body = json.toRequestBody(mediaType)

val request = Request.Builder()
    .url("https://api.example.com/users")
    .post(body)
    .build()

Обработка ответов и работа с JSON

Большинство современных API возвращают данные в формате JSON. Для удобной работы с JSON в Kotlin можно использовать библиотеки kotlinx.serialization или Gson.

Пример с kotlinx.serialization

import kotlinx.serialization.Serializable
import kotlinx.serialization.json.Json

@Serializable
data class ApiResponse(val id: Int, val title: String, val completed: Boolean)

fun parseJson(jsonString: String): ApiResponse {
    return Json.decodeFromString(jsonString)
}

Интеграция с Ktor позволяет автоматически сериализовать и десериализовывать данные:

import io.ktor.client.plugins.contentnegotiation.*
import io.ktor.serialization.kotlinx.json.*

val client = HttpClient {
    install(ContentNegotiation) {
        json(Json {
            ignoreUnknownKeys = true
            prettyPrint = true
        })
    }
}

suspend fun fetchTodo(): ApiResponse {
    return client.get("https://jsonplaceholder.typicode.com/todos/1").body()
}

Обработка ошибок

При работе с HTTP клиентами важно корректно обрабатывать ошибки сети и нестандартные HTTP коды (4xx, 5xx). Используйте try-catch блоки и проверяйте статус ответа:

suspend fun safeFetchData(): Result<String> {
    return try {
        val client = HttpClient()
        val response = client.get("https://api.example.com/data")
        if (response.status.value in 200..299) {
            Result.success(response.bodyAsText())
        } else {
            Result.failure(Exception("HTTP ${response.status.value}"))
        }
    } catch (e: Exception) {
        Result.failure(e)
    }
}

Асинхронность и работа с корутинами

Kotlin предлагает мощный механизм корутин для асинхронного программирования. Это особенно важно при работе с HTTP запросами, чтобы не блокировать главный поток приложения.

Пример асинхронного запроса с использованием корутин и Ktor:

import kotlinx.coroutines.*

fun main() = runBlocking {
    val result = async { fetchData() }
    println("Ожидание ответа...")
    println("Результат: ${result.await()}")
}

suspend fun fetchData(): String {
    val client = HttpClient()
    val response = client.get("https://api.example.com/data")
    client.close