Document storage and indexed queries for Java.

R2D1 combines one DocumentStore with one IndexStore. Select one backend from each column, follow its setup guide, and then use the shared collection API.

Once the two backends are configured, every pairing uses the same annotations, collection lifecycle, mutation methods, and indexed query builder.

@Document("users")
record User(@Id String id, @Index String country, @Index long score) {}

R2D1 database = R2D1.builder()
    .collectionFactory(new PersistenceCollectionFactory(
        documentStore, indexStore, documentCodec, indexStore::initialize))
    .build();

R2D1Collection<User> users = database.collection(User.class);
users.put(new User("user-123", "NZ", 42));

Page<User> page = users.query()
    .where("country").eq("NZ")
    .sortBy("score", SortDirection.DESC)
    .limit(20)
    .fetch();

The complete setup, adapter choices, and lifecycle rules are covered in Getting Started.

The core artifact covers the common API and Cloudflare backends. Add the module that supplies local files, JDBC indexing, or Micronaut wiring.