Aerospike Java client

For the complete documentation index see: llms.txt

All documentation pages available in markdown.

The Aerospike Java Client is a high-performance library that provides full access to the Aerospike Database from Java-based applications. Install com.aerospike:aerospike-client-jdk21 or aerospike-client-jdk8 as described in Install the Aerospike client.

Feature highlights

String operations: Server-side search, transform, and normalize String bins with String operations (StringOperation) and StringExp. Requires Aerospike Java client 10.5.0 and later and Aerospike Database 8.2.0 and later.
Error details: Subcodes, server messages, and expression traces from AerospikeException when Aerospike Database 8.2.0 and later returns them. Aerospike Java client 10.5.0 and later reads those fields. See Error handling.
Metrics and Dynamic Client Configuration (Aerospike Java client 9.1.0 and later). See Metrics.
Multi-record Transactions, batch commands, expressions, and Asynchronous API.

See the release notes for version history.

Core functionality

Data Operations

Create, read, update, and delete individual records.

Perform compound reads/writes and server-side logic in a single call.

Secondary Indexing & Queries

Query records using indexed bin values with secondary indexes.

Apply filter expressions and predicate logic on queries for precise targeting.

Batch & Scan

Retrieve or update multiple records in parallel with a single request. Batch and regular writes do not guarantee all-or-nothing behavior across records.

Iterate over all records in a set or namespace (use with caution in production environments).

Multi-Record Transactions

Group create, update, read, and delete steps across multiple keys with atomicity guarantees using multi-record transactions.

Asynchronous & Non-Blocking I/O

Event-loop-friendly, non-blocking operations using Java’s NIO or frameworks like Netty.

Compatible with reactive programming paradigms for high-throughput applications.