GridmiAPI - مكتبة Android بسيطة ومرنة للعمل مع REST & RPC

مرحباً يا خبروفيتيس!

عندما تقوم بتطوير تطبيقات الشبكة لنظام أندرويد ، فأنت تفهم أن أحدهما والآخر يشبهان بعضهما البعض. من خلال هذا الفكر ، يقوم غالبية المطورين بتهيئة فكرة أخرى - "لماذا لا أستخدم أي حلول جاهزة ، لأن من الواضح أن مهمتي ليست جديدة؟". من هذه اللحظة ، يبدأ البحث عن مكتبات مناسبة لحل المشكلة الحالية. بعد بعض الوقت - الربح. يبدو أن كل شيء جيد ، لأنه تم العثور على المكتبة وبقيت فقط كتابة تنفيذ لحل المشكلة الحالية. وهنا تبدأ المشاكل. ترتبط بالتحكم في التدفق ، وبالفعل لم يسبق لجافا أن اشتهرت بكثافتها ، يجب أن يقوم المطور بتطبيق "السحر" مباشرةً. أجد أحيانًا جوانب إيجابية فقط في هذا ، لأن منطق كل مشروع يختلف جذريًا عن الآخر. يجب عليك دائمًا التبديل من دفق إلى دفق ، وهو أمر غير ملائم للغاية ، كما هو موضح سابقًا ، مرهق. تم تنفيذ حل هذه المشكلة في وقت سابق ، ولكن ليس كما كنا نريد. مكتبة للعمل مع HTTP تأتي لإنقاذ - GridmiAPI . هذا هو الحل الأكثر إحكاما ، والذي بدوره يسمح لك بالعمل مع البيانات في الوقت الحقيقي.

عملية العمل

تبدأ جميع أعمال المكتبة في التهيئة. التهيئة مطلوبة مرة واحدة. التهيئة يشير إلى البناء التالي:

GridmiAPI.init("https://habr.com/API/", 8000, JSONObject.class); 

1. طلب معالجة عنوان نقطة النهاية
2. مهلة استجابة الخادم
3. الفئة التي يجب أن تكون استجابة خادم يلقي

هذا كل شئ! المكتبة جاهزة للاستخدام الكامل.

طلب الخادم الأول

لإكمال الطلب الأول على الخادم ، تحتاج إلى كتابة بضعة أسطر من التعليمات البرمجية والبيانات التي نحتاجها منا. لا تصدق؟ انظر:

 GridmiAPI.onRequest(this, new GridmiAPI.Request("profile/get"), new GridmiAPI.Handler.OUT() { @Override protected void onSuccess(GridmiAPI.Response response) { Log.d("TagGridmiAPI", "result = " + ((JSONObject) response.getData()).toString()); } @Override protected void onFailed(Exception exception) { Log.d("TagGridmiAPI", "exception = " + exception.getMessage()); } }).start(); 

تهانينا! هذا هو "مرحبا العالم!" باستخدام هذه المكتبة. دعونا نلقي نظرة على طريقتين إعادة كتابة للفئة GridmiAPI.Handler.OUT. بادئ ذي بدء ، ينبغي كتابة أن هاتين الطريقتين تدعى في الخيط الرئيسي ، لذلك عند الانتهاء من الطلب ، لا معنى للوصول إلى النشاط لبدء الخيط الرئيسي. أنت فقط تأخذ JSON على سبيل المثال وتغيير نص TextView. كل شيء بسيط.

إرسال الملف إلى الخادم

في كثير من الأحيان لديك لإرسال الملفات إلى الخادم. الصداع مرة أخرى؟ لا مفر مكتبة GridmiAPI تجعل إرسال ملف سهل للغاية دون صداع. خطوط أكثر بقليل مما في المثال أعلاه ، ولكن لا تزال مدمجة. إليك كيفية إرسال ملف:

 @Override protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) { super.onActivityResult(requestCode, resultCode, data); if (data == null || data.getData() == null) return; try { //     GridmiAPI.Request request = new GridmiAPI.Request("POST", "photo/add"); //      GridmiAPI.Multipart multipart = new GridmiAPI.Multipart(getContentResolver()); multipart.appendData("photo", data.getData()); //    request.setBody(multipart); //   GridmiAPI.onRequest(this, request, new GridmiAPI.Handler.OUT() { @Override protected void onSuccess(GridmiAPI.Response response) { try { //      boolean result = ((JSONObject) response.getData()).getBoolean("result"); //  Toast.makeText(MainActivity.this, result ? "!" : "!", Toast.LENGTH_LONG).show(); } catch (Exception exception) { this.onFailed(exception); } } @Override protected void onFailed(Exception exception) { //     Toast.makeText(MainActivity.this, exception.getMessage(), Toast.LENGTH_LONG).show(); } }).start(); } catch (Exception exception) { Toast.makeText(this, exception.getMessage(), Toast.LENGTH_LONG).show(); } } 

استنتاج

درسنا المهام الأكثر شعبية ، بمزيد من التفاصيل يمكنك التعرف على صفحة هذه المكتبة على GitHub - GridmiAPI . من المريح العمل مع هذه المكتبة. تقدير نفسك. شكرا لك على اهتمامك بهذا المقال!

مراجع

مكتبة GridmiAPI
الوثائق / ReadMe.md