Ի՞նչ է Retrofit-ը և ինչպես է այն օգտագործվում Android զարգացման մեջ։

Retrofit — դա type-safe հաճախորդ է HTTP հարցումների համար Android և Java-ի համար։ Այն պարզեցնում է REST API-ի հետ փոխազդեցությունը, օգտագործելով annotations՝ հարցումների նկարագրության համար։

Հիմնական առավելությունները՝

• Տիպային անվտանգություն: Հարցումները և պատասխանները ներկայացված են Java (կամ Kotlin) օբյեկտների տեսքով, ինչը նվազեցնում է գործարկման ժամանակ սխալների քանակը։
• Պարզություն օգտագործման մեջ: HTTP մեթոդների հայտարարումը annotations-ով դարձնում է կոդը ավելի ընթեռնելի և պահպանելի։
• Կոնֆիգուրացիա: Հեշտ է ավելացնել interceptors՝ լոգավորման, հաստատման և այլ խնդիրների համար։
• Կոնվերտերների ինտեգրում: Պատրաստ է տարբեր կոնվերտերներ՝ պատասխանների JSON, XML և այլ ձևաչափերով վերլուծելու համար (օրինակ՝ Gson, Jackson)։

Օգտագործում՝

1. Ավելացնել կախվածություններ:

   // build.gradle (հավելվածի մակարդակով)
   dependencies {
       implementation 'com.squareup.retrofit2:retrofit:<latest_version>'
       // Ընտրեք կոնվերտեր ձեր տվյալների համար (այստեղ օրինակ՝ Gson)
       implementation 'com.squareup.retrofit2:converter-gson:<latest_version>'
   }
   

2. API ինտերֆեյսի սահմանում: Ստեղծվում է Java/Kotlin ինտերֆեյս, որը հայտարարում է բոլոր API-ի Endpoint-ները 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
   }
   

3. Retrofit օրինակ ստեղծել:

   // RetrofitClient.java
   import retrofit2.Retrofit;
   import retrofit2.converter.gson.GsonConverterFactory;
   
   public class RetrofitClient {
   
       private static final String BASE_URL = "https://api.example.com/"; // Ձեր API-ի հիմնական URL
       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 ծառայության օրինակ
       }
   }
   

4. Հարցումների կատարմամբ:

   // 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-ի ցածր մակարդակի աշխատանքը, թույլ տալով կենտրոնանալ հավելվածի տրամաբանության վրա։