利用 Hapi.js 构建支付接口

阅读时长 10 分钟读完

Hapi.js 是一款基于 Node.js 的 Web 应用框架。它具有出色的可扩展性、可重用性和可测试性,并支持完整的插件生态系统。在这篇文章中,我们将探讨如何使用 Hapi.js 构建支付接口。

简介

支付接口是现代 Web 应用的重要组成部分。对于像电商网站这样的应用程序来说,支付网关是必不可少的。这是因为它使客户能够通过互联网购买商品,并使商家能够从客户那里收款。因此,支付接口必须能够处理安全的交易,并且必须具有可靠的性能。

Hapi.js 是一款流行的 Web 应用框架,它提供了一个高度可扩展的插件体系结构,在这个体系结构下,您可以构建出强大的支付接口。Hapi.js 至少需要 Node.js 版本为 8.0.0 或更高版本来运行。

构建支付接口

构建一个 Hapi.js 支付接口非常简单。为了开始,您可能需要在服务器上安装 Node.js 和 Hapi.js。如果您尚未安装这些依赖项,请按照 Hapi.js 官方文档中的说明进行安装。

安装依赖项

在使用 Hapi.js 构建支付接口之前,您需要安装一些必需的依赖项。其中包括:

  • hapi:Hapi.js 框架本身
  • hapi-joi:用于验证传入请求的数据
  • hapi-pino:用于记录日志

使用 npm 命令行工具,输入以下命令安装这些依赖项:

创建服务器

创建一个 Hapi.js 服务器是很简单的,只需要使用创建服务器的方法,并将其分配给变量即可。以下是一个创建服务器的示例代码:

-- -------------------- ---- -------
----- ---- - ----------------

----- ------ - -------------
  ----- ------------
  ----- ----
---

----- ----- - ----- -- -- -
  ----- -----------------
    ------- ---------------------
    -------- -
      ------------ ----
    -
  ---

  ----- ---------------
  ------------------- ------- --- ---------------------
--

--------

在上面的示例代码中,我们使用 Hapi.js 的 server 方法创建了一个新的服务器实例,并将其分配给 server 变量。然后,我们定义了服务器的基本设置,例如主机和端口。

由于 Hapi.js 服务器的核心原则之一是可扩展性,因此它具有非常强大的插件系统。我们通过 server.register 方法注册了 hapi-pino 插件,以便能够使用记录器来记录请求和响应。最后,我们启动了服务器并打印服务器的 URL。

创建支付接口

现在,我们已经创建了 Hapi.js 服务器,并已注册了必要的插件,我们可以开始构建支付接口了。首先,我们将定义一些常量和中间件,这些常量和中间件将帮助我们验证请求和响应,并保证交互的安全性。

-- -------------------- ---- -------
----- --- - ---------------

----- ------------- - --------- ----------------- -- -
  ----- - ----- - - --------------------- ----------------- - ----------- ----- ---
  -- ------- -
    ----- ------- - ------------------------ -- ----------------------- ---
    ----- --- ---------------
  -
--

----- ----------- - ---- --
  -----------------
    -------- -- --------------------------------------------------------------
    -----------

----- ---------- - ---- --
  -----------------
    ------------- ---- -- -- ------- ------ ----------------------------- --- ----

在上面的代码中,我们首先导入了 Joi,它是一款强大的数据验证工具。我们使用 validateInput 函数将有效荷载传递给预定义的验证架构。该函数可以确保有效荷载符合约定,并有表现力的提供错误信息。然后,我们定义了一些实用程序函数,例如将查询数据和表单数据进行 URL 编码。

定义 API 端点

现在我们已经定义了必要的常量和中间件,我们可以定义支付接口的 API 端点了。以下代码显示了如何为订单处理创建一个 POST 端点。

-- -------------------- ---- -------
----- ---------- - ------------
  ------- ------------
    ----------
    -----------
    ------------
  ---------------- ------------
    ----------
    -----------
    --------
    ------------
  --------------- ------------
    ----------
    -----------
    ------------
  ---- ------------
    ----------
    -----------
    -----------
    ---------
---
----- ------------ - ------------
  ------------ -----------------------
---

--------------
  ------- -------
  ----- -------------
  -------- -
    --------- -
      -------- ------------
        -------- ------------------------
        ------- ------------
          -------
          ------------
        ------------ ------------------------
        ----- ----------------------
        ------- -----------------------
      --
    -
  --
  -------- ----- --------- -- -- -
    --
      --------- ------- ------- ----------- ----
    --
    ------ - -------- ---- --
  -
---

在上面的示例代码中,我们首先定义了 cardSchemaoauth2Schema。这是我们需要验证的支付数据对象的结构。然后,我们定义了一个 POST /api/order 端点,该端点在接收订单处理请求时将转发到支付网关以进行处理。我们使用了 Joi 对有效荷载进行验证,并提供了正确的错误消息。

支付接口实现

最终的支付网关实现对于不同的支付网关提供了不同的实现,但这里的示例代码需要将支付处理分发到外部的支付网关服务以处理支付请求。

以下示例代码可以更好地说明:

-- -------------------- ---- -------
----- ----- - -----------------
----- -------- - ------------------------------------------

----- ------------- - ----- --------- ------- ------------ ----- ------------ -- -
  ----- ------- - - -------------- ------- --------------- --
  ----- --- - --------------------------
  ----- -------- - ------------
    ---------- ------
    --------
    -------
    ------------
    ----------- ------------
    ---------------- ---------------------
    --------------- --------------------
    ------------- --------
  ---
  ----- ----------- - ------------- ------------ ---------- ---

  --- -
    ----- -------- - ----- ----------------------------------- --------- - ------- ---
    ------ --------------
  - ----- ----- -
    ----- --- -------------- ----------
  -
--

--------------
  ------- -------
  ----- -------------
  -------- -
    --------- -
      -------- ------------
        -------- ------------------------
        ------- ------------
          -------
          ------------
        ------------ ------------------------
        ----- ----------------------
        ------- -----------------------
      --
    -
  --
  -------- ----- --------- -- -- -
    --- -
      ----- -
        --------
        -------
        ------------
        -----
        ------- - ----------- -
      - - ----------------
      ------------------------------ ------------
        -------- ------------------------
        ------- ------------
          -----------
          ------------
        ------------ ------------------------
        ------- ------------------------
        ----- ---------------------
      ----
      ----- -------- - ----- ---------------------- ------- ------------ ----- -------------
      ------ ---------
    - ----- ------- -
      ------ - ----- --
    -
  -
---

在上面的代码中,我们编写一个名为 handlePayment 的函数,它将订单处理数据发送到支付网关以进行处理。我们使用 axios 库(也可以使用其他 HTTP 客户端库)发送带有身份验证令牌、URL 编码表单数据和查询参数的 HTTP POST 请求。

最后,我们将 handlePayment 函数插入到 Hapi.js 路由操作中,并返回 API 的 JSON 响应。

结论

在这篇文章中,我们介绍了如何使用 Hapi.js 构建支付接口。为了做到这一点,我们首先创建了一个 Hapi.js 服务器,并注册了必要的插件。然后,我们考虑了如何通过路由和钩子将支付处理传递到外部支付网关服务以进行处理。最后,我们提供了我们构建支付接口需要的有用的实用工具函数和服务。

借助 Hapi.js 强大的插件系统和出色的可扩展性,构建必要的支付接口变得非常容易。我希望这篇文章对您有所启发,并希望您能开始构建自己的支付网关接口。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/670e2f615f551281025ffc49

纠错
反馈