dohertj2/mxaccessgw
1
0
Fork 0
Code Issues 43 Pull Requests 1 Actions Packages Projects Releases Wiki Activity

docs(clients): ReadBulk timeout is one shared deadline for the command, not per tag

Browse Source 
Stream E made the worker wait once for all uncached tags. Fix the Go, Python, Rust, Java
and .NET library docs and CLI help text, the proto comment (default is the worker's
1000 ms), and the worker design doc. Regenerated Contracts Generated/ and the Java
generated protos; both diffs are comment-only.
This commit is contained in:
Joseph Doherty
2026-10-22 08:46:29 -04:00
parent 3ffba83723
commit dd623356f4
13 changed files with 57 additions and 33 deletions
Download Patch File Download Diff File Expand all files Collapse all files
clients/java/src/main/generated/main/java/mxaccess_gateway/v1/MxaccessGateway.java
+16 -8
View File
@@ -49125,11 +49125,15 @@ public final class MxaccessGateway extends com.google.protobuf.GeneratedFile {
* reply returns the cached value WITHOUT modifying the existing
* subscription (was_cached = true).
* - Otherwise the worker takes the snapshot lifecycle itself: AddItem +
* Advise, wait up to `timeout_ms` for the first OnDataChange, then
* UnAdvise + RemoveItem before returning. The session is left exactly
* as it was before the call (was_cached = false).
* Advise, wait for the first OnDataChange, then UnAdvise + RemoveItem
* before returning. The session is left exactly as it was before the
* call (was_cached = false).
*
* `timeout_ms == 0` uses the gateway-configured default (1000 ms).
* `timeout_ms` is one deadline shared by the whole command, not a per-tag
* budget: the worker adds and advises every uncached tag, waits once for all
* of them, then tears them all down. A tag that has not delivered by the
* deadline gets its own was_successful = false result.
* `timeout_ms == 0` uses the worker's default (1000 ms).
* </pre>
*
* Protobuf type {@code mxaccess_gateway.v1.ReadBulkCommand}
@@ -49424,11 +49428,15 @@ public final class MxaccessGateway extends com.google.protobuf.GeneratedFile {
* reply returns the cached value WITHOUT modifying the existing
* subscription (was_cached = true).
* - Otherwise the worker takes the snapshot lifecycle itself: AddItem +
* Advise, wait up to `timeout_ms` for the first OnDataChange, then
* UnAdvise + RemoveItem before returning. The session is left exactly
* as it was before the call (was_cached = false).
* Advise, wait for the first OnDataChange, then UnAdvise + RemoveItem
* before returning. The session is left exactly as it was before the
* call (was_cached = false).
*
* `timeout_ms == 0` uses the gateway-configured default (1000 ms).
* `timeout_ms` is one deadline shared by the whole command, not a per-tag
* budget: the worker adds and advises every uncached tag, waits once for all
* of them, then tears them all down. A tag that has not delivered by the
* deadline gets its own was_successful = false result.
* `timeout_ms == 0` uses the worker's default (1000 ms).
* </pre>
*
* Protobuf type {@code mxaccess_gateway.v1.ReadBulkCommand}