Τι είναι το Retrofit και πώς χρησιμοποιείται στην…

Το Retrofit είναι ένας τύπος-ασφαλής πελάτης για αιτήματα HTTP για Android και Java. Απλοποιεί την αλληλεπίδραση με REST API, χρησιμοποιώντας annotations για την περιγραφή των αιτημάτων.

Βασικά πλεονεκτήματα:

Ασφάλεια τύπων: Τα αιτήματα και οι απαντήσεις παρουσιάζονται ως αντικείμενα Java (ή Kotlin), μειώνοντας τα σφάλματα κατά την εκτέλεση.
Ευκολία στη χρήση: Η δήλωση των μεθόδων HTTP με annotations καθιστά τον κώδικα πιο ευανάγνωστο και εύκολο στη συντήρηση.
Διαμορφωσιμότητα: Είναι εύκολο να προστεθούν interceptors για καταγραφή, αυθεντικοποίηση και άλλες εργασίες.
Ενσωμάτωση με converters: Υποστηρίζει διάφορους converters για την ανάλυση απαντήσεων (JSON, XML κ.ά.), όπως Gson, Jackson.

Χρήση:

Προσθήκη εξαρτήσεων:

// build.gradle (επίπεδο εφαρμογής)
dependencies {
    implementation 'com.squareup.retrofit2:retrofit:<latest_version>'
    // Επιλέξτε έναν converter για τα δεδομένα σας (παράδειγμα για Gson)
    implementation 'com.squareup.retrofit2:converter-gson:<latest_version>'
}

Ορισμός της API διεπαφής: Δημιουργείται μια Java/Kotlin διεπαφή που δηλώνει όλα τα Endpoint της API με annotations.

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

public interface ApiService {

    @GET("users/{userId}") // GET αίτημα στη διεύθυνση URL "users/{userId}"
    Call<User> getUser(@Path("userId") int userId); // @Path για την αντικατάσταση της τιμής στη διεύθυνση URL

    @GET("posts") // GET αίτημα στη διεύθυνση URL "posts"
    Call<List<Post>> getPosts();
}

// User.java (παράδειγμα POJO για την απάντηση)
public class User {
    private int id;
    private String name;
    // getters και setters
}

// Post.java (παράδειγμα POJO για την απάντηση)
public class Post {
    private int id;
    private int userId;
    private String title;
    private String body;
    // getters και setters
}

Δημιουργία στιγμιότυπου 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 του API
    private static Retrofit retrofit;

    public static Retrofit getRetrofitInstance() {
        if (retrofit == null) {
            retrofit = new Retrofit.Builder()
                    .baseUrl(BASE_URL) // Ορισμός βασικής διεύθυνσης URL
                    .addConverterFactory(GsonConverterFactory.create()) // Προσθήκη μετατροπέα
                    .build();
        }
        return retrofit;
    }

    public static ApiService getApiService() {
        return getRetrofitInstance().create(ApiService.class); // Δημιουργία στιγμιότυπου API
    }
}

Εκτέλεση αιτημάτων:

// Σε Activity, Fragment ή ViewModel
import retrofit2.Call;
import retrofit2.Callback;
import retrofit2.Response;

// ...

ApiService apiService = RetrofitClient.getApiService();

// Ασύγχρονο αίτημα για λήψη χρήστη με ID
Call<User> userCall = apiService.getUser(1);
userCall.enqueue(new Callback<User>() { // enqueue για ασύγχρονη εκτέλεση
    @Override
    public void onResponse(Call<User> call, Response<User> response) {
        if (response.isSuccessful() && response.body() != null) {
            User user = response.body();
            // Επεξεργασία ληφθέντος χρήστη
        } else {
            // Επεξεργασία σφάλματος (π.χ., response.code(), response.errorbody())
        }
    }

    @Override
    public void onFailure(Call<User> call, Throwable t) {
        // Επεξεργασία σφάλματος δικτύου ή άλλης εξαίρεσης
        t.printStackTrace();
    }
});

// Ασύγχρονο αίτημα για λήψη λίστας δημοσιεύσεων
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();
            // Επεξεργασία λίστας δημοσιεύσεων
        } else {
            // Επεξεργασία σφάλματος
        }
    }

    @Override
    public void onFailure(Call<List<Post>> call, Throwable t) {
        // Επεξεργασία σφάλματος
        t.printStackTrace();
    }
});

Το Retrofit απομονώνει τις χαμηλού επιπέδου λεπτομέρειες της εργασίας με HTTP, επιτρέποντάς σου να εστιάσεις στη λογική της εφαρμογής.

Τι είναι το Retrofit και πώς χρησιμοποιείται στην ανάπτυξη Android;