预订 Node.js 版服务器框架

这是用于标准集成的 API v3 预订服务器的参考实现(基于 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

整个代码库仅由两个 JavaScript 文件组成:

  • bookingserver.js - HTTP 服务器和请求处理逻辑,包括身份验证
  • apiv3methods.js - 实现 API v3 接口的方法

下载文件后,您可以通过运行以下命令来启动预订服务器:

node bookingserver.js

该框架会将所有传入和传出请求写入控制台,因此您可以监控其执行以进行跟踪。

如果您需要通过 IDE 进行代码更改或调试,您可以使用 Visual Studio Code 或您选择的任何其他编辑器。调试项目,方法是在 Node.js 环境中启动 bookingserver.js,并根据需要设置断点。

测试预订服务器

下载预订测试实用程序。如需安装该工具,请按照其 README 页面中提供的安装说明操作。

对于测试,您需要创建一个文本文件来存储凭据。在一行内输入您的用户名和密码,例如,在名为 cred.txt 的文件中:

用户名:密码

此外,您还需要为测试商家提供库存状况 Feed 的本地副本。 在下面的示例命令中,可用性 Feed 是 availability.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)。