Azure Web PubSub SDK for Java Acceptance Criteria

SDK: com.azure:azure-messaging-webpubsubRepository: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/webpubsub/azure-messaging-webpubsubPurpose: Skill testing acceptance criteria for validating generated code correctness

---

1. Correct Import Patterns

1.1 Client Imports

✅ CORRECT: Service Clients

import com.azure.messaging.webpubsub.WebPubSubServiceClient;
import com.azure.messaging.webpubsub.WebPubSubServiceClientBuilder;
import com.azure.messaging.webpubsub.WebPubSubServiceAsyncClient;

✅ CORRECT: Authentication

import com.azure.identity.DefaultAzureCredentialBuilder;
import com.azure.core.credential.AzureKeyCredential;

1.2 Model Imports

✅ CORRECT: Web PubSub Models

import com.azure.messaging.webpubsub.models.WebPubSubContentType;
import com.azure.messaging.webpubsub.models.GetClientAccessTokenOptions;
import com.azure.messaging.webpubsub.models.WebPubSubClientAccessToken;
import com.azure.messaging.webpubsub.models.WebPubSubPermission;

---

2. Client Creation Patterns

2.1 ✅ CORRECT: Builder with Connection String

String connectionString = System.getenv("WEB_PUBSUB_CONNECTION_STRING");

WebPubSubServiceClient client = new WebPubSubServiceClientBuilder()
    .connectionString(connectionString)
    .hub("chat")
    .buildClient();

2.2 ✅ CORRECT: Builder with DefaultAzureCredential

String endpoint = System.getenv("WEB_PUBSUB_ENDPOINT");

WebPubSubServiceClient client = new WebPubSubServiceClientBuilder()
    .credential(new DefaultAzureCredentialBuilder().build())
    .endpoint(endpoint)
    .hub("chat")
    .buildClient();

---

3. Send Messages

3.1 ✅ CORRECT: Send to All

client.sendToAll("Hello everyone!", WebPubSubContentType.TEXT_PLAIN);

3.2 ✅ CORRECT: Send JSON to All

String jsonMessage = "{\"type\": \"notification\", \"message\": \"Update\"}";
client.sendToAll(jsonMessage, WebPubSubContentType.APPLICATION_JSON);

3.3 ✅ CORRECT: Send to Group

client.sendToGroup("developers", "Hello devs!", WebPubSubContentType.TEXT_PLAIN);

3.4 ✅ CORRECT: Send to User

client.sendToUser("userId123", "Private message", WebPubSubContentType.TEXT_PLAIN);

---

4. Group Management

4.1 ✅ CORRECT: Add/Remove Connection to Group

client.addConnectionToGroup("premium-users", "connectionId123");
client.removeConnectionFromGroup("premium-users", "connectionId123");

4.2 ✅ CORRECT: Add/Remove User to Group

client.addUserToGroup("admin-group", "userId456");
client.removeUserFromGroup("admin-group", "userId456");

---

5. Client Access Token

5.1 ✅ CORRECT: Generate Token

WebPubSubClientAccessToken token = client.getClientAccessToken(
    new GetClientAccessTokenOptions()
        .setUserId("user123")
        .addRole("webpubsub.sendToGroup")
        .addGroup("announcements"));

System.out.println("URL: " + token.getUrl());

---

6. Connection Management

6.1 ✅ CORRECT: Check and Close Connections

boolean connected = client.connectionExists("connectionId123");
client.closeConnection("connectionId123");
client.closeUserConnections("userId456");

---

7. Error Handling

7.1 ✅ CORRECT: HTTP Exception Handling

import com.azure.core.exception.HttpResponseException;

try {
    client.sendToConnection("invalid-id", "test", WebPubSubContentType.TEXT_PLAIN);
} catch (HttpResponseException e) {
    System.out.println("Status: " + e.getResponse().getStatusCode());
}

---

8. Best Practices Checklist

• [ ] Use environment variables for connection configuration
• [ ] Organize connections into groups for targeted messaging
• [ ] Associate connections with user IDs
• [ ] Set appropriate token expiration for security
• [ ] Grant minimal required permissions via roles