معرفی و استفاده Retrofit در Kotlin

A type-safe HTTP client for Android and Java

این جمله معرفی کننده Retrofit در سایت رسمی و گیت هاب این محصول است. و مضمون آن به این معنی است که. Retrofit یک واسطه یا کلاینت برای ایجاد درخواست های Http در java و android است.(شامل Kotlin و Java). اصلاح type-safe هم به این معناست که در حین اجزا درخواست ها، انواع داده (int, string,... ) را نیز مدیریت می کند.

کاربرد Retrofit برای اتصال به سرویس های مبتنی بر REST است. در Retrofit اصولا برای دِسریالاز داده ها از Json و GSon استفاده می شود. اما در صورت تمایل شما می توانید از انواع دیگر هم استفاده کنید. همانند تبدیل گر XML.

ما در اینجا طرز استفاده Retrofit در Kotlin را توضیح خواهیم داد. منطق استفاده از Retrofit بسیار ساده است. البته توصیه می کنیم قبل از استفاده بیزینسی از Retrofit حتما داکیومنت اصلی آن را مطالعه کنید. چون در این مبحث من سعی داریم خیلی خلاصه و سریع Retrofit را توضیح بدهم.

راه اندازی و استفاده Retrofit در Kotlin

1- راه اندازی

در قدم اول باید تنظیمات اولیه را انجام داد. یعنی افزودن وابستگی در gradle. سپس افزودن اجازه دسترسی اینترنت.

برای اجازه دسترسی اینترنت. متن زیر را در AndroidManifest.xml کپی کنید.

برای افزودن وابستگی کد زیر را در build.gradle قرار دهید.

2- استفاده از کتابخانه

حالا برای استفاده از این کتابخانه باید در مرحله اول یک interface برای ارتباط با سرور بسازید. سپس برای اینکه بتوانید json های دریافتی را به یک مدل مشخص و مد نظر تبدیل بکنید. باید تعدادی هم data class بسازید. و در آخر هم می توانید با صدا کردن inteface ساخته شده. با Rest api خود ارتباط بگیرید.

این کدی که در زیر قرار داده ام یک نمونه از نرم افزار LS1 است. که در گیت هاب نیز نمونه کامل کد آن قرار داده است.

کد بالا interface ما را نشان میدهد. که بوسیله attribute های موجود در بالای هر متد. به Retrofit معرفی شده است.

کد بالا هم، کدی است که باید در متد onCreate اکتیویتی خودمون قرارش بدیم. تا اتصال برقرار شود. در این کد خط های 5 تا 8 معرفی مدل ها یا data class های مارا بر عهده دارند. تا json دریافتی به کلاس مد نظر ما تبدیل شود. خط های 17 تا 21 وظیفه ساخت یک نمونه از interface و ارتباط آن به retrofit را بر عهده دارد. و خط ها 27 الی آخر طریقه صدا زدن api را نشان می دهد.

جمع بندی

در این مقاله من سعی کردیم خیلی سریع برای شما یبک پروژه مبتنی بر retrofit را راه بی اندازم. در صورتی که علاقه مندید بیشر با طرز کار این کتابخانه آشنا شوید. توصیه می کنم مطلب موجود در سایت vogella را بخوانید. یا آموزش زیر را در Youtube دنبال کنید.

Retrofit Tutorial #1 - Basic Concepts [Retrofit with Android Studio]

همچنین جهت اطلاع علاقه مندان به دنیای OpenSource. کد اصلی این کتابخانه هم در گیت هاب خود شرکت توسعه موجود است. چک کردنش خالی از لطف نیست.

Square Retrofit

به نظر شما دیگر چه کتابخانه هایی مناسب استفاده در اندروید هستند؟ نظرات خودتون را برای ما به اشتراک بگذارید.

همچنین به نظرم مقاله کتاب هایی که هر برنامه نویس باید بخواند را هم از دست ندید. خیلی بکار برنامه نویس ها میاد.

ممنون از همراهی شما.

برنامه نویس وظیفه. داریان