Kas ir Retrofit un kā tas tiek izmantots Android…

Retrofit ir tipiem drošs klients HTTP pieprasījumiem Android un Java. Tas vienkāršo ar REST API saziņu, izmantojot anotācijas pieprasījumu aprakstīšanai.

Galvenās priekšrocības:

Tipu drošība: Pieprasījumi un atbildes ir attēloti kā Java (vai Kotlin) objekti, kas samazina izpildlaika kļūdu iespējamību.
Vienkāršība lietošanā: HTTP metožu deklarēšana ar anotācijām padara kodu skaidrāku un uzturamu.
Konfigurējamība: Viegli pievienot interceptors logēšanai, autentifikācijai un citām funkcijām.
Integrācija ar konverteriem: Atbalsta dažādus konverterus atbildēm (JSON, XML utt.) no kastes (piemēram, Gson, Jackson).

Lietošanas veids:

Atkarību pievienošana:

// build.gradle (lietotāja līmenī)
dependencies {
    implementation 'com.squareup.retrofit2:retrofit:<latest_version>'
    // Izvēlieties konverteri saviem datiem (šeit piemērs ar Gson)
    implementation 'com.squareup.retrofit2:converter-gson:<latest_version>'
}

API interfeisa definēšana: Tiek izveidots Java/Kotlin interfeiss, kas deklarē visus API Endpointus ar anotācijām.

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

public interface ApiService {

    @GET("users/{userId}") // GET pieprasījums uz URL "users/{userId}"
    Call<User> getUser(@Path("userId") int userId); // @Path aizvieto vērtību URL

    @GET("posts") // GET pieprasījums uz URL "posts"
    Call<List<Post>> getPosts();
}

// User.java (piemērs POJO atbildei)
public class User {
    private int id;
    private String name;
    // getters un setters
}

// Post.java (piemērs POJO atbildei)
public class Post {
    private int id;
    private int userId;
    private String title;
    private String body;
    // getters un setters
}

Retrofit instances izveide:

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

public class RetrofitClient {

    private static final String BASE_URL = "https://api.example.com/"; // Jūsu API bāzes URL
    private static Retrofit retrofit;

    public static Retrofit getRetrofitInstance() {
        if (retrofit == null) {
            retrofit = new Retrofit.Builder()
                    .baseUrl(BASE_URL) // Uzstādīt bāzes URL
                    .addConverterFactory(GsonConverterFactory.create()) // Pievienot konverteri
                    .build();
        }
        return retrofit;
    }

    public static ApiService getApiService() {
        return getRetrofitInstance().create(ApiService.class); // Izveidot API servisa instanci
    }
}

Pieprasījumu izpilde:

// Activity, Fragment vai ViewModel
import retrofit2.Call;
import retrofit2.Callback;
import retrofit2.Response;

// ...

ApiService apiService = RetrofitClient.getApiService();

// Asinhronska pieprasījums lietotāja iegūšanai pēc ID
Call<User> userCall = apiService.getUser(1);
userCall.enqueue(new Callback<User>() { // enqueue veic asinhroni citā pavedienā
    @Override
    public void onResponse(Call<User> call, Response<User> response) {
        if (response.isSuccessful() && response.body() != null) {
            User user = response.body();
            // Apstrādāt saņemto user
        } else {
            // Apstrādāt kļūdu (piemēram, response.code(), response.errorbody())
        }
    }

    @Override
    public void onFailure(Call<User> call, Throwable t) {
        // Apstrādāt tīkla kļūdu vai citu izņēmumu
        t.printStackTrace();
    }
});

// Asinhronska pieprasījums, lai iegūtu sarakstu ar ierakstiem
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();
            // Apstrādāt ierakstu sarakstu
        } else {
            // Apstrādāt kļūdu
        }
    }

    @Override
    public void onFailure(Call<List<Post>> call, Throwable t) {
        // Apstrādāt kļūdu
        t.printStackTrace();
    }
});

Retrofit abstrakcionē zema līmeņa HTTP darbību detaļas, ļaujot koncentrēties uz lietojumprogrammas loģiku.

Kas ir Retrofit un kā tas tiek izmantots Android izstrādē?