What problem does it solve?
Provides Java developers a consistent, documented way to interact with Azure Cosmos DB so they can implement scalable NoSQL data access without reinventing client patterns and error handling logic.
Core Features & Use Cases
- Client creation and configuration guidance for both synchronous CosmosClient and reactive CosmosAsyncClient, including credential and preferred-region options.
- Database and container lifecycle operations, partition key design guidance, CRUD patterns, parameterized queries, paging with continuation tokens, and RU charge monitoring.
- Best practices for production scenarios: reuse and lifecycle management of clients, 429/rate-limit handling, retry policies, direct/gateway modes, and region-aware high-throughput architectures.
- Typical use cases include multi-region telemetry ingestion, session-consistent user stores, batched async processing pipelines, and query-heavy analytics with controlled RU consumption.
Quick Start
Instantiate a CosmosAsyncClient using environment variables COSMOS_ENDPOINT and COSMOS_KEY, create or open a database and container, then run a single create-read-update-delete sequence to verify connectivity and basic CRUD behavior.