यह Node.js पर आधारित, स्टैंडर्ड इंटिग्रेशन के लिए API v3 बुकिंग सर्वर का रेफ़रंस इंप्लिमेंटेशन है
ज़रूरी शर्तें
इसे इंस्टॉल करना ज़रूरी है
शुरू करें
बुकिंग सर्वर को स्टैंडर्ड 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 फ़ाइलों से बना होता है:
- bookingserver.js - एचटीटीपी सर्वर और अनुरोधों को मैनेज करने का लॉजिक. इसमें पुष्टि करने की सुविधा भी शामिल है
- apiv3methods.js - methods implementing API v3 interface
फ़ाइलें डाउनलोड करने के बाद, बुकिंग सर्वर को शुरू किया जा सकता है. इसके लिए, यह कमांड चलाएं:
node bookingserver.js
स्केलेटन, कंसोल पर आने वाले और उससे भेजे जाने वाले सभी अनुरोधों को लिखता है, ताकि आप ट्रेसिंग के मकसद से इसके एक्ज़ीक्यूशन पर नज़र रख सकें.
अगर आपको कोड में बदलाव करने या डीबग करने के लिए आईडीई की ज़रूरत है, तो Visual Studio Code या अपनी पसंद का कोई अन्य एडिटर इस्तेमाल किया जा सकता है. Node.js एनवायरमेंट में bookingserver.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).