udb 0.3.1

Universal Data Broker — a Rust gRPC broker over multiple databases (Postgres, MySQL, SQLite, MongoDB, ClickHouse, Cassandra, MSSQL, Redis, Qdrant, S3, Neo4j, …) with per-tenant RLS, 2PC, sagas, and CDC.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77

# UDB Java SDK

`dev.udb:udb-java-client` is the Java client for UDB. It wraps the DataBroker
gRPC client, attaches UDB metadata, and includes generated request/response
types for the broker and native control-plane services.

Current manifest version: `0.3.1-SNAPSHOT`

Release target: `0.3.1`

Runtime: Java 17+

Maven Central publishing is still release-pipeline work. Until the public
artifact is available, build from this checkout:

```bash
mvn -f sdk/java/pom.xml test
```

## CLI And Proto Export

The Java build also packages a version-matched `udb` CLI wrapper. Once installed
or built, use it from your application repo to export UDB's shared protos:

```bash
udb proto export
```

Then your app protos can import:

```proto
import "udb/core/common/v1/db.proto";
```

## Connect And Query

```java
import com.udb.core.authz.services.v1.ResourceRef;
import com.udb.entity.v1.RecordSet;
import com.udb.entity.v1.SelectRequest;
import dev.udb.client.UdbAuthClient;
import dev.udb.client.UdbClient;
import dev.udb.client.UdbMetadata;
import java.util.List;

var meta = new UdbMetadata(
    "acme",
    "web.request",
    "request-001",
    List.of("udb:read", "udb:write"),
    "billing.api",
    "user-1",
    "billing",
    UdbClient.PROTOCOL_VERSION);

try (var udb = new UdbClient("localhost:50051", meta)) {
    RecordSet rows = udb.select(
        SelectRequest.newBuilder()
            .setMessageType("acme.billing.v1.Invoice")
            .setLimit(50)
            .build());
}

try (var auth = new UdbAuthClient("localhost:50051", meta)) {
    var decision = auth.can(
        ResourceRef.newBuilder()
            .setMessageType("acme.billing.v1.Invoice")
            .build(),
        "read",
        "");
}
```

## Notes For Users

Use `dev.udb.client.UdbClient` and `UdbAuthClient` for normal app code. The
`com.udb.*` packages provide the protobuf request/response types.