البدء السريع لـ Java

يوضح لك هذا المشروع كيفية تنفيذ طريقة Glassware الذي يعرض الوظيفة الرئيسية لواجهة برمجة تطبيقات Google Mirror.

للاطّلاع على عرض توضيحي يعمل بشكل كامل لمشروع البدء السريع، انتقِل إلى https://glass-python-starter-demo.appspot.com. أو يمكنك متابعة القراءة لمعرفة كيفية نشر الإصدار الخاص بك.

التنزيل من GitHub

المتطلبات الأساسية

تأكد من أن نظامك يلبي المتطلبات الأساسية التالية لمشروع البدء السريع:

  • إصدار Java 1.6
  • Apache Maven: يُستخدم في إطار عملية التصميم.

إنشاء مشروع على Google APIs Console

بعد ذلك، فعِّل الوصول إلى Google Mirror API:

  1. انتقِل إلى وحدة تحكُّم Google APIs وأنشئ مشروع واجهة برمجة تطبيقات جديدًا.
  2. انقر على الخدمات وفعِّل Google Mirror API لمشروعك الجديد. واجهة برمجة التطبيقات Google Mirror API على وحدة التحكم في واجهة Google API
  3. انقر على الوصول إلى واجهة برمجة التطبيقات وأنشِئ معرِّف عميل OAuth 2.0 لتطبيق ويب. قسم الوصول إلى واجهة برمجة التطبيقات في وحدة تحكم واجهة برمجة تطبيقات Google
  4. حدد اسم المنتج ورمزه لـ Glassware. تظهر هذه الحقول في طلب منح بروتوكول OAuth. الشاشة المقدمة للمستخدمين. تحديد معلومات العلامة التجارية
  5. اختَر تطبيق الويب وحدِّد أي قيمة لاسم المضيف، مثل localhost. اختيار نوع التطبيق
  6. انقر على تعديل الإعدادات... لمعرِّف العميل لتحديد معرِّفات الموارد المنتظمة (URI) لإعادة التوجيه. تحديد عناوين URL لمعاودة الاتصال لخادم الويب الخاص بالتطوير المحلي، على سبيل المثال http://localhost:8080/oauth2callback لخادم الويب المنشور، على سبيل المثال https://example.com/oauth2callback. لوحة إعداد وحدة تحكُّم واجهة برمجة تطبيقات Google لمعرّفات الموارد المنتظمة (URI) لإعادة التوجيه
  7. دوِّن معرِّف العميل وسره من وحدة تحكُّم Google APIs. ستحتاج إلى لتهيئة مشروع البدء السريع. معرّف العميل وسره على وحدة تحكم واجهة برمجة تطبيقات Google

تهيئة مشروع البدء السريع

اضبط مشروع البدء السريع لاستخدام معلومات عميل واجهة برمجة التطبيقات من خلال إدخال معرّف العميل المفتاح إلى src/main/resources/oauth.properties:

    # Replace these with values for your project from the Google API Console:
    # https://developers.google.com/console

    client_id=3141592653589793238462643383279
    client_secret=ITS_A_SECRET_TO_EVERYBODY

استيراد المشروع

توضح الإرشادات التالية كيفية استيراد مصدر مشروع البدء السريع إلى IntelliJ الكسوف.

IntelliJ

  1. انقر على ملف > استيراد المشروع....
  2. أشِر إلى الدليل المستخرَج.
  3. اختَر استيراد من النموذج الحالي >. Maven

الكسوف

  1. ثبِّت المكوّن الإضافي m2e لتفعيل الاستيراد من ملف pom maven.
  2. انقر على ملف > استيراد... > Maven > مشروع Maven الحالي:
  3. أشِر إلى الدليل الذي تم استخراجه ثم استورِد المشروع.

تشغيل خادم تطوير محلي

يمكنك تشغيل مشروع البدء السريع على خادم تطوير محلي للاختبار:

$ mvn jetty:run

نشر مشروع البدء السريع

يمكنك إنشاء ملف حربي لهذا المشروع باستخدام Maven:

$ mvn war:war