近年来，前端开发飞速发展，认识到 API 对现代 Web 应用程序的重要性也日益增长。这时，需要一种能够高效构建并管理 REST API 的框架，于是，Hapi.js 应运而生。Hapi.js 是一款优秀的、功能强大且易于使用的 Node.js 框架，本文将介绍如何在 Hapi.js 中实现 Restful API。
Restful API 概念
REST 是一种 Web 应用程序架构风格，指的是 Representational State Transfer，它规定了客户端和服务器之间如何进行通信。而 Restful API 则是 REST 架构风格下的 Web 服务接口，提供基于 HTTP 协议的通信实现，具备以下特点：
- 统一的接口：API 的基本组件是资源，它们通过 URI 进行标识，并可以通过统一的接口进行访问。
- 无状态：服务器可通过 HTTP 请求中的某些参数来存储客户端状态信息，但这些信息有限制，并不能保留太多客户端状态。
- 可缓存：客户端可以将响应缓存在其中，以提高性能。
- 分层系统：客户端无需了解其后面系统的详细信息。
- 按需编排：API 可以按需编排，客户端只需要知道他所需要的资源信息。
Hapi.js 框架
Hapi.js 是一个 Node.js 框架，专为 Web 服务方案而设计，其核心理念是尽可能实用和尽可能少的代码。它提供了一种可预测性的方式来构建 Web 应用程序。Hapi.js 具有以下特性：
- 路由配置：可以更方便的处理请求并返回数据。
- 输入数据校验：可以检查请求中的参数，以确保其类型、格式和值。
- 处理错误：能够捕获并处理从路由到其他地方的所有可能错误。
- 插件扩展：可以引入一个扩展，以便快速添加新的功能并方便地管理代码。
- 清晰的单元测试：可以使用测试框架编写单元测试，以确保可靠的应用程序。
Hapi.js 可以轻松创建 Restful API，并且的确是为创建此类 APIS 而设计，使其能够更好的处理 API 中的细节和错误。让我们基于 Hapi.js 创建 Restful API。
使用 Hapi.js 创建 Restful API
下面是一些步骤，这些步骤逐步介绍了创建 Hapi.js Restful API 的最佳实践。
- 安装 Hapi.js
在使用 Hapi.js 之前，首先您需要在计算机上安装 Node.js。可以通过运行以下命令来安装 Hapi.js：
npm i hapi
- 引入 Hapi.js
在创建 API 时，必须先使用 require 语句引入 Hapi.js 模块。使用以下代码将模块引入文件：
const Hapi = require('hapi')- 创建服务器实例
下一步是创建一个服务器实例。它是一个 Hapi.js 服务器对象，它将监听 URL 和 HTTP 方法之间的关联。可以通过以下代码创建服务器实例：
const server = Hapi.server({
port: 3000,
host: 'localhost'
})其中，此代码将创建一个新的服务器对象，使用默认 host 为 localhost 和默认端口为 3000。
- 编写路由和控制器
在 Hapi.js Restful API 中，路由可以理解为调用时期望的终端挂靠点，而控制器，在 Hapi.js 中被称为处理程序，是处理路由调用的功能单元。
路由定义 URL 和 HTTP 方法，将请求链接到处理程序函数，并在响应中返回数据。您可以使用以下代码编写路由：
-- -------------------- ---- -------
--------------
-
------- ------
----- ---------
-------- --------- -- -- -
------ ------- --------
-
-
--上面的代码定义了一个名为“hello”的路由，使用 GET 方法，并在"/hello"路径上使用它。
由于这是一个 API，您需要添加控制器（处理器），这就是翻译 URL 的函数。此处，控制器只是一个函数，根据路由定义将请求链接到数据方法。以下是控制器中的示例代码：
-- -------------------- ---- -------
----- ------------ - --------- -- -- -
------ ------- --------
-
--------------
-
------- ------
----- ---------
-------- ------------
-
---在这里，helloHandler 是处理程序函数，可以返回字符串“Hello, World!”。在 HTTP GET /hello 请求到达服务器时，服务器将执行此处理程序函数。
这是使用 Hapi.js 实现 Restful API 的最简单方式。您可以根据需求定义不同的路由和控制器功能。精细的自定义控制器可以更好的控制 API 行为。此外，Hapi.js 框架还提供了许多其他功能，例如跨域访问支持、单元测试、请求输入校验等许多强大功能。
结论
使用 Hapi.js 您可以轻松地创建 Restful API。通过此框架，可以更好的处理 API 中的细节和错误，实现快速而可靠的 API 开发。
当您创建 Restful API 时，您可以使用路由和控制器将请求路由到正确的位置，并使用请求输入校验和异常处理使其更加完善。我们希望本文有助于理解如何使用 Hapi.js 创建 Restful API，并希望在创建 Restful API 时对您有所帮助。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/67514fb18bd460d3ad885680