Skip to content

fix: update Java README transaction examples to transactions() API #719

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
curfew-marathon merged 2 commits into from
Aug 2, 2026
Merged

fix: update Java README transaction examples to transactions() API #719

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
38e99cd
fix: update Java README transaction examples to transactions() API
curfew-marathon Aug 1, 2026
f790997
fix: clarify non-transaction mode wording in Java README
curfew-marathon Aug 1, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 5 additions & 5 deletions config/clients/java/template/README_calling_api.mustache
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -288,7 +288,7 @@ var options = new ClientWriteOptions()
.additionalHeaders(Map.of("Some-Http-Header", "Some value"))
// You can rely on the model id set in the configuration or override it for this specific request
.authorizationModelId("01GXSA8YR785C4FYS3C0RTG7B1")
.disableTransactions(false);
.transactions(true);
Comment thread
curfew-marathon marked this conversation as resolved.

var response = fgaClient.write(request, options).get();
```
Expand All @@ -297,9 +297,9 @@ Convenience `WriteTuples` and `DeleteTuples` methods are also available.

###### Non-transaction mode

The SDK will split the writes into separate requests and send them sequentially to avoid violating rate limits.
The SDK will split the writes into separate chunks and send them in parallel. Each chunk is sent as its own transaction.

> Passing `ClientWriteOptions` with `.disableTransactions(true)` is required to use non-transaction mode.
> Passing `ClientWriteOptions` with `.transactions(false)` is required to use non-transaction mode.
> All other fields of `ClientWriteOptions` are optional.

```java
Expand All @@ -324,8 +324,8 @@ var options = new ClientWriteOptions()
.additionalHeaders(Map.of("Some-Http-Header", "Some value"))
// You can rely on the model id set in the configuration or override it for this specific request
.authorizationModelId("01GXSA8YR785C4FYS3C0RTG7B1")
.disableTransactions(true)
.transactionChunkSize(5); // Maximum number of requests to be sent in a transaction in a particular chunk
.transactions(false)
.transactionChunkSize(5); // Max tuples per chunk; each chunk is sent as its own transaction

var response = fgaClient.write(request, options).get();
```
Expand Down
Loading