在 Web 开发领域,Node.js 已经成为了必不可少的技术栈。而构建 Web 服务器则是 Node.js 技术栈中最为基础和重要的部分。本文将介绍 Hapi.js 框架,它是一个基于 Node.js 的服务器框架,有极佳的扩展性和稳定性,同时拥有简洁清晰的文档和 API。
接下来,我们将介绍 Hapi.js 的基础知识,并借助一些示例代码,让你迅速上手使用 @hapi/hapi 进行 Web 服务器开发。
相关概念
在了解 Hapi.js 的具体使用之前,让我们先来了解一些相关的概念。
路由
在 Hapi.js 中,路由用于定义 HTTP 接口路径的映射关系。例如:
server.route({
method: 'GET',
path: '/hello',
handler: (request, h) => {
return 'Hello Hapi.js!';
}
});上面的代码就定义了一个 HTTP GET 接口 /hello,该接口访问时,将在服务器端返回字符串 “Hello Hapi.js!”。
处理器
在 Hapi.js 中,处理器用于处理不同的路由。例如,上例中的处理器就是 (request, h) => { return 'Hello Hapi.js!'; }。其中,request 参数包含了关于客户端请求的信息,h 参数用于返回结果给客户端。
插件
在 Hapi.js 中,插件用于扩展框架的功能。例如,我们可以通过安装好了的插件 @hapi/vision,在 Hapi.js 中使用视图(view)功能。具体用法如下:
-- -------------------- ---- -------
--------------
-------- -
----- ---------------------
--
----- --------- - ------------
---
--------------
------- ------
----- ---------
-------- --------- -- -- -
------ --------------- -
----- ---------
---
-
---在上面的示例代码中,我们通过 server.views API 来配置模板引擎,然后通过返回 h.view 来渲染视图并返回给客户端。
基础使用
了解了 Hapi.js 的一些基础概念之后,让我们看看如何使用 Hapi.js进行开发。
安装和使用
安装 Hapi.js 可以使用 npm,在控制台输入以下命令即可:
npm install @hapi/hapi
安装好了之后,在服务器端使用如下 API 开启一条服务器:
-- -------------------- ---- ------- ----- ---- - ---------------------- ----- ------ - --- ------------- ----- ----- ----- ----------- --- ----- ----- - ----- -- -- - ----- --------------- ------------------- ------- --- --------------------- -- --------
在上面的代码中,我们创建了一个名为 “server” 的服务器,并监听了 8080 端口。同时,我们使用了 async 和 await 来实现了服务器的异步调用处理。
路由和处理器
在创建服务器之后,我们可以使用 server.route 来定义我们服务器的路由。例如:
server.route({
method: 'GET',
path: '/',
handler: (request, h) => {
return 'Hello Hapi.js!';
}
});在上面的代码中,我们定义了一个 HTTP GET 接口 /,该接口访问时,将在服务器端返回字符串 “Hello Hapi.js!”。
插件
在 Hapi.js 中,我们可以使用插件来扩展框架的功能。例如,我们可以使用 @hapi/vision 插件来在 Hapi.js 中使用视图渲染功能。具体用法如下:
-- -------------------- ---- -------
----- ---- - ----------------------
----- ---------- - ----------------------
----- ------ - ------------------------
----- ------ - --- -------------
----- -----
----- -----------
---
----- ----- - ----- -- -- -
----- ------------------------
--------------
-------- -
----- ----------
--
----- --------- - ------------
---
--------------
------- ------
----- ----
-------- --------- -- -- -
------ --------------- -
----- ---------
---
-
---
----- ---------------
------------------- ------- --- ---------------------
--
--------在上述示例代码中,我们安装并且注册了 @hapi/vision 插件,并使用其视图渲染功能。同时,我们创建了一个 index.html 视图,并在返回界面时使用了 h.view API 来渲染页面。
强调一下,在使用 Hapi.js 时,我们可以尽量使用其提供的插件来满足我们的需求,并且可以通过自定义插件来扩展框架的功能。
错误处理
当在 Hapi.js 中发生错误时,我们可以使用 Boom 模块来进行错误信息的封装和处理。例如:
-- -------------------- ---- -------
----- ---- - ----------------------
--------------
------- ------
----- -------
-------- --------- -- -- -
----- --------------------------
-
---在上面的代码中,我们定义了一个 GET /404 的路由,并在请求时返回一个 404 错误信息。
总结
在本文中,我们介绍了 Hapi.js 服务器框架的一些基础概念、特点和使用。同时,我们借助了一些示例代码来快速上手使用 Hapi.js 进行服务开发。
在使用 Hapi.js 时,我们需要注意以下几点:
- 熟悉 Hapi.js 的相关概念,并掌握其 API 的用法;
- 使用插件来扩展功能,并通过自定义插件来满足自己的需要;
- 错误处理是非常重要的,我们可以使用
Boom模块来处理自定义错误信息。
最后,希望读者可以通过本文对 Hapi.js 的学习,对 Node.js 技术栈有更深入的理解和掌握。
Source: FunTeaLearn,Please indicate the source for reprints https://funteas.com/post/649e2ac748841e9894ab25b2