This is an automated email from the ASF dual-hosted git repository.
kenhuuu pushed a commit to branch tx-diag
in repository https://gitbox.apache.org/repos/asf/tinkerpop.git
The following commit(s) were added to refs/heads/tx-diag by this push:
new 3d7efbb377 update diagram format
3d7efbb377 is described below
commit 3d7efbb377c93a91ba8c00023e73ef0adde8fc85
Author: Ken Hu <[email protected]>
AuthorDate: Thu Feb 5 11:24:17 2026 -0800
update diagram format
---
docs/src/dev/transactions/http-api-spec.md | 25 +++++++++++--------------
1 file changed, 11 insertions(+), 14 deletions(-)
diff --git a/docs/src/dev/transactions/http-api-spec.md
b/docs/src/dev/transactions/http-api-spec.md
index 0e3016278b..2c4b092080 100644
--- a/docs/src/dev/transactions/http-api-spec.md
+++ b/docs/src/dev/transactions/http-api-spec.md
@@ -26,19 +26,16 @@ The server must detect these exact Gremlin strings to
handle transaction lifecyc
```mermaid
flowchart LR
subgraph detection["Transaction Control Detection"]
- begin['"g.tx().begin()"']
- commit['"g.tx().commit()"']
- rollback['"g.tx().rollback()"']
+ begin["g.tx#40;#41;.begin#40;#41;"]
+ commit["g.tx#40;#41;.commit#40;#41;"]
+ rollback["g.tx#40;#41;.rollback#40;#41;"]
other["Any other gremlin"]
end
- begin --> beginAction["Create new TransactionContext<br/>• Allocate
dedicated thread<br/>• Open graph transaction<br/>• Start inactivity
timeout<br/>• Store context keyed by transactionId"]
-
- commit --> commitAction["Commit and cleanup<br/>• Commit graph
transaction<br/>• Remove TransactionContext<br/>• Release dedicated
thread<br/>• Cancel timeout timer"]
-
- rollback --> rollbackAction["Rollback and cleanup<br/>• Rollback graph
transaction<br/>• Remove TransactionContext<br/>• Release dedicated
thread<br/>• Cancel timeout timer"]
-
- other --> otherAction["Execute within transaction<br/>• Lookup
TransactionContext by transactionId<br/>• Execute on transaction's thread<br/>•
Reset inactivity timeout"]
+ begin --> beginAction["Create new TransactionContext"]
+ commit --> commitAction["Commit and cleanup"]
+ rollback --> rollbackAction["Rollback and cleanup"]
+ other --> otherAction["Execute within transaction"]
```
**IMPORTANT:** String matching should be exact (after trimming whitespace)
@@ -91,10 +88,10 @@ flowchart TB
h1["Content-Type: application/json"]
h2["X-Transaction-Id: abc-123-def-456"]
end
- subgraph body["HTTP BODY (JSON)"]
- b1['"gremlin": "g.addV(\'person\')"']
- b2['"g": "gmodern"']
- b3['"transactionId": "abc-123-def-456"']
+ subgraph body["HTTP BODY #40;JSON#41;"]
+ b1["gremlin: g.addV#40;person#41;"]
+ b2["g: gmodern"]
+ b3["transactionId: abc-123-def-456"]
end
end
