0

0

如何构建一个使用 GraphQL 订阅实现实时数据更新的前端应用?

紅蓮之龍

紅蓮之龍

发布时间:2025-09-25 16:14:01

|

227人浏览过

|

来源于php中文网

原创

答案:使用 Apollo Client 配置 WebSocketLink 实现 GraphQL 订阅,通过 useSubscription 监听实时数据,需前后端协同支持。

如何构建一个使用 graphql 订阅实现实时数据更新的前端应用?

要构建一个使用 GraphQL 订阅实现实时数据更新的前端应用,核心是通过 WebSocket 与支持订阅的 GraphQL 服务器建立持久连接,并在客户端监听数据变化。下面从关键步骤和常用技术出发,说明如何实现。

1. 选择合适的 GraphQL 客户端库

目前最主流的方案是使用 Apollo Client,它原生支持 GraphQL 查询、变更和订阅功能。

安装 Apollo Client 及相关依赖:

npm install @apollo/client graphql npm install subscriptions-transport-ws

其中 subscriptions-transport-ws 提供 WebSocket 支持,用于处理订阅操作。

立即学习前端免费学习笔记(深入)”;

2. 配置支持订阅的 Apollo Client

创建 ApolloClient 实例时,需要使用 WebSocketLink 来处理订阅请求,同时结合 split 将普通查询/变更与订阅请求分开处理。

示例配置代码:

import { ApolloClient, HttpLink, InMemoryCache, split } from '@apollo/client'; import { getMainDefinition } from '@apollo/client/utilities'; import { WebSocketLink } from 'subscriptions-transport-ws'; const httpLink = new HttpLink({ uri: 'http://localhost:4000/graphql', }); const wsLink = new WebSocketLink({ uri: `ws://localhost:4000/graphql`, options: { reconnect: true, }, }); const splitLink = split( ({ query }) => { const definition = getMainDefinition(query); return ( definition.kind === 'OperationDefinition' && definition.operation === 'subscription' ); }, wsLink, httpLink, ); const client = new ApolloClient({ link: splitLink, cache: new InMemoryCache() });

这样配置后,所有订阅请求会通过 WebSocket 发送,其余操作走 HTTP。

情感家园企业站5.0 多语言多风格版
情感家园企业站5.0 多语言多风格版

一套面向小企业用户的企业网站程序!功能简单,操作简单。实现了小企业网站的很多实用的功能,如文章新闻模块、图片展示、产品列表以及小型的下载功能,还同时增加了邮件订阅等相应模块。公告,友情链接等这些通用功能本程序也同样都集成了!同时本程序引入了模块功能,只要在系统默认模板上创建模块,可以在任何一个语言环境(或任意风格)的适当位置进行使用!

下载

3. 定义并使用订阅查询

在组件中使用 useSubscription Hook 来监听实时数据更新。

例如,监听新消息到达:

import { useSubscription, gql } from '@apollo/client'; const NEW_MESSAGE_SUBSCRIPTION = gql` subscription OnNewMessage { messageAdded { id content sender timestamp } } `; function MessageList() { const { data, loading } = useSubscription(NEW_MESSAGE_SUBSCRIPTION); if (loading) return

正在连接...

; if (data?.messageAdded) { console.log('收到新消息:', data.messageAdded); // 更新 UI,比如添加到消息列表 } return (...); }

每当服务端触发 messageAdded 事件,客户端就会收到推送并自动更新视图。

4. 确保后端支持 GraphQL 订阅

前端能正常工作前提是有支持订阅的 GraphQL 服务端。常见实现方式包括:

  • Node.js + Apollo Server:通过 PubSubRedis 触发订阅事件
  • 定义好 Schema 中的 subscription 类型
  • 启动 WebSocket 服务(Apollo Server 默认集成)

确保服务端启用 WebSocket 并暴露 /graphql 的 ws 协议支持。

基本上就这些。只要前后端都正确配置,GraphQL 订阅就能轻松实现聊天、通知、实时仪表盘等场景的数据自动刷新。关键是连接管理、错误重连和状态同步处理到位。

相关专题

更多
if什么意思
if什么意思

if的意思是“如果”的条件。它是一个用于引导条件语句的关键词,用于根据特定条件的真假情况来执行不同的代码块。本专题提供if什么意思的相关文章,供大家免费阅读。

738

2023.08.22

c语言const用法
c语言const用法

const是关键字,可以用于声明常量、函数参数中的const修饰符、const修饰函数返回值、const修饰指针。详细介绍:1、声明常量,const关键字可用于声明常量,常量的值在程序运行期间不可修改,常量可以是基本数据类型,如整数、浮点数、字符等,也可是自定义的数据类型;2、函数参数中的const修饰符,const关键字可用于函数的参数中,表示该参数在函数内部不可修改等等。

523

2023.09.20

堆和栈的区别
堆和栈的区别

堆和栈的区别:1、内存分配方式不同;2、大小不同;3、数据访问方式不同;4、数据的生命周期。本专题为大家提供堆和栈的区别的相关的文章、下载、课程内容,供大家免费下载体验。

389

2023.07.18

堆和栈区别
堆和栈区别

堆(Heap)和栈(Stack)是计算机中两种常见的内存分配机制。它们在内存管理的方式、分配方式以及使用场景上有很大的区别。本文将详细介绍堆和栈的特点、区别以及各自的使用场景。php中文网给大家带来了相关的教程以及文章欢迎大家前来学习阅读。

571

2023.08.10

js正则表达式
js正则表达式

php中文网为大家提供各种js正则表达式语法大全以及各种js正则表达式使用的方法,还有更多js正则表达式的相关文章、相关下载、相关课程,供大家免费下载体验。

510

2023.06.20

js获取当前时间
js获取当前时间

JS全称JavaScript,是一种具有函数优先的轻量级,解释型或即时编译型的编程语言;它是一种属于网络的高级脚本语言,主要用于Web,常用来为网页添加各式各样的动态功能。js怎么获取当前时间呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

244

2023.07.28

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

256

2023.08.03

js是什么意思
js是什么意思

JS是JavaScript的缩写,它是一种广泛应用于网页开发的脚本语言。JavaScript是一种解释性的、基于对象和事件驱动的编程语言,通常用于为网页增加交互性和动态性。它可以在网页上实现复杂的功能和效果,如表单验证、页面元素操作、动画效果、数据交互等。

5272

2023.08.17

java数据库连接教程大全
java数据库连接教程大全

本专题整合了java数据库连接相关教程,阅读专题下面的文章了解更多详细内容。

20

2026.01.15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
进程与SOCKET
进程与SOCKET

共6课时 | 0.3万人学习

Redis+MySQL数据库面试教程
Redis+MySQL数据库面试教程

共72课时 | 6.3万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号