Đây là một cách triển khai tham chiếu của Máy chủ đặt phòng API phiên bản 3 để tích hợp tiêu chuẩn dựa trên Node.js
Điều kiện tiên quyết
Bạn cần cài đặt
Bắt đầu
Máy chủ đặt phòng được triển khai bằng Node.js tiêu chuẩn mà không có bất kỳ thư viện hoặc khung bổ sung nào, cho mục đích minh hoạ. Nếu đang sử dụng bất kỳ khung nào khác, bạn có thể dễ dàng thay đổi việc triển khai này thành Express.js, MEAN.js hoặc bất kỳ khung dựa trên Node.js nào khác mà bạn chọn.
Quá trình triển khai cũng không sử dụng các thư viện bộ đệm giao thức, mà thay vào đó dựa vào quá trình chuyển đổi tuần tự JSON đơn giản và các phương thức JSON.parse() và JSON.stringify().
Để tải dự án xuống, hãy thực thi lệnh sau:
git clone https://maps-booking.googlesource.com/js-maps-booking-rest-server-v3-skeleton
Toàn bộ cơ sở mã chỉ bao gồm 2 tệp JavaScript:
- bookingserver.js – Máy chủ HTTP và logic xử lý yêu cầu, bao gồm cả xác thực
- apiv3methods.js – các phương thức triển khai giao diện API phiên bản 3
Sau khi tải tệp xuống, bạn có thể khởi động Máy chủ đặt phòng bằng cách chạy lệnh:
node bookingserver.js
Khung này ghi tất cả các yêu cầu đến và đi vào bảng điều khiển, vì vậy bạn có thể theo dõi quá trình thực thi của khung cho mục đích theo dõi.
Nếu cần một IDE để thay đổi mã hoặc gỡ lỗi, bạn có thể sử dụng Visual Studio Code hoặc bất kỳ trình chỉnh sửa nào khác mà bạn chọn. Gỡ lỗi dự án bằng cách bắt đầu bookingserver.js trong môi trường Node.js và đặt điểm ngắt khi cần.
Kiểm thử Máy chủ đặt phòng
Tải Tiện ích kiểm thử đặt phòng xuống. Để cài đặt, hãy làm theo hướng dẫn cài đặt được cung cấp trong trang README của công cụ này.
Đối với các bài kiểm thử, bạn cần tạo một tệp văn bản để lưu trữ thông tin đăng nhập của mình. Nhập tên người dùng và mật khẩu trên một dòng, ví dụ: trong một tệp có tên cred.txt:
username:password
Bạn cũng cần có một bản sao cục bộ của nguồn cấp dữ liệu Tình trạng còn hàng cho người bán thử nghiệm. Trong các lệnh mẫu bên dưới, nguồn cấp dữ liệu về tình trạng còn hàng là avail.json.
Bây giờ, bạn có thể kiểm tra Máy chủ đặt phòng bằng các lệnh sau:
- Kiểm thử các lệnh gọi đến phương thức HealthCheck:
bin/bookingClient -server_addr="localhost:8080" -health_check_test=true -credentials_file="./cred.txt"
- Gọi kiểm thử đến phương thức CheckAvailability:
bin/bookingClient -server_addr="localhost:8080" -check_availability_test=true -availability_feed="./avail.json" -credentials_file="./cred.txt"
- Kiểm thử các lệnh gọi đến phương thức CreateBooking và UpdateBooking:
bin/bookingClient -server_addr="localhost:8080" -booking_test=true -availability_feed="./avail.json" -credentials_file="./cred.txt"
Khi triển khai Máy chủ đặt phòng của riêng mình, bạn có thể cần chạy các kiểm thử bổ sung đối với máy chủ đó (ví dụ: list_bookings_test, rescheduling_test, v.v.) với mục tiêu là tất cả các kiểm thử đều vượt qua (-all_tests=true).