Đây là cách triển khai tham chiếu cho Máy chủ đặt trước API phiên bản 3 cho Tích hợp tiêu chuẩn dựa trên Node.js
Điều kiện tiên quyết
Yêu cầu cài đặt
Bắt đầu
Để minh hoạ, Máy chủ đặt phòng được triển khai bằng Node.js tiêu chuẩn mà không có thêm thư viện hoặc khung nào. Nếu đang sử dụng bất kỳ khung nào khác, bạn có thể dễ dàng thay đổi cách 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 thư viện vùng đệm giao thức mà dựa vào quá trình chuyển đổi tuần tự JSON đơn giản cũng như 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 hai tệp JavaScript:
- bookingserver.js – máy chủ HTTP và logic xử lý yêu cầu, bao gồm cả việc xác thực
- apiv3method.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 trước bằng cách chạy lệnh:
node bookingserver.js
Khung ghi tất cả các yêu cầu đến và đi vào bảng điều khiển để bạn có thể giám sát quá trình thực thi của khung này 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 khởi động bookingserver.js trong môi trường Node.js và đặt các điểm ngắt (nếu cần).
Kiểm tra máy chủ đặt phòng
Tải xuống Tiện ích kiểm tra lượt đặt trước. Để cài đặt, hãy làm theo hướng dẫn cài đặt được cung cấp trên trang README.
Đối với các chương trình 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 của bạn trên một dòng, ví dụ: trong tệp có tên cred.txt:
tên người dùng:mật khẩu
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 dưới đây, nguồn cấp dữ liệu Tình trạng còn hàng là{/6}.json.
Giờ đây, bạn có thể kiểm tra Máy chủ đặt phòng bằng các lệnh sau:
- Kiểm thử lệnh gọi đến phương thức HealthCheck:
bin/bookingClient -server_addr="localhost:8080" -health_check_test=true -credentials_file="./cred.txt"
- Kiểm thử lệnh gọi đế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 tra các cuộc gọi đến phương thức CreateBooking và UpdateBooking (Đặt lịch hẹn và cập nhật thông tin) bằng cách:
bin/bookingClient -server_addr="localhost:8080" -booking_test=true -availability_feed="./avail.json" -credentials_file="./cred.txt"
Khi đang triển khai Máy chủ đặt phòng của riêng mình, bạn có thể cần phải chạy thêm các thử nghiệm đối với máy chủ đó (ví dụ: list_bookings_test, reschedule_test, v.v.) với mục tiêu là tất cả lượt kiểm thử đều đạt (-all_tests=true).