זהו הטמעה של קובצי עזר מסוג API v3 Ordering Server for Integration רגיל ו-API v3 Booking Integrat לרשימת המתנה המבוסס על Node.js
דרישות מוקדמות
נדרשת התקנה של
תחילת העבודה
שרת ההזמנות מיושם באמצעות Node.js סטנדרטי ללא ספריות או מסגרות נוספות, למטרות איור. אם נעשה שימוש במסגרות אחרות, ניתן לשנות בקלות את ההטמעה הזו ל-Express.js, MEAN.js או למסגרות אחרות המבוססות על Node.js לבחירתך.
כמו כן, ההטמעה לא משתמשת בספריות מאגר בין פרוטוקולים, אלא בתהליך סידור פשוט של קובצי JSON ובשיטות JSON.parse() ו-JSON.stringify() .
כדי להוריד את הפרויקט, מבצעים את הפקודה הבאה:
git clone https://maps-booking.googlesource.com/js-maps-booking-rest-server-v3-skeleton
בסיס הקוד כולו מורכב משני קובצי JavaScript בלבד:
- Serverserver.js – לוגיקת טיפול בבקשות ובקשות HTTP, כולל אימות
- apiv3methods.js – שיטות להטמעת ממשק API של גרסה 3
אחרי שמורידים את הקבצים, אפשר להפעיל את שרת ההזמנות על ידי הרצת הפקודה:
node bookingserver.js
השלד כותב את כל הבקשות הנכנסות והיוצאות למסוף, כך שניתן לעקוב אחר הביצוע שלו למטרות מעקב.
אם יש צורך בסביבת פיתוח משולבת (IDE) לצורכי שינוי או ניפוי באגים, אפשר להשתמש ב-Visual Studio Code או בכל עורך אחר לבחירתך. כדי לנפות באגים בפרויקט, כדאי להתחיל לעבוד עם orderserver.js בסביבת Node.js ולהגדיר נקודות עצירה לפי הצורך.
בדיקת שרת ההזמנות
מורידים את הכלי לבדיקת הזמנות. כדי להתקין אותו, מבצעים את הוראות ההתקנה שצוינו בדף README שלו.
לצורך הבדיקות, עליכם ליצור קובץ טקסט לאחסון פרטי הכניסה שלכם. מזינים את שם המשתמש והסיסמה בשורה אחת, לדוגמה, בקובץ בשם cred.txt:
username:password
בנוסף, נדרש עותק מקומי של פיד זמינות למוכרים המשתתפים בתוכנית. בפקודות לדוגמה שבהמשך, פיד הזמינות הוא avail.json.
עכשיו אתם יכולים לבדוק את שרת ההזמנות באמצעות הפקודות הבאות:
- בדיקת קריאות לשיטת HealthCheck:
bin/bookingClient -server_addr="localhost:8080" -health_check_test=true -credentials_file="./cred.txt"
- בדיקת קריאות לשיטה CheckAvailability:
bin/bookingClient -server_addr="localhost:8080" -check_availability_test=true -availability_feed="./avail.json" -credentials_file="./cred.txt"
- בדיקת קריאות לשיטות CreateBooking ו-UpdateBooking:
bin/bookingClient -server_addr="localhost:8080" -booking_test=true -availability_feed="./avail.json" -credentials_file="./cred.txt"
בזמן ההטמעה של שרת ההזמנות, ייתכן שיהיה צורך להריץ בדיקות נוספות כדי לבצע אותו (לדוגמה, list_bookings_test, rescheduling_test וכו') כדי לוודא שכל הבדיקות עברו (-all_tests=true) .