Cum gestionezi rețeaua în Android?

Question

Accepted Answer

Aplicațiile Android comunică frecvent cu **API-uri** prin rețea. Abordarea standard utilizează biblioteci precum **Retrofit** (REST client) și **OkHttp**, cu coroutine-uri pentru operații asincrone și parsare JSON — gestionând apelurile de rețea în mod curat și corect pe un fir diferit de firul principal.

## Retrofit — clientul REST standard

```kotlin
// define the API as an interface; Retrofit implements it
interface ApiService {
  @GET("users/{id}")
  suspend fun getUser(@Path("id") id: Int): User    // suspend → coroutine async

@POST("users")
  suspend fun createUser(@Body user: User): User
}

// build Retrofit and use it
val api = Retrofit.Builder()
  .baseUrl("https://api.example.com/")
  .addConverterFactory(GsonConverterFactory.create())   // JSON parsing
  .build()
  .create(ApiService::class.java)

// call it from a coroutine (off the main thread)
viewModelScope.launch {
  val user = api.getUser(42)      // async, clean, returns a parsed User object
}
```

Retrofit transformă un API REST într-o interfață Kotlin curată; cu coroutine-uri, apelurile sunt asincrone și de aspect secvențial; convertoarele gestionează parsarea JSON↔obiect.

## Concepte cheie și practici recomandate

```text
✓ Run network calls OFF the main thread (coroutines + Dispatchers.IO) — never block UI
✓ OkHttp (under Retrofit) → interceptors (auth headers, logging), timeouts, caching
✓ JSON parsing → Gson / Moshi / kotlinx.serialization (response ↔ data classes)
✓ HANDLE ERRORS — network failures, non-2xx responses, timeouts → graceful UI feedback
✓ Repository pattern → abstract networking behind a clean interface (testable, organized)
✓ Show loading/error/success STATES (with ViewModel + observable state)
✓ INTERNET permission in the manifest
```

## De ce este important

Înțelegerea rețelei în Android este esențială deoarece **majoritatea aplicațiilor comunică cu backend-uri** — preluarea și trimiterea datelor prin rețea este o nevoie aproape universală, deci este o cunoaștere practică obligatorie.

Aplicațiile fac constant apeluri API (încărcarea datelor, trimiterea formularelor, autentificare), iar Android are o abordare standard și matură. **Retrofit** (clientul REST standard) este central: transformă un API REST într-o interfață Kotlin curată, și combinat cu **coroutine-uri** (făcând apelurile asincrone și de aspect secvențial) și **convertoare** (gestionând parsarea JSON-la-obiect), oferă o cale curată și productivă de a face apeluri de rețea — înțelegerea sa este esențială pentru rețeaua Android modernă.

Înțelegerea **conceptelor cheie și a practicilor recomandate** este importantă: executarea apelurilor de rețea **pe un fir diferit de firul principal** (prin coroutine-uri și Dispatchers.IO, fără a bloca niciodată interfața — o cerință fundamentală, deoarece blocarea provoacă ANR), utilizarea caracteristicilor **OkHttp** (interceptoare pentru anteturi de autentificare și înregistrare, timeri, cache), **parsarea JSON** în clase de date (prin Gson, Moshi sau kotlinx.serialization), **gestionarea erorilor** cu eleganță (defecte de rețea, răspunsuri non-2xx, depășiri de timp — oferind feedback în interfață, deoarece apelurile de rețea eșuează frecvent), utilizarea **modelului repository** (abstraiendo rețeaua după o interfață curată și testabilă), afișarea **stărilor de încărcare/eroare/succes** și declararea **permisiunii de internet**.

Acestea reflectă construirea unei rețele robuste și bine arhitecturate decât apeluri fragile ad-hoc.

Deoarece majoritatea aplicațiilor Android comunică cu API-uri (o nevoie aproape universală) și a o face bine (Retrofit + coroutine-uri, pe un fir diferit de firul principal, cu parsare JSON adecvată, gestionare a erorilor și arhitectură) este esențial pentru aplicații funcționale, robuste, și deoarece înțelegerea instrumentelor și practicilor standard este necesară pentru această capacitate de bază, înțelegerea rețelei în Android este o cunoaștere practică esențială, frecvent aplicată — o abilitate fundamentală necesară în aproape fiecare aplicație Android reală care comunică cu un backend, centrală pentru construirea aplicațiilor care preiau și afișează fiabil date reale.