Hapijs 是一款基于 Node.js 平台的开源 Web 框架，能够让开发者快速、高效地构建 Web 应用程序和 API。Hapijs 采用插件化的设计风格，支持强大的路由、缓存、身份验证和插件等功能。本文将介绍 Hapijs 的基础知识和使用方法。
安装 Hapijs
在开始使用 Hapijs 之前，需要先安装 Node.js 环境。在安装完 Node.js 后，就可以通过 npm 安装 Hapijs：
$ npm install hapi --save
创建 Hapijs 应用程序
在安装完 Hapijs 后，就可以创建一个新的 Hapijs 应用程序了。在创建 Hapijs 应用程序之前，需要按照以下步骤设置好项目文件夹和文件：
- 创建项目文件夹
- 在项目目录下创建
package.json文件 - 安装 Hapijs 和其他依赖
现在，可以创建一个 Hapijs 应用程序。以下代码演示了如何创建一个简单的 Hapijs 应用程序并监听在本地 8000 端口上：
-- -------------------- ---- -------
----- ---- - ----------------
----- ------ - --- ------------- ----- ---- ---
--------------
------- ------
----- ----
-------- --------- -- -- -
------ ------- ---------
-
---
----- -------- ------------- -
----- ---------------
------------------- ------- --- ---------------------
-
--------------以上代码创建了一个新的 Hapijs 服务器并定义了一个简单的路由。当访问服务器根路径时，服务器将返回一条欢迎信息。使用 async 函数启动服务器，并在命令行输出提示信息。
Hapijs 路由
在 Hapijs 中，路由是用于将 HTTP 请求映射到一个处理程序的机制。路由定义了在哪个 URL path 上接收请求、在何时和何种方式处理请求。Hapijs 的路由系统是其核心功能之一。
基础路由
Hapijs 支持以下 HTTP 方法：
- GET
- POST
- PUT
- DELETE
可以通过以下方式定义一个路由：
server.route({
method: 'GET',
path: '/hello',
handler: (request, h) => {
return 'Hello, world!';
}
});在上面的代码中，我们创建了一个 GET 请求方法，匹配路由路径为 /hello，并返回一条欢迎信息。
路径参数
Hapijs 的路由系统支持路径参数，可以用于动态定义路由的路径。
server.route({
method: 'GET',
path: '/hello/{name}',
handler: (request, h) => {
const { name } = request.params;
return `Hello, ${encodeURIComponent(name)}!`;
}
});在上面的代码中，我们使用了命名占位符 {name} 将路由路径定义为 /hello/{name}。该路径可以匹配任何以 /hello/ 开头并后跟任何字符的请求，例如 /hello/john。
查询参数
路由系统还支持查询参数，可以用于通过 URL 传递参数。查询参数通常以 ? 开始并跟随一系列以 & 分隔的键值对。
server.route({
method: 'GET',
path: '/search',
handler: (request, h) => {
const { query } = request.params;
return `Search query: ${query}`;
}
});在上面的代码中，我们可以通过 request.params 对象的 query 属性获取查询参数。例如，在访问 /search?query=hapi 时，服务器将返回 Search query: hapi。
Hapijs 插件
Hapijs 的插件机制使其非常易于扩展。通过使用 Hapijs 插件，我们可以将处理程序、路由和其他功能组织成可重用和可配置的模块。
安装和注册插件
可以使用 npm 安装 Hapijs 插件：
$ npm install hapi-plugin-name --save
在应用程序中注册插件：
-- -------------------- ---- ------- ----- ---- - ---------------- ----- ---------- - ---------------------------- ----- ------ - --- -------------- ----- -------- ----------------- - ----- ---------------------------- -------------------- ---------- ---------------- - ----- -------- ------------- - ----- ------------------ ----- --------------- ------------------- ------- --- --------------------- - --------------
在上面的代码中，我们使用 server.register 方法注册了 NamePlugin 插件。
内置插件
Hapijs 自带了一些常用的插件，如路由注册插件 hapi-router、打印请求日志插件 good 等。
可以通过以下方式添加插件：
-- -------------------- ---- -------
----- ---- - ----------------
----- ------ - --- --------------
----- -------- ----------------- -
----- -----------------
-----------------------
---------------
---
-------------------- ---------- ----------------
-
----- -------- ------------- -
----- ------------------
----- ---------------
------------------- ------- --- ---------------------
-
--------------在上面的代码中，我们注册了 hapi-router 和 good 插件。
Hapijs 请求处理
当 Hapijs 应用程序接收到一个 HTTP 请求时，它将进入请求处理的过程。在这个过程中，Hapijs 将对请求进行一系列处理操作，最终返回响应结果。
处理程序
在 Hapijs 中，处理程序是函数或类，用于处理请求和响应。处理程序通常被定义为服务器路由的处理程序。
server.route({
method: 'GET',
path: '/hello',
handler: (request, h) => {
return 'Hello, world!';
}
});在上面的代码中，我们定义了一个处理程序，该处理程序将在 /hello 路由请求时返回一条欢迎信息。
处理程序接收两个参数：
request：表示 HTTP 请求对象。h：表示响应工具集，可以用来构建和发送响应。
配置
可以通过修改处理程序配置来自定义其行为。
-- -------------------- ---- -------
--------------
------- ------
----- ---------
------- -
-------- -
------- ----
--
-------- --------- -- -- -
------ ------- --------
-
-
---在上面的代码中，我们将处理程序的超时时间设置为 5 秒。
总结
本文介绍了 Hapijs 的基础知识和使用方法，包括安装、创建应用程序、路由、插件和请求处理。Hapijs 是一款强大的 Web 框架，能够让前端开发者更加高效地构建 Web 应用程序和 API。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/6469da58968c7c53b09a6464