این یک پیاده سازی مرجع API v3 Booking Server برای یکپارچه سازی استاندارد بر اساس 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
کل پایه کد فقط از دو فایل جاوا اسکریپت تشکیل شده است:
- bookingserver.js - سرور HTTP و منطق رسیدگی به درخواست ها، از جمله احراز هویت
- apiv3methods.js - روش های پیاده سازی رابط API v3
پس از دانلود فایل ها، می توانید با اجرای دستور، سرور رزرو را راه اندازی کنید:
node bookingserver.js
اسکلت تمام درخواست‌های ورودی و خروجی را به کنسول می‌نویسد، بنابراین می‌توانید اجرای آن را برای اهداف ردیابی نظارت کنید.
اگر برای تغییر کد یا اشکال زدایی به IDE نیاز دارید، می توانید از Visual Studio Code یا هر ویرایشگر دیگری که انتخاب می کنید استفاده کنید. پروژه را با شروع bookingserver.js در محیط Node.js اشکال زدایی کنید و در صورت نیاز نقاط شکست را تعیین کنید.
تست سرور رزرو شما
دانلود ابزار آزمون رزرو . برای نصب آن، دستورالعمل های نصب ارائه شده در صفحه README آن را دنبال کنید.
برای تست ها، باید یک فایل متنی برای ذخیره اعتبار خود ایجاد کنید. نام کاربری و رمز عبور خود را در یک خط به عنوان مثال در فایلی به نام cred.txt وارد کنید:
نام کاربری: رمز عبور
شما همچنین به یک نسخه محلی از فید در دسترس بودن برای بازرگانان آزمایشی خود نیاز دارید. در دستورات نمونه زیر، فید Availability 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).