[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-11010efc-a382-4ccb-8274-e0bf3814a055":3,"$fOJLiSfdcHvJ6oIYgZ4sekKSAJe5Gxx1A-30D8YjT8Gw":43},{"id":4,"title":5,"description":6,"categoryId":7,"moduleId":8,"tags":9,"prompt":10,"icon":11,"source":12,"sourceUrl":13,"authorId":14,"authorName":15,"isPublic":16,"stars":17,"runs":18,"createdAt":19,"updatedAt":19,"module":20,"category":27,"packages":34},"11010efc-a382-4ccb-8274-e0bf3814a055","azure-messaging-webpubsub-java","使用 Azure Web PubSub SDK for Java 构建实时Web应用程序。在实现基于WebSocket的消息传递、实时更新、聊天应用程序或服务器到客户端的推送通知时使用。","cat_coding_devops","mod_coding","sickn33,coding","---\nname: azure-messaging-webpubsub-java\ndescription: \"Build real-time web applications with Azure Web PubSub SDK for Java. Use when implementing WebSocket-based messaging, live updates, chat applications, or server-to-client push notifications.\"\nrisk: unknown\nsource: community\ndate_added: \"2026-02-27\"\n---\n\n# Azure Web PubSub SDK for Java\n\nBuild real-time web applications using the Azure Web PubSub SDK for Java.\n\n## Installation\n\n```xml\n\u003Cdependency>\n    \u003CgroupId>com.azure\u003C\u002FgroupId>\n    \u003CartifactId>azure-messaging-webpubsub\u003C\u002FartifactId>\n    \u003Cversion>1.5.0\u003C\u002Fversion>\n\u003C\u002Fdependency>\n```\n\n## Client Creation\n\n### With Connection String\n\n```java\nimport com.azure.messaging.webpubsub.WebPubSubServiceClient;\nimport com.azure.messaging.webpubsub.WebPubSubServiceClientBuilder;\n\nWebPubSubServiceClient client = new WebPubSubServiceClientBuilder()\n    .connectionString(\"\u003Cconnection-string>\")\n    .hub(\"chat\")\n    .buildClient();\n```\n\n### With Access Key\n\n```java\nimport com.azure.core.credential.AzureKeyCredential;\n\nWebPubSubServiceClient client = new WebPubSubServiceClientBuilder()\n    .credential(new AzureKeyCredential(\"\u003Caccess-key>\"))\n    .endpoint(\"\u003Cendpoint>\")\n    .hub(\"chat\")\n    .buildClient();\n```\n\n### With DefaultAzureCredential\n\n```java\nimport com.azure.identity.DefaultAzureCredentialBuilder;\n\nWebPubSubServiceClient client = new WebPubSubServiceClientBuilder()\n    .credential(new DefaultAzureCredentialBuilder().build())\n    .endpoint(\"\u003Cendpoint>\")\n    .hub(\"chat\")\n    .buildClient();\n```\n\n### Async Client\n\n```java\nimport com.azure.messaging.webpubsub.WebPubSubServiceAsyncClient;\n\nWebPubSubServiceAsyncClient asyncClient = new WebPubSubServiceClientBuilder()\n    .connectionString(\"\u003Cconnection-string>\")\n    .hub(\"chat\")\n    .buildAsyncClient();\n```\n\n## Key Concepts\n\n- **Hub**: Logical isolation unit for connections\n- **Group**: Subset of connections within a hub\n- **Connection**: Individual WebSocket client connection\n- **User**: Entity that can have multiple connections\n\n## Core Patterns\n\n### Send to All Connections\n\n```java\nimport com.azure.messaging.webpubsub.models.WebPubSubContentType;\n\n\u002F\u002F Send text message\nclient.sendToAll(\"Hello everyone!\", WebPubSubContentType.TEXT_PLAIN);\n\n\u002F\u002F Send JSON\nString jsonMessage = \"{\\\"type\\\": \\\"notification\\\", \\\"message\\\": \\\"New update!\\\"}\";\nclient.sendToAll(jsonMessage, WebPubSubContentType.APPLICATION_JSON);\n```\n\n### Send to All with Filter\n\n```java\nimport com.azure.core.http.rest.RequestOptions;\nimport com.azure.core.util.BinaryData;\n\nBinaryData message = BinaryData.fromString(\"Hello filtered users!\");\n\n\u002F\u002F Filter by userId\nclient.sendToAllWithResponse(\n    message,\n    WebPubSubContentType.TEXT_PLAIN,\n    message.getLength(),\n    new RequestOptions().addQueryParam(\"filter\", \"userId ne 'user1'\"));\n\n\u002F\u002F Filter by groups\nclient.sendToAllWithResponse(\n    message,\n    WebPubSubContentType.TEXT_PLAIN,\n    message.getLength(),\n    new RequestOptions().addQueryParam(\"filter\", \"'GroupA' in groups and not('GroupB' in groups)\"));\n```\n\n### Send to Group\n\n```java\n\u002F\u002F Send to all connections in a group\nclient.sendToGroup(\"java-developers\", \"Hello Java devs!\", WebPubSubContentType.TEXT_PLAIN);\n\n\u002F\u002F Send JSON to group\nString json = \"{\\\"event\\\": \\\"update\\\", \\\"data\\\": {\\\"version\\\": \\\"2.0\\\"}}\";\nclient.sendToGroup(\"subscribers\", json, WebPubSubContentType.APPLICATION_JSON);\n```\n\n### Send to Specific Connection\n\n```java\n\u002F\u002F Send to a specific connection by ID\nclient.sendToConnection(\"connectionId123\", \"Private message\", WebPubSubContentType.TEXT_PLAIN);\n```\n\n### Send to User\n\n```java\n\u002F\u002F Send to all connections for a specific user\nclient.sendToUser(\"andy\", \"Hello Andy!\", WebPubSubContentType.TEXT_PLAIN);\n```\n\n### Manage Groups\n\n```java\n\u002F\u002F Add connection to group\nclient.addConnectionToGroup(\"premium-users\", \"connectionId123\");\n\n\u002F\u002F Remove connection from group\nclient.removeConnectionFromGroup(\"premium-users\", \"connectionId123\");\n\n\u002F\u002F Add user to group (all their connections)\nclient.addUserToGroup(\"admin-group\", \"userId456\");\n\n\u002F\u002F Remove user from group\nclient.removeUserFromGroup(\"admin-group\", \"userId456\");\n\n\u002F\u002F Check if user is in group\nboolean exists = client.userExistsInGroup(\"admin-group\", \"userId456\");\n```\n\n### Manage Connections\n\n```java\n\u002F\u002F Check if connection exists\nboolean connected = client.connectionExists(\"connectionId123\");\n\n\u002F\u002F Close a connection\nclient.closeConnection(\"connectionId123\");\n\n\u002F\u002F Close with reason\nclient.closeConnection(\"connectionId123\", \"Session expired\");\n\n\u002F\u002F Check if user exists (has any connections)\nboolean userOnline = client.userExists(\"userId456\");\n\n\u002F\u002F Close all connections for a user\nclient.closeUserConnections(\"userId456\");\n\n\u002F\u002F Close all connections in a group\nclient.closeGroupConnections(\"inactive-group\");\n```\n\n### Generate Client Access Token\n\n```java\nimport com.azure.messaging.webpubsub.models.GetClientAccessTokenOptions;\nimport com.azure.messaging.webpubsub.models.WebPubSubClientAccessToken;\n\n\u002F\u002F Basic token\nWebPubSubClientAccessToken token = client.getClientAccessToken(\n    new GetClientAccessTokenOptions());\nSystem.out.println(\"URL: \" + token.getUrl());\n\n\u002F\u002F With user ID\nWebPubSubClientAccessToken userToken = client.getClientAccessToken(\n    new GetClientAccessTokenOptions().setUserId(\"user123\"));\n\n\u002F\u002F With roles (permissions)\nWebPubSubClientAccessToken roleToken = client.getClientAccessToken(\n    new GetClientAccessTokenOptions()\n        .setUserId(\"user123\")\n        .addRole(\"webpubsub.joinLeaveGroup\")\n        .addRole(\"webpubsub.sendToGroup\"));\n\n\u002F\u002F With groups to join on connect\nWebPubSubClientAccessToken groupToken = client.getClientAccessToken(\n    new GetClientAccessTokenOptions()\n        .setUserId(\"user123\")\n        .addGroup(\"announcements\")\n        .addGroup(\"updates\"));\n\n\u002F\u002F With custom expiration\nWebPubSubClientAccessToken expToken = client.getClientAccessToken(\n    new GetClientAccessTokenOptions()\n        .setUserId(\"user123\")\n        .setExpiresAfter(Duration.ofHours(2)));\n```\n\n### Grant\u002FRevoke Permissions\n\n```java\nimport com.azure.messaging.webpubsub.models.WebPubSubPermission;\n\n\u002F\u002F Grant permission to send to a group\nclient.grantPermission(\n    WebPubSubPermission.SEND_TO_GROUP,\n    \"connectionId123\",\n    new RequestOptions().addQueryParam(\"targetName\", \"chat-room\"));\n\n\u002F\u002F Revoke permission\nclient.revokePermission(\n    WebPubSubPermission.SEND_TO_GROUP,\n    \"connectionId123\",\n    new RequestOptions().addQueryParam(\"targetName\", \"chat-room\"));\n\n\u002F\u002F Check permission\nboolean hasPermission = client.checkPermission(\n    WebPubSubPermission.SEND_TO_GROUP,\n    \"connectionId123\",\n    new RequestOptions().addQueryParam(\"targetName\", \"chat-room\"));\n```\n\n### Async Operations\n\n```java\nasyncClient.sendToAll(\"Async message!\", WebPubSubContentType.TEXT_PLAIN)\n    .subscribe(\n        unused -> System.out.println(\"Message sent\"),\n        error -> System.err.println(\"Error: \" + error.getMessage())\n    );\n\nasyncClient.sendToGroup(\"developers\", \"Group message\", WebPubSubContentType.TEXT_PLAIN)\n    .doOnSuccess(v -> System.out.println(\"Sent to group\"))\n    .doOnError(e -> System.err.println(\"Failed: \" + e))\n    .subscribe();\n```\n\n## Error Handling\n\n```java\nimport com.azure.core.exception.HttpResponseException;\n\ntry {\n    client.sendToConnection(\"invalid-id\", \"test\", WebPubSubContentType.TEXT_PLAIN);\n} catch (HttpResponseException e) {\n    System.out.println(\"Status: \" + e.getResponse().getStatusCode());\n    System.out.println(\"Error: \" + e.getMessage());\n}\n```\n\n## Environment Variables\n\n```bash\nWEB_PUBSUB_CONNECTION_STRING=Endpoint=https:\u002F\u002F\u003Cresource>.webpubsub.azure.com;AccessKey=...\nWEB_PUBSUB_ENDPOINT=https:\u002F\u002F\u003Cresource>.webpubsub.azure.com\nWEB_PUBSUB_ACCESS_KEY=\u003Cyour-access-key>\n```\n\n## Client Roles\n\n| Role | Permission |\n|------|------------|\n| `webpubsub.joinLeaveGroup` | Join\u002Fleave any group |\n| `webpubsub.sendToGroup` | Send to any group |\n| `webpubsub.joinLeaveGroup.\u003Cgroup>` | Join\u002Fleave specific group |\n| `webpubsub.sendToGroup.\u003Cgroup>` | Send to specific group |\n\n## Best Practices\n\n1. **Use Groups**: Organize connections into groups for targeted messaging\n2. **User IDs**: Associate connections with user IDs for user-level messaging\n3. **Token Expiration**: Set appropriate token expiration for security\n4. **Roles**: Grant minimal required permissions via roles\n5. **Hub Isolation**: Use separate hubs for different application features\n6. **Connection Management**: Clean up inactive connections\n\n## Trigger Phrases\n\n- \"Web PubSub Java\"\n- \"WebSocket messaging Azure\"\n- \"real-time push notifications\"\n- \"server-sent events\"\n- \"chat application backend\"\n- \"live updates broadcasting\"\n\n## When to Use\nThis skill is applicable to execute the workflow or actions described in the overview.\n\n## Limitations\n- Use this skill only when the task clearly matches the scope described above.\n- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.\n- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.\n","","imported","https:\u002F\u002Fgithub.com\u002Fsickn33\u002Fantigravity-awesome-skills","user_system_seed","SkillOPIC",true,200,1903,"2026-05-16 13:06:48",{"id":8,"name":21,"slug":22,"icon":23,"description":24,"sort":25,"createdAt":26},"编程开发","coding","mdi-code-braces","代码生成、调试、审查，提升开发效率",2,"2026-05-16 12:53:40",{"id":7,"name":28,"slug":29,"icon":30,"description":31,"moduleId":8,"sort":32,"skillCount":33,"createdAt":26},"DevOps","devops","mdi-cog-outline","CI\u002FCD、容器化、部署运维",3,162,[35],{"id":36,"skillId":4,"version":37,"fileName":38,"fileSize":39,"filePath":40,"fileHash":41,"manifest":42,"createdAt":19},"4459b643-6bc8-4038-b625-dcb026a60dfe","1.0.0","azure-messaging-webpubsub-java.zip",2822,"uploads\u002Fskills\u002F11010efc-a382-4ccb-8274-e0bf3814a055\u002Fazure-messaging-webpubsub-java.zip","180af703db94723be71343d0830e8dc0b1a888af5d5a9d28a85899ede0ae66ee","[{\"path\":\"SKILL.md\",\"isDirectory\":false,\"size\":8995}]",{"code":17,"message":44,"data":45},"success",{"items":46,"stats":47,"page":50},[],{"averageRating":48,"totalRatings":48,"ratingCounts":49},0,[48,48,48,48,48],{"limit":51,"offset":48,"hasMore":52,"nextOffset":51,"ratedOnly":16},15,false]