Java SDK Guide¶

The Azure Communication Services (ACS) Java SDK allows developers to integrate SMS, email, chat, and voice calling into their applications. It follows standard Azure SDK for Java patterns, offering both synchronous and asynchronous clients.

Maven Packages¶

The Java SDK is modular. You only need to include the specific dependencies for the features you use.

Prerequisites¶

• Java Development Kit (JDK) 8 or later.
• Apache Maven for dependency management.
• An active Azure subscription and an ACS resource.

Quick Start: Create an Identity Token¶

import com.azure.communication.identity.CommunicationIdentityClient;
import com.azure.communication.identity.CommunicationIdentityClientBuilder;
import com.azure.communication.identity.models.CommunicationUserIdentifier;
import com.azure.communication.identity.models.CommunicationTokenScope;
import com.azure.core.credential.AccessToken;
import java.util.Arrays;

public class App {
    public static void main(String[] args) {
        String connectionString = System.getenv("COMMUNICATION_SERVICES_CONNECTION_STRING");

        CommunicationIdentityClient client = new CommunicationIdentityClientBuilder()
            .connectionString(connectionString)
            .buildClient();

        CommunicationUserIdentifier user = client.createUser();
        AccessToken token = client.getToken(user, Arrays.asList(CommunicationTokenScope.CHAT));

        System.out.println("User ID: " + user.getId());
        System.out.println("Token: " + token.getToken());
    }
}

SDK Architecture¶

The Java SDK uses a builder pattern for client instantiation and provides a consistent experience across different service clients.

graph TD
    Builder[ClientBuilder] -->|buildClient| SyncClient[Synchronous Client]
    Builder -->|buildAsyncClient| AsyncClient[Asynchronous Client]
    SyncClient -->|Response| App[Your Application]
    AsyncClient -->|Mono/Flux| App

Next Steps¶

• Tutorial: A complete guide to building a communication-enabled application.
• Recipes: Snippets for specific common tasks and configurations.

Sources¶

• Azure Communication Services Java SDK Reference
• Maven Central Repository