Đây là cách triển khai tham khảo của Máy chủ đặt phòng API v3 để tích hợp 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
Máy chủ đặt phòng được triển khai bằng Node.js tiêu chuẩn mà không cần thêm thư viện hoặc khung 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 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à 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 hai tệp JavaScript:
- bookingserver.js – logic xử lý yêu cầu và máy chủ HTTP, bao gồm cả xác thực
- apiv3methods.js – các phương thức triển khai giao diện API v3
Sau khi tải các 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ể 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 soạn thảo 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 đ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.
Đố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 xác thực 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:
username:password
Bạn cũng cần có một bản sao nguồn cấp dữ liệu Tình trạng còn hàng trên máy tính 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 thử 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"
- Kiểm thử các 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 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 thêm các chương trình kiểm thử đối với máy chủ đó (ví dụ: list_bookings_test, rescheduling_test, v.v.) với mục tiêu tất cả các chương trình kiểm thử đều đạt (-all_tests=true).