使用.NET Core 实现 SSE 服务器的教程

阅读时长 10 分钟读完

本文将为大家介绍如何使用.NET Core实现SSE(服务端发送事件)服务器。SSE是一种用于在Web浏览器和服务器之间进行实时双向通信的协议。 本文重点介绍.NET Core如何通过建立SSE连接发送持续更新的消息,以及如何接收SSE消息并将其显示在Web应用程序中。

需求分析

在介绍如何使用.NET Core实现SSE服务器之前,我们首先需要了解SSE的一些基本概念和要求:

  • SSE连接是一种单向连接,只能从服务器向浏览器发送消息。
  • SSE连接以“text/event-stream” MIME类型的HTTP响应格式发送。
  • 服务器必须发送“Content-Type: text/event-stream” HTTP头以表示SSE连接。

了解SSE的基本要求后,我们需要确定我们要实现的SSE服务器的具体功能。 在这个项目中,我们主要实现以下功能:

  1. 在服务器建立SSE连接时,向客户端发送欢迎消息。
  2. 客户端可以通过WebSocket与服务器建立一个持续的连接。
  3. 服务器随机生成一个数字,并将其定期发送到所有连接的客户端。
  4. 客户端可以通过发送“订阅”消息来注册接收服务器发送的数字。

.NET Core SSE服务器实现

  1. 创建.NET Core项目:打开Visual Studio,点击“文件”→“新建”→“项目”,选择“ASP.NET Core Web应用程序”。在下一步中,我们选择“Web应用程序(MVC)”模板,创建项目。在项目成功创建后,在Solution Explorer中,双击“Startup.cs”文件打开文件。

  2. 添加中间件:在startup.cs文件中添加“UseMvc”中间件。

  1. 添加控制器:我们将SSE服务器代码放置在一个名为SSEController的控制器中。 SSEController的核心功能是处理响应SSE客户端请求。
-- -------------------- ---- -------
----- -------
----- ---------------------------
----- ------------
----- -----------------------
----- -------------------------

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

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

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

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

    --------
    ----- ------------- ------ - --- ---------------------------
    -
      ------ ---- - -------------------
      -- ----- -- ------------
      -
        ----------------------------------
        ----- -----------------
      -
    -
  -
-
  1. 实现SSE事件消息发送: SSE事件格式要求我们在每条事件消息之间需要有一个空行。在该代码中,我们从SSE控制器向客户端实时发送数字。
-- -------------------- ---- -------
------- ----- ---- ------------------------------ -------------
-
  ---------------
  ------ - - --- ---------------------------------
  --- ------ - --------- -----

  ------ ----------- - -------------------- --------- --------
  ------ ---------- - ------------------------------------
  ----- ----------------------------------- -- -------------------
-
  1. 实现欢迎消息发送,发送一个名为"welcome"的空事件。

    -- -------------------- ---- -------
    ------- ----- ---- -------------------
    -
       ------ ------------- - ---------------------------- -----------
       ------ ------------ - --------------------------------------
       ----- -------------------------------------- -- ---------------------
    
       ------ ------- - -------------------------------
       ----- --------------------------------- -- ----------------
    -
  2. 添加路由规则:在Startup.cs文件中添加路由规则。

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

至此,一个基本的.NET Core SSE服务器就完成了。我们完成了SSE连接的建立,发送欢迎消息,接收“订阅”消息,以及SSE事件消息的发送。

客户端实现

接下来,我们将演示如何建立WebSocket连接,并在浏览器中接收服务器发送的数字。 该例子使用JavaScript编写。

  1. 在HTML页面中添加WebSocket:

    -- -------------------- ---- -------
    --------- -----
    ------
      ------
          ---------- ------------
          ------- -----------------------------------------------------------
          --------
              ------------ -
                  --- --------- - --- -------------------------------------
    
                  ------------------- - --------------- -
                      --------------
                      --- ---- - -----------
                      -- ------------ - -- -
                          -- ----------------------------- - --- -
                              --- ------ - --------------------- -----------
                              ------------------------------------------- - -------
                          -
                      -
                  --
    
                  ----------------- - --------------- -
                      ---------------------- ----- -----------
                  --
              --
          ---------
      -------
      ------
          ------- ---------
          ------ ------ -- ----- ------------------------
      -------
    -------
  2. 添加“订阅”按钮:添加一个HTML按钮,当单击它时客户端向服务器发送“订阅”消息。 我们将其添加到上面的HTML页面中。

  3. 添加“订阅”JavaScript函数:添加JavaScript函数,该函数创建XMLHttpRequest对象并向“/sse/register”URL发送“订阅”消息。

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

至此,我们已经创建了一个SSE服务器和客户端,并建立了一条WebSocket连接。 要运行此示例,请在Visual Studio中启动.NET Core项目并在浏览器中打开带有“http://localhost:5000”的HTML文件。

总结

通过本文,我们了解了如何使用.NET Core实现SSE服务器,并通过建立WebSocket连接在浏览器中接收服务器发送的消息。 SSE是一种非常强大的技术,并且可以用于众多实际应用场景中,例如数据可视化和实时通知等。 在今天的Web应用程序中,实时通信已经变得非常普遍,并且SSE可以帮助我们实现与客户端的实时通信。

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

纠错
反馈