الترميز في الظل: استخدام Eclipse مع Google Data APIs

جيف فيشر، فريق Google Data APIs
نيسان (أبريل) 2008

المكون الإضافي الجديد لواجهات برمجة التطبيقات للبيانات في Google Java Client Eclipse : إنشاء مشاريع في ثوانٍ

كمكّمِل لهذه المقالة، يتوفّر مكوّن Eclipse الإضافي لتقليل النفقات العامة المرتبطة بإعداد تبعيات بيانات Google. كما ينشئ أيضًا رمزًا معياريًا للتفاعل مع واجهة برمجة التطبيقات التي تهمك. يوفر هذا طريقة سهلة لبدء التطوير باستخدام واجهات برمجة التطبيقات لبيانات Google.

المقدمة

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

إعداد Eclipse

إذا لم يكن Eclipse مثبتًا لديك حتى الآن، فأنت تفوت هذه الميزة. يمكن أن يجعل Eclipse تطوير جافا أكثر سهولة، نظرًا لقدرته على اقتراح إصلاحات والعثور على عمليات الاستيراد المفقودة وأساليب الإكمال التلقائي. انتقل إلى صفحة التنزيلات في Eclipse.org للحصول على المثبت لنظام التشغيل. لِتَشْغِيلْ Eclipse، لَازِمْ تَثْبِيتْ تَطْبِيقْ JRE مِنْ صَفْحِةْ تَنْزِيلَاتْ Eclipse. بعد تثبيت Eclipse، ستحتاج إلى إنشاء مساحة عمل. تستخدم هذه الأمثلة /usr/local/eclipse/workspace.

تثبيت المكتبات المطلوبة

يوفر Eclipse الكثير من وظائف جافا بشكل فوري، ولذلك من المفترض أن يكون هذا الأمر سهلاً. أولاً، احصل على أحدث إصدار من مكتبة برامج جافا من صفحة التنزيلات بالمشروع. تجدر الإشارة إلى أن هناك تنزيلين منفصلين: أحدهما للعينات، والآخر للشفرة المصدر. نزِّل نماذج ZIP، لأن ذلك يتضمن ملفات JAR المجمّعة من مكتبة برامج Java المطلوبة لإنشاء برامجك الخاصة. إذا كنت مهتمًا بمعرفة كيفية عمل مكتبة العميل نفسها، فيمكنك تنزيل ملف zip المصدر والبحث فيه، ولكن هذا خارج نطاق هذه المقالة. بعد تنزيل نماذج الملفات المضغوطة، عليك فك ضغط الملف إلى دليل مناسب حيث يمكنك العثور على الملفات. تستخدم الأمثلة /usr/local/eclipse. يعني ذلك أنّه يجب الآن الوصول إلى ملفات JAR للمشروع ضمن /usr/local/eclipse/gdata/java/lib.

الآن بعد أن قمت بتثبيت مكتبة العميل، تتمثل الخطوة التالية في تنزيل بعض التبعيات الخارجية حتى نتمكن من تضمينها في مسار إنشاء المشروع. يحتوي ملف INSTALL-samples.txt على قائمة من الأواني التي ستحتاج إليها ومواقع لتنزيلها. القائمة الحالية هي:

اسم الملف الموقع الجغرافي
mail.jar Sun's JavaMail API
activation.jar إطار عمل تفعيل JavaScript من Sun
servlet-api.jar Apache Tomcat

في هذا المثال، يتم تنزيل ملفات JAR هذه ونسخها إلى /usr/local/eclipse/gdata/third_party.

رائع! يجب أن يكون لديك الآن جميع الأجزاء التي تحتاج إليها لبدء تطوير تطبيق جافا يستخدم أحد واجهات برمجة التطبيقات لبيانات Google. يُرجى مواصلة القراءة للاطّلاع على التفاصيل.

إنشاء تطبيق جديد

تتمثل الخطوة الأولى في فتح Eclipse وتحديد "جديد > مشروع جافا" من القائمة "ملف".

كسوف نافذة مشروع جديد

انقر الآن على التالي وحدد علامة التبويب المكتبات. يمكنك إضافة جميع ملفات JAR التابعة التي نزّلتها بالنقر على إضافة ملفات JAR الخارجية.

إضافة JAR بالتبعية

وسيلزمك أيضًا إضافة ملفات JAR من مكتبة برامج جافا. وتتوفّر هذه الملفات في الدليل الفرعي java/lib الذي تم فيه استخراج مكتبة العميل. سيتعين عليك دائمًا تضمين ملفات JAR التالية: gdata-client وgdata-client-meta وgdata-core وgdata-media.

إضافة ملفات JAR JAR

والآن اختر واجهة برمجة التطبيقات التي ترغب في استخدامها. يستخدم هذا المثال واجهة برمجة التطبيقات لقائمة مستندات Google. يتطلب هذا إضافة ملفات JAR المناسبة: gdata-docs وgdata-docs-meta.

جارٍ إضافة ملفات JARLIST في قائمة المستندات

وأخيرًا، يمكنك النقر على "إنهاء" وإنشاء مشروعك الجديد.

المشروع الذي تم إنشاؤه حديثًا

لإنشاء تطبيق اختباري بسيط، أنشئ صفًا جديدًا باستخدام طريقة رئيسية عن طريق تحديد "جديد > صف" من القائمة "ملف".

إنشاء صف

سألصق الآن بعض التعليمات البرمجية من دليل مطوّري البرامج لواجهة برمجة تطبيقات قائمة المستندات.

نموذج رمز به أخطاء

ستظهر لك الكثير من الأخطاء حتى تضيف عبارات الاستيراد المناسبة. يسهّل Eclipse تنفيذ ذلك، فكل ما عليك فعله هو النقر على علامات الخطأ في الجانب الأيمن للحصول على قائمة مفيدة تسمح لك بإضافة عمليات الاستيراد.

قائمة الإصلاحات السريعة

بعد تنظيف عمليات الاستيراد، يجب أيضًا معالجة الاستثناءات التي يمكن إلغاؤها بواسطة الشفرة. يختار المثال إحاطة نموذج الشفرة بالكامل بمعالج استثناء مبدئي.

نموذج رمز يعمل

والآن، بافتراض أنك استبدلت اسم المستخدم وكلمة المرور بحساب اختباري صالح أنشأته، فمن المفترض أن تتمكن من الاطلاع على قائمة بالمستندات التي يملكها ذلك الحساب الاختباري عند اختيار "تشغيل" من القائمة "تشغيل".

مخرجات البرنامج

رائع!

الخاتمة

الآن وبعد أن أصبح لديك مثيل صالح من Eclipse وجميع ملفات JAR المطلوبة، فأنت في طريقك الآن لإنشاء تطبيق جافا رائع يعمل مع أحد واجهات برمجة تطبيقات بيانات Google.

إلى أين أذهب؟ هناك بعض الروابط التي قد تجدها مفيدة:

إنّ Java علامة تجارية لشركة Sun Microsystems, Inc. في الولايات المتحدة وبلدان أخرى.