Why OkHttp interceptors in Android Kotlin? - Purpose & Use Cases

The Big Idea

Discover how a simple interceptor can save you hours of repetitive coding and prevent hidden bugs!

The Scenario

Imagine you want to add a special note or check every letter you send in the mail manually. For every letter, you open it, write the note, check the address, and then send it. This takes a lot of time and you might forget or make mistakes.

The Problem

Doing these checks and changes manually for every network request is slow and error-prone. You might forget to add important headers or log the request details, causing bugs or security issues. It's like repeating the same task over and over without a shortcut.

The Solution

OkHttp interceptors act like a smart assistant who automatically checks and modifies every letter before it goes out or after it comes in. You write the rules once, and the interceptor applies them to all requests and responses, saving time and avoiding mistakes.

Before vs After

✗ Before

val request = originalRequest.newBuilder().addHeader("Auth", token).build()
val response = client.newCall(request).execute()

✓ After

val interceptor = Interceptor { chain ->
  val newRequest = chain.request().newBuilder().addHeader("Auth", token).build()
  chain.proceed(newRequest)
}
client = OkHttpClient.Builder().addInterceptor(interceptor).build()

What It Enables

It enables automatic, consistent handling of network requests and responses, making your app more reliable and easier to maintain.

Real Life Example

For example, an app can automatically add login tokens to every request or log errors centrally without changing each network call in the code.

Key Takeaways

Manual request handling is repetitive and error-prone.

Interceptors automate request and response processing.

This leads to cleaner, safer, and more maintainable network code.