技能 azure-messaging-webpubsub-java
📦

azure-messaging-webpubsub-java

安全

使用 Azure Web PubSub 构建实时应用

在您的 Java 应用程序中启用实时双向通信。Azure Web PubSub SDK 提供基于 WebSocket 的消息传递,支持群组、用户定向和访问控制。

支持: Claude Codex Code(CC)
🥉 75 青铜
1

下载技能 ZIP

2

在 Claude 中上传

前往 设置 → 功能 → 技能 → 上传技能

3

开启并开始使用

测试它

正在使用“azure-messaging-webpubsub-java”。 初始化客户端并发送欢迎消息

预期结果:

客户端连接到 hub 'chat'。消息 'Hello everyone!' 通过 sendToAll 发送给 47 个连接。

正在使用“azure-messaging-webpubsub-java”。 将用户添加到群组并发送定向通知

预期结果:

用户 'user123' 已添加到群组 'premium-users'。通知已发送到群组中的 12 个连接。令牌在 3600 秒后过期。

安全审计

安全
v1 • 2/25/2026

All static analysis findings are false positives. The SKILL.md file is documentation containing Java code examples in markdown format. Detected backticks are markdown formatting, not shell execution. URLs are placeholder examples for environment configuration. No cryptographic algorithms are used. Skill is safe for publication.

1
已扫描文件
308
分析行数
0
发现项
1
审计总数
未发现安全问题
审计者: claude

质量评分

38
架构
100
可维护性
87
内容
50
社区
100
安全
100
规范符合性

你能构建什么

聊天应用后端

使用 hub 和群组抽象实现多房间聊天,支持用户定向、群组消息和在线状态跟踪。

实时仪表盘更新

向连接的浏览器客户端推送实时通知、指标或数据更新,无需轮询。

多人游戏服务器

使用定向群组消息和连接管理协调玩家之间的游戏状态更新。

试试这些提示

基础客户端设置
使用连接字符串在 Java 中创建 Azure Web PubSub 客户端。为名为 'notifications' 的 hub 初始化它,并向所有连接发送测试消息。
基于群组的消息传递
实现一个消息系统,用户可以被添加到 'premium-users' 和 'announcements' 等群组。向每个群组发送不同的消息并动态管理群组成员资格。
带角色的令牌生成
为加入聊天 hub 的用户生成客户端访问令牌。分配加入群组和发送消息的角色。将令牌过期时间设置为 2 小时并自动加入 'lobby' 群组。
带错误处理的异步操作
使用异步 Web PubSub 客户端向所有连接广播消息。实现反应式错误处理,记录失败并重试临时错误。处理无效连接状态的 HttpResponseException。

最佳实践

  • 将连接组织成群组以实现高效的定向消息传递并减少带宽
  • 设置适当的令牌过期时间并通过角色授予最小必需权限
  • 使用独立的 hub 隔离不同的应用功能并独立扩展

避免

  • 不要将连接字符串或访问密钥直接嵌入源代码
  • 避免通过 Web PubSub 发送大型负载 - 仅将其用于信令
  • 切勿跳过对非活动或断开连接的客户端的连接清理逻辑

常见问题

hub 和群组之间有什么区别?
hub 是连接的顶级隔离边界。群组是 hub 内连接的子集。使用 hub 分离不同功能,使用群组在功能内进行定向消息传递。
如何对连接到 Web PubSub 的客户端进行身份验证?
使用 SDK 在服务器端生成客户端访问令牌。客户端使用这些令牌进行连接。令牌可以包含用户 ID、群组成员资格和基于角色的权限。
我可以向用户而不是连接发送消息吗?
可以。使用 sendToUser 向特定用户 ID 的所有活动连接发送消息。当用户打开多个设备或浏览器标签页时这很有用。
Web PubSub 支持哪些消息格式?
SDK 支持 TEXT_PLAIN 用于文本消息,APPLICATION_JSON 用于结构化数据。也可以使用 BinaryData 包装器发送二进制数据。
当用户断开连接时如何处理连接清理?
使用服务器 webhook 的连接关闭事件。调用 closeConnection 或 closeUserConnections 清理服务器端状态。实现心跳逻辑检测过时连接。
有消息大小限制吗?
Azure Web PubSub 对消息大小有服务配额。请在 Azure 文档中查看当前限制。对于大型负载,考虑发送通知让客户端单独获取数据。

开发者详情

文件结构

📄 SKILL.md