技能 azure-messaging-webpubsub-java
📦

azure-messaging-webpubsub-java

安全

Создавайте приложения реального времени с Azure Web PubSub

Обеспечьте двунаправленную связь в реальном времени в ваших Java-приложениях. Azure Web PubSub SDK предоставляет обмен сообщениями на основе WebSocket с поддержкой групп, таргетирования пользователей и контроля доступа.

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

下载技能 ZIP

2

在 Claude 中上传

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

3

开启并开始使用

测试它

正在使用“azure-messaging-webpubsub-java”。 Инициализация клиента и отправка приветственного сообщения

预期结果:

Клиент подключен к хабу 'chat'. Сообщение 'Hello everyone!' отправлено 47 подключениям через sendToAll.

正在使用“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
内容
32
社区
100
安全
100
规范符合性

你能构建什么

Бэкенд приложения для чата

Реализуйте многокомнатный чат с таргетированием пользователей, групповыми сообщениями и отслеживанием присутствия, используя абстракции хабов и групп.

Обновления live-панелей

Отправляйте уведомления, метрики или обновления данных в реальном времени подключенным браузерным клиентам без опроса.

Сервер многопользовательской игры

Координируйте обновления состояния игры между игроками с помощью таргетированных групповых сообщений и управления подключениями.

试试这些提示

Базовая настройка клиента
Создайте клиент Azure Web PubSub на Java с использованием строки подключения. Инициализируйте его для хаба с именем 'notifications' и отправьте тестовое сообщение всем подключениям.
Групповые сообщения
Реализуйте систему обмена сообщениями, где пользователи могут быть добавлены в группы, такие как 'premium-users' и 'announcements'. Отправляйте разные сообщения каждой группе и динамически управляйте членством в группах.
Генерация токенов с ролями
Сгенерируйте токены доступа для клиентов, подключающихся к чат-хабу. Назначьте роли для присоединения к группам и отправки сообщений. Установите срок действия токена 2 часа и автоматическое присоединение к группе 'lobby'.
Асинхронные операции с обработкой ошибок
Используйте асинхронный клиент Web PubSub для广播 сообщений всем подключениям. Реализуйте реактивную обработку ошибок, которая записывает сбои и повторяет временные ошибки. Обрабатывайте HttpResponseException для недопустимых состояний подключения.

最佳实践

  • Организуйте подключения в группы для эффективного таргетированного обмена сообщениями и снижения использования полосы пропускания
  • Устанавливайте соответствующие сроки действия токенов и предоставляйте минимально необходимые разрешения через роли
  • Используйте отдельные хабы для изоляции различных функций приложения и независимого масштабирования

避免

  • Не встраивайте строки подключения или ключи доступа непосредственно в исходный код
  • Избегайте отправки больших полезных нагрузок через Web PubSub - используйте его только для сигнализации
  • Никогда не пропускайте логику очистки подключений для неактивных или отключенных клиентов

常见问题

В чем разница между хабом и группой?
Хаб — это верхний уровень изоляции для подключений. Группы — это подмножества подключений внутри хаба. Используйте хабы для разделения различных функций, а группы — для таргетированных сообщений внутри функции.
Как аутентифицировать клиентов, подключающихся к Web PubSub?
Генерируйте токены доступа клиента на стороне сервера с помощью SDK. Клиенты используют эти токены для подключения. Токены могут включать идентификаторы пользователей, членство в группах и разрешения на основе ролей.
Могу ли я отправлять сообщения пользователям вместо подключений?
Да. Используйте sendToUser для охвата всех активных подключений определенного идентификатора пользователя. Это полезно, когда пользователи открыли несколько устройств или вкладок браузера.
Какие форматы сообщений поддерживает Web PubSub?
SDK поддерживает TEXT_PLAIN для текстовых сообщений и APPLICATION_JSON для структурированных данных. Бинарные данные также можно отправлять с помощью оберток BinaryData.
Как обрабатывать очистку подключений при отключении пользователей?
Используйте события закрытия подключения из вашего веб-хука сервера. Вызовите closeConnection или closeUserConnections для очистки состояния на стороне сервера. Реализуйте логику heartbeat для обнаружения устаревших подключений.
Существует ли ограничение на размер сообщения?
Azure Web PubSub имеет квоты службы для размера сообщений. Проверьте текущие ограничения в документации Azure. Для больших полезных нагрузок рассмотрите отправку уведомления и получение данных клиентами отдельно.

开发者详情

文件结构

📄 SKILL.md