اختبار واجهات برمجة التطبيقات المخصصة

في Oracle Mobile Hub، يمكنك اختبار واجهات برمجة التطبيقات المخصصة قبل نشرها باستخدام البيانات الوهمية. يمكنك أيضًا اختبار موصلات REST باستخدام صفحة الاختبار التي تدعم وضعين: الاختبار القياسي والاختبار المتقدم.

اختبار واجهة برمجة تطبيقات مخصصة لـ Oracle Mobile Hub

لاختبار واجهة برمجة التطبيقات المخصصة مباشرة من Oracle Mobile Hub:

1. سجل الدخول إلى Oracle Mobile Hub.
2. انقر على أيقونة القائمة ثم وسّع التطوير وانقر على الواجهات الخلفية.
3. حدد الواجهة الخلفية للأجهزة المتنقلة وانقر على فتح.
4. انقر على الإعدادات في شريط التنقل الأيسر.
5. انسخ عنوان URL من نقطة نهاية مقطع SSO الموجودة ضمن عناوين URL للبيئة.
6. ألصق عنوان URL المنسوخ في نافذة متصفح ويب، ولكن لا تضغط على مفتاح Enter.
7. انسخ معرف العميل الموجود ضمن قسم OAuth المستهلك.
8. أضف معلمة سلسلة استعلام إلى عنوان URL لنقطة نهاية مقطع SSO الذي قمت بلصقه في مستعرض الويب بالشكل?clientID=[YourClientID]، ثم اضغط على مفتاح Enter. يبدو مثالاً على عنوان URL كما يلي:

   https://<YourSSOTokenEndpointURL>?clientID=<yourClientID>

   سيعرض لك المتصفح مقطع OAuth لتسجيل الدخول الموحد.
9. في نافذة واجهة المستخدم الخلفية للأجهزة المحمولة، انقر على صفحة واجهات برمجة التطبيقات الموجودة في التنقل الأيسر. سيتغير المتصفح من صفحة الإعدادات إلى صفحة واجهات برمجة التطبيقات.
10. انقر على تحديد واجهات برمجة التطبيقات.
11. انقر على اسم API الذي تريد اختباره. يتم فتح صفحة جديدة تعرض نقاط نهاية واجهة برمجة التطبيقات على التنقل إلى اليسار بالإضافة إلى علامتي التبويب الطلب والاستجابة.
12. انقر على نقطة الانتهاء التي تريد اختبارها.
13. ضمن قسم التصديق، حدد مقطع تسجيل الدخول المفرد من طريقة التصديق.
14. انسخ مقطع الدخول الموحد OAuth والصقه في حقل مقطع الدخول الموحد.
15. انقر على اختبار نقطة الانتهاء. إذا كان كل شيء صحيحًا، فسيستجيب الخادم بالحالة 200، وستظهر بيانات JSON في الاستجابة.

اختبار نقاط انتهاء API باستخدام البيانات الوهمية

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

في المثال FixItFast، تتيح لك البيانات الوهمية في نص الاستجابة التحقق مما إذا كان يتم إرجاع معلومات العميل الصحيحة. فيما يلي مثال على البيانات الوهمية التي يمكن لمطور الخدمة تكوينها لنص الاستجابة لعملية POST الخاصة بالمورد contact في المثال FixItFast:

{
 "id": 20934,
 "title": "Lynn's Leaking Water Heater",
       "contact": {
       "name": "Lynn Adams",
       "street": "45 O'Connor Street",
       "city": "Ottawa",
       "postalcode": "ala1a1"
       "username":"johneta"
       }
 "status": "new",
 "driveTime": 30,
 "priority": "high",
 "createdon": "2015-04-23 18:12:03 EDT"
}

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

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

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

اختبار الواجهة البرمجية للتطبيق لموصل REST

بعد أن قمت الآن بتحديد الواجهة البرمجية للتطبيق لموصل REST وحفظ التكوين، ستحتاج إلى التحقق من قدرتك على إرسال طلب وتلقي النتائج المتوقعة من خدمة الويب. يعد اختبار الاتصال خطوة اختيارية ولكن يمكن أن يوفر لك الوقت من خلال تحديد المشكلات وإصلاحها الآن قبل إنهاء واجهة برمجة تطبيقات الموصل. تتيح لك صفحة الاختبار اختبار نقطة انتهاء واحدة في كل مرة.

إذا قمت بتوفير واصف، لديك وضعان للاختبار للاختيار من بينهما:

• الاختبار القياسي

  في حالة إدخال بيانات تعريف الواصف، يتم عرض وضع الاختبار القياسي الذي يتم فيه إنشاء نصي الطلب والاستجابة من بيانات التعريف الوصفية وعرضهما في علامتي التبويب طلب واستجابة. كل ما عليك القيام به هو تحديد المعلمات لاختبار أساليب GET وتضمين أي رؤوس HTTP تريد اختبارها بها.

• اختبارات متقدمة

  يمكنك تنقيح الاختبار عن طريق تحديد الاختبار في الوضع المتقدم (وضع الاختبار الذي تدخله إذا قمت بإدخال عنوان URL لخدمة بعيدة). بدون بيانات تعريف وصفية، يمكنك تحديد الأسلوب والمورد المطلوب اختبارهما وتضمين أية رؤوس HTTP تريد تضمينها وتكوين نص JSON يدويًا.

اختبار في الوضع المتقدم

تتيح لك صفحة الاختبار المتقدم تعيين معلمات المسار يدويًا وإضافة رؤوس وحمولات الطلب والاستجابة.

لتكوين اختبار موصل يدويًا:

1. انقر على ارتباط التنقل اختبار.
2. إذا قمت بتوفير واصف، فقم بتشغيل اختبار في الوضع المتقدم إلى On.

   يتم عرض صفحة الاختبار المتقدمة تلقائيًا إذا قدمت عنوان url للخدمة عن بُعد.

3. حدد أسلوب HTTP الذي تريد اختباره من القائمة المنسدلة.
4. حدد أية معلمات مسار موارد في حقل معرف URI المحلي حسب الحاجة لأغراض الاختبار. على سبيل المثال:

   directions/json?origin=los+angeles&destination=seattle

   يبدأ الحقل تلقائيًا بعنوان URI المحلي الذي قمت بتعريفه عند إدخال اسم API. بعد مثالنا، ستبدو المحتويات الكاملة للحقل كما يلي:

   myMapAPI /directions/json?origin=los+angeles&destination=seattle

   لاحظ أنه في حالة تعريف أية قواعد، يعرض حقل "القواعد المطبقة" (أسفل حقل "النص") الأرقام المطابقة للقواعد القابلة للتطبيق على العملية المحددة. يعرض حقل عنوان URL البعيد السلسلة الدقيقة التي سيتم تمريرها إلى خدمة الاختبار.

5. إضافة رأس HTTP لطلب أو استجابة واحد أو أكثر حسب الحاجة.

   هذه الرؤوس لأغراض الاختبار فقط ولن تتم إضافتها إلى تكوين الواجهة البرمجية للتطبيق لموصل REST الخاص بك.

6. انقر في حقل نص HTTP لتكوين نص الرسالة (الحمولة) في محرر المصدر.
   على سبيل المثال:

   {
     "status":"ZERO_RESULTS",
     "routes":[ ]
   }

   احتفظ بمحتوى نص الرسالة ذي الصلة بالغرض من الموصل، أي لا تضغط على الرسالة بإضافة بيانات غريبة. يؤدي تضمين البيانات ذات الصلة فقط في نص الرسالة إلى تسهيل الإرسال السريع للطلب أو الاستجابة.

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

   باستخدام سياسات الأمان المستندة إلى SAML، يتم نشر هوية المستخدم الذي يقوم بالاستدعاء إلى الخدمة الخارجية. بالنسبة إلى أنظمة الأمان الأخرى مثل تصديق HTTP الأساسي ورمز اسم المستخدم المميز، يتم توفير الصلاحيات المستخدمة للتصديق مع الخدمة الخارجية في تجاوزات النظام كمفاتيح CSF. تبعًا للعملية التي حددتها، قد تضطر إلى إدخال بيانات اعتماد محددة لكل عملية أو قد تتمكن من استخدام مجموعة واحدة من بيانات الاعتماد لكل الطرق لمصادقة الموصل الخاص بك مع الخدمة.

8. انقر على حفظ كصلاحيات افتراضية لواجهة خلفية جوال حالية لحفظ اسم المستخدم وكلمة السر اللذين أدخلتهما كصلاحية افتراضية.
9. إذا كنت في مرحلة تصميم تكوين الموصل وتريد فقط معرفة ما إذا كانت نقاط الانتهاء صالحة، فانقر على صلاحيات اختبار مصمم واجهة برمجة التطبيقات الافتراضية وحدد واجهة خلفية متنقلة قمت بالتسجيل بها ورقم إصدارها.
   اختياريًا، يمكنك إدخال بيانات صلاحية مستخدم الجوال (اسم المستخدم وكلمة السر).

   بيانات صلاحية الاختبار الافتراضية هذه دائمة عبر كل الأساليب التي تقوم باختبارها. تظل صالحة خلال جلسة عمل مركز الأجهزة المتنقلة الحالية.

10. انقر على نقطة نهاية الاختبار.

    يتم تبديل نقطة نهاية الاختبار إلى إلغاء الاختبار عند النقر عليه. إذا أردت إيقاف الاختبار لأي سبب، انقر على إلغاء الاختبار.

    انقر على إعادة تعيين لمسح الحقول وتعديل معلمات الاختبار.

11. انقر على تم عند الانتهاء من اختبار نقاط الانتهاء.