Ce este Retrofit și cum este utilizat în dezvoltarea…

Retrofit este un client sigur pentru tip pentru solicitările HTTP pentru Android și Java. Simplifică interacțiunea cu API-urile REST, folosind adnotări pentru a descrie solicitările.

Principalele avantaje:

Siguranța tipurilor: Solicitările și răspunsurile sunt prezentate sub formă de obiecte Java (sau Kotlin), reducând erorile la timpul de execuție.
Ușurința în utilizare: Declararea metodelor HTTP cu ajutorul adnotărilor face codul mai ușor de citit și întreținut.
Configurabilitate: Se pot adăuga interceptori pentru logare, autentificare și alte sarcini.
Integrare cu convertoare: Suportă diferite convertoare pentru parsarea răspunsurilor (JSON, XML etc.), precum Gson, Jackson.

Utilizare:

Adăugarea dependențelor:

// build.gradle (nivelul aplicației)
dependencies {
    implementation 'com.squareup.retrofit2:retrofit:<latest_version>'
    // Alegeți un convertor pentru datele dvs. (exemplu pentru Gson)
    implementation 'com.squareup.retrofit2:converter-gson:<latest_version>'
}

Definirea interfeței API: Se creează o interfață Java/Kotlin care declară toate endpoint-urile API folosind adnotări.

// ApiService.java
import retrofit2.Call;
import retrofit2.http.GET;
import retrofit2.http.Path;
import java.util.List;

public interface ApiService {

    @GET("users/{userId}") // solicitare GET pentru URL-ul "users/{userId}"
    Call<User> getUser(@Path("userId") int userId); // @Path pentru înlocuirea valorii în URL

    @GET("posts") // solicitare GET pentru URL-ul "posts"
    Call<List<Post>> getPosts();
}

// User.java (exemplu POJO pentru răspuns)
public class User {
    private int id;
    private String name;
    // getters și setters
}

// Post.java (exemplu POJO pentru răspuns)
public class Post {
    private int id;
    private int userId;
    private String title;
    private String body;
    // getters și setters
}

Crearea instanței Retrofit:

// RetrofitClient.java
import retrofit2.Retrofit;
import retrofit2.converter.gson.GsonConverterFactory;

public class RetrofitClient {

    private static final String BASE_URL = "https://api.example.com/"; // URL-ul de bază al API-ului
    private static Retrofit retrofit;

    public static Retrofit getRetrofitInstance() {
        if (retrofit == null) {
            retrofit = new Retrofit.Builder()
                    .baseUrl(BASE_URL) // Setarea URL-ului de bază
                    .addConverterFactory(GsonConverterFactory.create()) // Adăugarea convertorului
                    .build();
        }
        return retrofit;
    }

    public static ApiService getApiService() {
        return getRetrofitInstance().create(ApiService.class); // Crearea instanței serviciului API
    }
}

Executarea solicitărilor:

// În Activity, Fragment sau ViewModel
import retrofit2.Call;
import retrofit2.Callback;
import retrofit2.Response;

// ...

ApiService apiService = RetrofitClient.getApiService();

// Solicitare asincronă pentru a obține utilizatorul după ID
Call<User> userCall = apiService.getUser(1);
userCall.enqueue(new Callback<User>() { // enqueue pentru execuție asincronă
    @Override
    public void onResponse(Call<User> call, Response<User> response) {
        if (response.isSuccessful() && response.body() != null) {
            User user = response.body();
            // Procesarea utilizatorului primit
        } else {
            // Procesarea erorii (de exemplu, response.code(), response.errorbody())
        }
    }

    @Override
    public void onFailure(Call<User> call, Throwable t) {
        // Procesarea erorii de rețea sau altă excepție
        t.printStackTrace();
    }
});

// Solicitare asincronă pentru a obține lista de postări
Call<List<Post>> postsCall = apiService.getPosts();
postsCall.enqueue(new Callback<List<Post>>() {
    @Override
    public void onResponse(Call<List<Post>> call, Response<List<Post>> response) {
        if (response.isSuccessful() && response.body() != null) {
            List<Post> posts = response.body();
            // Procesarea listei de postări
        } else {
            // Procesarea erorii
        }
    }

    @Override
    public void onFailure(Call<List<Post>> call, Throwable t) {
        // Procesarea erorii
        t.printStackTrace();
    }
});

Retrofit abstractizează detaliile de nivel inferior ale lucrului cu HTTP, permițându-ți să te concentrezi pe logica aplicației.

Ce este Retrofit și cum este utilizat în dezvoltarea Android?