Interceptor — bu nədir, OkHttp və Alamofire interceptor növləri

Interceptor nədir?

Interceptor — serverə göndərilməzdən əvvəl sorğuları və tətbiqə ötürülməzdən əvvəl cavabları ələ keçirib dəyişdirmək üçün HTTP müştərisinə daxil edilən proqram komponentidir. Mobil proqramlaşdırmada interceptorlar kəsişən tapşırıqları həll edir: avtomatik autentifikasiya tokenlərinin əlavə edilməsi, trafikin vaxt ölçmələri ilə loqlanması, müvəqqəti şəbəkə xətalarında təkrar cəhdlər, məlumatların sıxılması və şifrəsinin açılması. Interceptor memarlığı Chain of Responsibility naxışına əsaslanır — hər bir interceptor sorğunu dəyişdirə, icra edə və ya xüsusi cavab qaytararaq zənciri kəsə bilər.

Interceptor zənciri necə işləyir

OkHttp-də interceptorlar zəncir (chain) təşkil edir. Hər bir Interceptor orijinal sorğu ilə Chain obyekti alır və idarəetməni növbəti interceptor-a ötürmək üçün chain.proceed(request) çağırır. Cavab alındıqdan sonra interceptor Response-u təhlil edə, dəyişdirə, xəta olduqda sorğunu təkrarlaya və ya keşləmə üçün xüsusi cavab qaytara bilər. OkHttpClient.Builder-də interceptorların əlavə edilmə sırası onların icra ardıcıllığını müəyyən edir: birinci əlavə edilən göndərmədə birinci, qəbulda isə sonuncu icra olunur.

OkHttp-də Interceptor: Application və Network

OkHttp interceptorları iki növə ayırır. Application Interceptor (addInterceptor) tətbiq kodu ilə OkHttp arasında icra olunur: bir chain.proceed() çağırışı — yönləndirmələrdən asılı olmayaraq serverə bir sorğu. Network Interceptor (addNetworkInterceptor) OkHttp daxilində başlıqlar və əlaqə qurulduqdan sonra icra olunur — hər yönləndirmə, təkrar cəhd və ya autentifikasiyada işə düşür. Bu fərq müəyyən tapşırıq üçün düzgün interceptor növünün seçilməsi üçün kritik əhəmiyyətlidir.

class LoggingInterceptor : Interceptor {
    override fun intercept(chain: Interceptor.Chain): Response {
        val request = chain.request()
        Log.d("HTTP", "${request.method} ${request.url}")

        val startTime = System.currentTimeMillis()
        val response = chain.proceed(request)
        val duration = System.currentTimeMillis() - startTime

        Log.d("HTTP", "${response.code} ${duration}ms ərzində")
        return response
    }
}

val client = OkHttpClient.Builder()
    .addInterceptor(LoggingInterceptor())
    .addNetworkInterceptor(CacheInterceptor())
    .build()

LoggingInterceptor — metodu, URL-i, cavab kodunu və icra müddətini loqlayan Application Interceptor-dur. addInterceptor() vasitəsilə əlavə edilməsi yönləndirmələrdə təkrarlanmadan istifadəçi sorğusu üçün bir loq təmin edir. CacheInterceptor Network Interceptor olaraq əlavə edilmişdir ki, yalnız OkHttp daxilində HTTP sorğusu qurulduqdan sonra görünən serverin Cache-Control başlıqlarını nəzərə alsın.

Növlər arasında praktik fərq

Tətbiq sorğu göndərdikdə server 302 və ya 301 yönləndirməsi ilə cavab verə bilər. Application Interceptor bütün yönləndirmələrdən sonra yalnız yekun cavabı görür — neçə aralıq sorğunun edildiyini bilmir. Network Interceptor aralıq sorğular və cavablar da daxil olmaqla hər sorğu və cavabı görür. Square (2026) məlumatlarına görə, Network Interceptor həmçinin əlaqə səviyyəsində sıxılmış (gzip) məlumatları görür, Application Interceptor isə artıq açılmış cavabı alır. Həqiqi şəbəkə çağırışlarının sayını hesablamaq üçün Network Interceptor-dan istifadə edin.

Alamofire RequestInterceptor

Alamofire iki protokolu birləşdirən RequestInterceptor protokolunu təqdim edir: göndərmədən əvvəl sorğunu dəyişdirmək üçün RequestAdapter və xətalar zamanı təkrar cəhdlər üçün RequestRetrier. Bu bölgü adaptasiyanı (başlıqların, tokenlərin əlavə edilməsi) təkrar cəhd siyasəti (eksponensial gecikmə, cəhd limiti, xəta növünün yoxlanılması) ilə çevik birləşdirməyə imkan verir. RequestInterceptor hər iki protokolu tətbiq edən bir struktur və ya sinif ilə reallaşdırılır.

struct AuthInterceptor: RequestInterceptor {
    private let tokenProvider: TokenProvider

    func adapt(_ urlRequest: URLRequest,
                using state: Session.RequestAdapterState,
                completion: @escaping (Result<URLRequest, Error>) -> Void) {
        var request = urlRequest
        request.setValue("Bearer \(tokenProvider.token)",
                        forHTTPHeaderField: "Authorization")
        completion(.success(request))
    }

    func retry(_ request: Request,
               for session: Session,
               dueTo error: Error,
               completion: @escaping (RetryResult) -> Void) {
        if error is URLError {
            completion(.retryWithDelay(1))
        } else {
            completion(.doNotRetry)
        }
    }
}

AuthInterceptor Swift-də adapt vasitəsilə Bearer token əlavə edir və URLError (şəbəkə itkisi, timeout) zamanı retry ilə 1 saniyə gecikmə ilə sorğunu avtomatik təkrarlayır. Adaptasiya və təkrar cəhdlərin ayrılması onları müstəqil sınaqdan keçirməyə imkan verir — retry məntiqinə toxunmadan adaptasiya üçün vahid test yazmaq olar. Alamofire (2026) məlumatlarına görə, RequestInterceptor iOS layihələrində mərkəzləşdirilmiş autentifikasiya idarəetməsinin standart üsuludur.

Interceptorların istifadə ssenariləri

Loqlama — ən çox yayılmış ssenari. Interceptor URL-i, metodu, başlıqları, sorğu və cavab məzmununu, icra müddətini qeyd edir. Debug yığımlarında bu, Charles Proxy və Wireshark-ı əvəz edir, release-də sorğu konteksti ilə xəta hesabatlarına kömək edir. OkHttp üçün logging-interceptor kitabxanasından NONE, BASIC, HEADERS və BODY səviyyələri ilə HttpLoggingInterceptor istifadə olunur. BODY səviyyəsi sorğu və cavabların tam məzmununu loqlayır — yalnız debug-da istifadə edin.

Autentifikasiya və Refresh Token

Access token müddəti bitdikdə Interceptor 401 cavabını ələ keçirir, refresh token API-ni çağırır və yeni token ilə orijinal sorğunu təkrarlayır. OkHttp-də bu, Authenticator və ya response.code yoxlaması ilə xüsusi Interceptor vasitəsilə həyata keçirilir. Authenticator yalnız cavab başlıqlarına, Interceptor isə tam məzmuna giriş əldə edir. Alamofire-də — token yeniləndikdən sonra .retry qaytaran RequestRetrier vasitəsilə. OWASP (2026) məlumatlarına görə, Interceptor vasitəsilə tokenlərin avtomatik yenilənməsi etimadnamə sızması riskini azaldır.

Ümumi başlıqların əlavə edilməsi

Content-Type, Accept-Language, User-Agent, Device-ID — hər sorğuda tələb olunan başlıqlar. Interceptor onları mərkəzləşdirilmiş şəkildə əlavə edir, hər API metodunda təkrarlanmadan. User-Agent tətbiq başlanğıcında bir dəfə yaradılır: “AppName/1.0 (Android 14; Pixel 8)”. Accept-Language cihazın sistem dilindən götürülür. Alamofire (2026) məlumatlarına görə, Interceptor vasitəsilə başlıqların mərkəzləşdirilmiş idarəsi səhv başlıq xətalarının sayını 30% azaldır.

Ən yaxşı təcrübələr və zəncir sırası

OkHttp-də Interceptor-un əlavə edilmə sırası bütün zəncirin davranışını müəyyən edir. Birinci əlavə edilən interceptor sorğu göndərmədə birinci, cavab qəbulunda isə sonuncu icra olunur. Loqlama üçün Interceptor-u birinci əlavə edin — digər interceptorların bütün dəyişiklikləri ilə yekun sorğunu görəcək. Sıxılma üçün — sonuncu, sıxılmanın yekun məlumatlara tətbiq edilməsi üçün. Autentifikasiya üçün — təkrar cəhddən əvvəl, tokenin təkrar cəhddən əvvəl yenilənməsi üçün.

Release yığımları üçün tövsiyələr

Release yığımlarında loqlamanı BuildConfig.DEBUG və ya asılılıq inyeksiyası vasitəsilə söndürün. Keşləmə üçün addNetworkInterceptor istifadə edin — Network Interceptor serverin Cache-Control başlıqlarını görür və keşləmə siyasətini düzgün şərh edir. Autentifikasiya üçün addInterceptor (Application) tətbiq edin — bu, avtorizasiya başlıqlarının göndərilməməli olduğu xarici domenlərə yönləndirmələrdə təkrar ələ keçirmənin qarşısını alır. Hər Interceptor-u okhttp-testing-support-dan MockWebServer ilə təcrid olunmuş şəkildə sınaqdan keçirin — o, sorğuları ələ keçirir və əvvəlcədən hazırlanmış cavabları qaytarır, interceptor məntiqini real server olmadan yoxlamağa imkan verir.

Interceptor performansı

Hər bir Interceptor sorğu vaxtına kiçik bir gecikmə əlavə edir. 3–4 interceptorlu tipik zəncirdə (loqlama, autentifikasiya, sıxılma, keşləmə) sorğu başına əlavə yük 5 millisaniyədən azdır. Problemlər Interceptor bloklayan əməliyyatlar yerinə yetirdikdə başlayır: sinxron refresh token API çağırışı, böyük loqların fayla yazılması və ya sorğu məzmununun şifrələnməsi. Bütün bu əməliyyatlar asinxron olmalı və ya fon thread-də icra edilməlidir. Square (2026) məlumatlarına görə, OkHttp Interceptor-u Dispatcher thread hovuzunda icra edir — bir interceptor-un bloklanması bütün zənciri gecikdirir.

• Sıra əhəmiyyətlidir — loqlama birinci, autentifikasiya təkrar cəhddən əvvəl, sıxılma sonuncu
• Debug vs Release — HttpLoggingInterceptor yalnız debug yığımlarında
• Təcrid — hər Interceptor bir tapşırığı həll edir (Single Responsibility)
• Asinxronluq — Interceptor OkHttp-nin fon thread-də icra olunur, UI-ni bloklamır