This is an automated email from the ASF dual-hosted git repository.
spmallette pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/tinkerpop.git
The following commit(s) were added to refs/heads/master by this push:
new 50d17905d7 Update GraphSON section examples for 4.x HTTP behavior
50d17905d7 is described below
commit 50d17905d780a2c05eb04e1727f67beeef6616f9
Author: Stephen Mallette <[email protected]>
AuthorDate: Wed Jul 22 14:49:18 2026 +0000
Update GraphSON section examples for 4.x HTTP behavior
Correct the GraphSON reference examples so they reflect 4.x behavior:
use the valid gremlin-lang expression g.inject(99) instead of 100-1,
show the current 4.0 response envelope, remove the obsolete GraphSON
3.0 Accept-header example that can no longer succeed, and fix the
untyped serializer class name to GraphSONUntypedMessageSerializerV4.
Assisted-by: Kiro:claude-opus-4.8
---
docs/src/reference/gremlin-applications.asciidoc | 10 ++++------
1 file changed, 4 insertions(+), 6 deletions(-)
diff --git a/docs/src/reference/gremlin-applications.asciidoc
b/docs/src/reference/gremlin-applications.asciidoc
index 1670e7748e..65dfac297a 100644
--- a/docs/src/reference/gremlin-applications.asciidoc
+++ b/docs/src/reference/gremlin-applications.asciidoc
@@ -1045,7 +1045,7 @@ available GraphSON serializers that can be configured:
|=========================================================
|Version |Embedded Types |Mime Type |Class
|4.0 |yes |`application/vnd.gremlin-v4.0+json` |`GraphSONMessageSerializerV4`
-|4.0 |no |`application/vnd.gremlin-v4.0+json;types=false`
|`GraphSONMessageSerializerV4`
+|4.0 |no |`application/vnd.gremlin-v4.0+json;types=false`
|`GraphSONUntypedMessageSerializerV4`
|=========================================================
The above serializer classes can be found in the
`org.apache.tinkerpop.gremlin.util.ser` package of `gremlin-util`.
@@ -1085,14 +1085,12 @@ NOTE: The below examples use GraphSON 1.0 and GraphSON
3.0 for example purposes,
[INFO] AbstractChannelizer - application/json already has
org.apache.tinkerpop.gremlin.util.ser.GraphSONMessageSerializerV1 configured -
it will not be replaced by
org.apache.tinkerpop.gremlin.util.ser.GraphSONMessageSerializerV3, change order
of serialization configuration if this is not desired.
----
-Given the above, using GraphSON 3.0 under this configuration will require that
the user specific the type:
+A request that does not specify an `Accept` header returns a response
serialized with the default GraphSON serializer:
[source,text]
----
-$ curl -X POST -d "{\"gremlin\":\"100-1\"}" "http://localhost:8182"
-{"requestId":"f8720ad9-2c8b-4eef-babe-21792a3e3157","status":{"message":"","code":200,"attributes":{}},"result":{"data":[99],"meta":{}}}
-$ curl -H "Accept:application/vnd.gremlin-v3.0+json" -X POST -d
"{\"gremlin\":\"100-1\"}" "http://localhost:8182"
-{"requestId":"9fdf0892-d86c-41f2-94b5-092785c473eb","status":{"message":"","code":200,"attributes":{"@type":"g:Map","@value":[]}},"result":{"data":{"@type":"g:List","@value":[{"@type":"g:Int32","@value":99}]},"meta":{"@type":"g:Map","@value":[]}}
+$ curl -X POST -d "{\"gremlin\":\"g.inject(99)\"}" "http://localhost:8182"
+{"result":{"data":[99]},"status":{"code":200}}
----
[[server-graphbinary]]