Hapi 和 React SSR(服务端渲染)实现:指南和陷阱

阅读时长 11 分钟读完

在前端开发过程中,服务端渲染(Server-Side Rendering,SSR)是一项非常重要的技术。使用 SSR 可以极大地提高网站的初始加载速度和 SEO 效果。本文将介绍如何使用 Hapi 和 React SSR 实现一个完整的网站,同时也会谈到一些陷阱和解决方法。

Hapi

Hapi 是一个 Node.js Web 框架,它专注于构建可扩展的 API。Hapi 内置了许多功能,例如路由、中间件、验证等。它的主要特点是可扩展性和可配置性。使用 Hapi 可以轻松地创建一个完整的 Web 应用程序,并且可以根据自己的需求进行更改和扩展。以下是如何使用 Hapi 创建一个简单的服务器:

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

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

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

上述代码创建了一个 Hapi 服务器,监听端口号为 3000。当用户访问根路径时,会返回字符串 “Hello, world!”。

React SSR

服务端渲染允许在服务器端生成 HTML,这样可以节省客户端的渲染时间,并且可以提高 SEO 效果。React SSR 是指将 React 应用程序呈现为 HTML,并将其发送到客户端以供展示。以下是一个简单的 React 组件:

在客户端,将此组件呈现为 HTML 的常见方式是使用 ReactDOM.render 函数:

在上述代码中,ReactDOM.render 将 HelloWorld 组件呈现为 HTML,并将其插入到 ID 为 “root” 的 DOM 元素中。

在服务端,将 React 组件呈现为 HTML 的方式与客户端不同。以下是使用 ReactDOMServer.renderToString 函数将 HelloWorld 组件呈现为 HTML 的示例代码:

上述代码使用 ReactDOMServer.renderToString 函数将 HelloWorld 组件呈现为 HTML 格式,并将其输出到控制台。

使用 React SSR 最常见的模式是将项目分为客户端和服务器端两部分,并分别构建,然后在请求到达服务器时将 HTML 字符串发送回客户端。使用 React Router 等路由库可以实现多页应用和单页应用的服务端渲染。

Hapi 和 React SSR

以下是如何使用 Hapi 和 React SSR 创建一个多页应用的示例代码:

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

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

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

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

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

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

在上述代码中,首先创建了一个 Hapi 服务器。然后,定义了一个路由处理程序,当请求到达服务器时,将 App 组件呈现为 HTML 并返回给客户端。在服务器端,使用 StaticRouter 将请求的 URL 传递给 App 组件,以便正确渲染路由。如果 StaticRouter 的 context 对象中包含一个 URL,需要使用 Hapi 的重定向方法将请求重定向到正确的页面。

在以上代码中,传递给 react-dom/server 的 renderToString 函数返回一个表示 HTML 标记的字符串,将其嵌入到正确的 HTML 模板中,使用 Hapi 的 response 方法将其返回给客户端。

指南和陷阱

静态资源路径处理

在使用 React SSR 时,需要将静态资源(例如 JavaScript 和 CSS 文件)的路径正确地指定为服务器端的路径。在 Hapi 中,可以使用 Inert 插件来呈现静态资源。以下是如何在 Hapi 中使用 Inert 插件:

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

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

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

在上述代码中,使用了 Inert 插件来处理静态文件。通过在路由中添加 /static/{param*} 来处理静态文件,例如 /static/app.js。在本示例中,静态资源的路径是 ./static,需要在路由处理程序中指定该路径。

发送异步数据

在 React SSR 中,为了避免阻止渲染,数据需要在组件呈现之前获取。在服务器端,数据通常使用异步请求获取。以下是一个从服务器端获取数据并将其传递给 React 组件的示例代码:

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

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

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

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

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

在上述代码中,使用了 async/await 关键字来异步获取数据。然后,将数据传递给 App 组件,并在渲染时传递给组件。在完整的 HTML 页面中,使用 window.INITIAL_STATE 将数据传递给客户端。在客户端 JavaScript 中,可以访问此对象并使用数据。

处理 React Router

在 React SSR 中,通常需要使用 React Router 等路由库来处理页面路由。以下是使用 React Router 处理路由的示例代码:

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

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

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

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

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

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

在上述代码中,使用了 React Router 处理页面路由。StaticRouter 总是将请求的 URL 传递给 App 组件,以便正确呈现页面。如果 StaticRouter 的 context 对象中包含一个 URL,需要使用 Express 的重定向方法将请求重定向到正确的页面。

结论

在本文中,我们使用 Hapi 和 React SSR 实现了一个多页应用,并介绍了一些常见的陷阱和解决方法。通过使用 Hapi 和 React SSR,可以构建快速的、可扩展的 Web 应用程序,并在 SEO 上获得更好的效果。希望此文章可以帮助您成为更好的前端开发者。

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

纠错
反馈