مكتبات Swift #1.1 : الإتصال بالسيرفر والتعامل مع بيانات JSON بإستخدام Alamofire

بسم الله سوف نبدأ هذه السلسلة من الشروحات والتي تختص بمكتبات Swift والبرمجة للـ IOS وإذا كنت لا تعلم كيف التعامل مع المكتبات وماهي فائدتها أطلع على موضوعي السابق COCOAPODS ماهي وما فائدتها وكيف تستخدمها ، سوف نخصص هذه السلسلة لشرح آفضل وأهم المكاتب للسويفت وتطوير IOS والتي تساعد الكثير وتسهل الكثير من العمل وتخرج لك بنتائج ممتازة وأكثر ثبات وسرعة .

swift Logo

وبداية سوف نبدأ مع أهم الأجزاء للتطبيقات وهو الإتصال بالسيرفر والتعامل مع بيانات JSON المرسلة من السيرفر ولذلك سوف نستخدم أفضل المكاتب Swift في هذا المجال وهي مكتبة Alamofire

Alamofire

مستوى الدرس : متوسط
ماهي Alamofire ولماذا ؟ 

مكتبة مبرمجة بالكامل بلغة Swift مختصة بالتواصل والإتصال مع السيرفرات والمواقع لإستقبال وإرسال البيانات من وإلى تطبيقك .

لماذا ؟ : لا تخلو معظم التطبيقات من التواصل مع السيرفر وكما يسمى ServerSide لكي يتم تخزين البيانات على السحاب وإستقبال البيانات من السحاب إذا كان التطبيق يحتاج ذلك .

واليوم لن نشرح كيفية إنشاء ServerSide ولكن لقد تطرقنا لها في عدة مواضيع ماذا قبل أغلاق خدمة Parse السحابية وماهي أفضل الخدمات الأخرى ، الجزء الأول و ماذا قبل أغلاق خدمة Parse السحابية وماهي أفضل الخدمات الأخرى ، الجزء الثاني .

تحميل وتثبيت  Alamofire : 

سوف يتم إستخدام COCOAPODS لهذه المهمه وإن لم تكن على معرفة بكيفية إستخدامها مشكلتك والله 😆 أمزح راجع موضوعي COCOAPODS ماهي وما فائدتها وكيف تستخدمها .

ببساطة في ملف podfile الخاص بالمشروع الذي نود العمل عليه سوف نستدعي

pod 'Alamofire', '~> 3.4'

بعدها نقوم بتشغل الأمر Pod Install من Terminal .

 الأن هي جاهزه للإستخدام داخل ملفات مشروعك وكما هو متعارف أن أفضل طريقة للتعلم هي التطبيق على مثال لذلك سوف نعمل على مثال وهو تطبيق بسيط لجلب درجات الحرارة والمناخ من API جاهز وفي هذا الجزء سوف نتعلم إستقبال البيانات فقط وبإذن الله بالجزء القادم إرسال البيانات وبعدها سوف يتبعها أجزاء أكثر تقدم .

 جلب البيانات من API :  

ولهذه المهمه سوف نستخدم API جاهز ومجاني من موقع openweathermap.org ولكن عليك الحصول على key خاص بك وتستطيع التسجيل والحصول على واحد خاص أو إستخدام المفتاح الخاص بنا والواضح بالشرح .

بعد قراءة بسيطة لشرح API الخاص بجلب المناخ الحالي من هنا توصلنا إلى الرابط التالي

api.openweathermap.org/data/2.5/weather?id=105343&units=metric&APPID=071913a041f022290a6651f463045c65

ولكي تعلم ماذا حصل في هذا الرابط ولكي تأخذ فكرة هنا شرح مبسط عن المتغيرات التي وضعتها بالرابط

APiURL

عند فتح الرابط على المتصفح أو أفضل إستخدام تطبيق PostMan لمحاكاة وتجربة الطلبات على APIs سوف نجد النتيجة التالية :

نعم هذه بيانات بصيغة JSON وهذا المطلوب لكي نتعامل معاه بتطبيقنا على IOS والأن سوف نبدأ بتجهيز تطبيقنا والواجهات وإستدعاء مكتبة Alamofire .

تجهيز تطبيق IOS وربط البيانات :

لن أتطرق لكيفية إنشاء تطبيق جديد ووضع Labels وتزبيط الواجهه على إفتراض إنك بمستوى متوسط وتعلم هذه الأمور لتصميم الواجهات عن طريق Xcode .

 قمت بتصميم هذه الواجهه البسيطة لتطبيق IOS بإستخدام Xcode وبالمناسبة الخلفية من تصويري في 2012  😛  فرصه سعيدة   😆

mainScreen

 وضعت البيانات بشكل وهمي والأن سوف نقوم بربطها بالسيرفر والمعلومات المعطاه من JSON

بدايةً لابد من إستدعاء المكتبة عن طريق الأمر import Alamofire

الأن سوف نقوم بربط Labels من  StoryBoards للكود الخاص بنا

 conectOutlet

نحن الأن جاهزين للتعامل مع المكتبة وإستخدامها

سوف أقوم بإنشاء دالة تقوم بجلب البيانات لي وسوف أسميها getDataFromUrl

ومن ثم سوف أستخدم المكتبة لإرسال الطلب إلى الرابط وإستقبال البيانات المرسله من الرابط

METHOD : هنا نضع نوع الطلب مثلا GET أو POST أو غيرهم .

URL : نضع الرابط الخاص بنا والذي قمنا بإستنتاجه سابقا من موقع المناخ .

ليصبح معنا بالشكل التالي

 الأن البيانات التي نريدها سوف تكون داخل response  ولكن لن تكون بصيغة JSON واضحة نستطيع الوصول لها بسهوله لذلك وبإستخدام دوال نفس المكاتبة سوف نخبره بأني يأتي لنا بقيم النتيجة فقط وترك الباقي وهذا ما نحتاجه

الأن بمتغير JSON توجد القيم التي نحتاجها والتي أشرنا إليها سابقاً

وليس علينا سوا الوصول لها من متغير JSON ولأن تطبيقنا يوجد فيه فقط ثلاث بيانات وهي درجة الحرارة و نسبة الرطوبة و سرعة الرياح ،  لذلك من هذه البيانات لن نحتاج إلا لـ temp , humidity , speed

ولكن لو نلاحظ إنها تقع تحت قيم أخرى ف مثلا temp و humidity نجدها إنها توجد داخل قيمة main وايضا سرعة الرياح speed توجد داخل قيمة wind والسؤال الأن كيف يمكننا الوصول لهذه القيم مباشرة وترك الباقي ؟

دعنا نتخليها كأنها أسماء بشر الجد هو المتغير الكبير JSON من ثم نذهب إلى الإبن فمثلاً نذهب إلى الأبن main لنجد إنه لديه أطفال من ضمنهم الطفل temp

لذلك يصبح إسم temp التالي ” temp بن main بن JSON ال Alamofire ” والنعم والله 😆  ههههه المهم

لذلك لكي نصل إلى temp علينا المرور على الأب أولا وذلك يتم بالكود على الطريقة التالية :

JSON["main"]["temp"] 

أي سوف يصبح كود Swift كالتالي :

قد يخطر ببالك سؤال لماذا وضعت علامات ! بعد main وبعد temp في لغة swift علامة ! تعني force unwrap يعني  تأكيد أن هناك قيمة حقيقه اي إنني أأكد على السويفت بأن JSON يوجد لها أبناء على شكل arrays ولها خاصة إبن إسمه main أكيد والله وإنو كمان main هي عبارة عن array و لها آبن إسمه temp أكيد .

طيب ماذا لو نحن غير متأكدين من حضور القيمة لأي سبب من الأسباب لذلك وضعنها في جملة شرطية بحيث إنه في حال وجود القيمة إنشيء لي المتغير temp وضع القيمه فيه وفي حال عدم وجود قيمة لا تفعل شيء

الأن عند تشغيل التطبيق سوف تكون النتيجة : 27.22   ممتاز

المفترض الآن تعلم كيف إحضار باقي القيم الخاصة بنسبة الرطوبة وسرعة الرياح هيا حاول ولا تغش من تحت  😉

إذا ما عرفت 

AbuHmdan

موشكلة

طيب ، دعنا نتابع عند وضع باقي القيم سوف يصبح الكود كالتالي :

ممتاز الأن عند التشغيل سوف تظهر لنا القيم الثلاثه في Console أتوقع تعلم كيف وضعها داخل labels بدل القيم الوهميه التي وضعناها ؟ لا تعلم لا مشكلة

قمنا سابقا بربط labels في الكود وذلك عن طريق إنشاء outlets لها والآن ليس علينا سوا تغير قيمها بالطريقة التاليه

self.temp.text = String(tempe)

ولابد أن نقوم بعمل cast لقيمة temp لتصبح String لأن بالآساس القيمة غير معروف نوعها ولأن labels لا يقبل سوا قيم String فكان لابد من عمل Casting لها كما هو موضح بالكود السابق .

وبعد وضع قيم الجميع سوف يصبح كود الدالة كالتالي مع شوية تعديلات لنظهر الوحدات  :

لا تنسى إستدعاء الدالة في دالة viewDidLoad  أي سوف يصبح الكود بشكل كامل كالتالي :

الأن عند تشغيل التطبيق على Simulator

JeddahWeatherApp

واااو نسبة الرطوبة عندنا بجدة 100% !! أتوقع الموقع غلطان شوي  😆

إلي هنا وصلنا إلى نهاية هذا الدرس أتمنى من الله ان تكون أستفدت منه ما ترجوه وبإذن الله يوجد عدة دروس تابعة لمكتبة  Alamofire وسوف نتعمق بها بشكل أكبر ومن ثم بإذن الله سوف نتقل لعدة مكاتب مهمه ورائعه تسهل من عملك الكثير .

رابط تحميل المشروع لمن يحتاجة 

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

سبحانك اللهم وبحمدك , أشهد أن لا إله إلا أنت , أستغفرك وأتوب إليك ..

الرابط المختصر للموضوع : xd7.me/18

قد يهمك ايضاً

ماذا قبل أغلاق خدمة Parse السحابية وماهي أفضل الخد... أستيقظ مطورين التطبيقات يوم 28/jan للعام 2016 على أحد أسوء الأخبار التقنية وخاصة لمستخدمين خدمة parse والذي أتت خلاصته على لسان المدير التنفيذي للخدمة...
Xamarin برمج تطبيقك IOS و Android بلغة #C بكامل ال... لا أعلم ما حجتك بعد الأن في عدم البدء بتعلم البرمجة وخاصة برمجة تطبيقات الجوال ! فكل السبل تيسرت ، سابقاً كان من المستحيل أن يستطيع مستخدم لنظام ويندو...
مكتبات Swift #1.2 : إرسال البيانات من التطبيق إلى ... نستكمل سوياً الجزء الثاني من مكتبة Alamofire وقد تعلمنا سابقاً على كيفية إستقبال البيانات من السيرفر بصيغة JSON والتعامل معاها داخل تطبيقنا مكتبات Swi...
ماذا قبل أغلاق خدمة Parse السحابية وماهي أفضل الخد... اليوم سوف نستكمل سوياً ما بدأناه في موضعي السابق  ماذا قبل أغلاق خدمة Parse السحابية وماهي أفضل الخدمات الأخرى ، الجزء الأول  فإذا لم تتطلع عليه أنصحك...

التعليقات

  1. وائل كلنتن

    15 أكتوبر، 2016 at 2:49 م

    ما شاء الله ’ الشرح دسم ’ ويعطيك العافية

    و انتظر منك المزيد

  2. جزاك الله خير، شكراً على مجهودك.

اترك تعليقاً

لن يتم نشر بريدك الإلكتروني

*