[jira] [Created] (TINKERPOP-2630) Clarify that a server cannot support Graphson1.0 over HTTP

["Divij Vaidya (Jira)" <ji...@apache.org>]

Divij Vaidya created TINKERPOP-2630:
---------------------------------------

             Summary: Clarify that a server cannot support Graphson1.0 over HTTP
                 Key: TINKERPOP-2630
                 URL: https://issues.apache.org/jira/browse/TINKERPOP-2630
             Project: TinkerPop
          Issue Type: Improvement
          Components: documentation
    Affects Versions: 3.4.12
            Reporter: Divij Vaidya


If a user sends an HTTP request to the server with MIME type for Graphson1.0 in the accept header, the server will always return an error, irrespective of the configured serializers. 

This is because the only serializer which support MIME type `application/vnd.gremlin-v1.0+json` is `GraphSONMessageSerializerGremlinV1d0` and it will not work with HTTP requests because it's not a `MessageTextSerializer`

We should clarify this somewhere in the docs. 

Alternatively, we can support graphson v1.0 over HTTP by:
1. Register both `GraphSONMessageSerializerV1d0` and `GraphSONMessageSerializerGremlinV1d0` serializers with the server.
2. Add graphson v1.0 to supported mime types of `GraphSONMessageSerializerV1d0`
3. Change HttpEndpointHandler's chooseSerializer method to favour a MessageTextSerializer when two serializers are available for asme MIME type.

Given that graphson 1.0 is on the path to deprecation, I would suggest that we just make a change to the documentation at this stage instead of alternative option.



--
This message was sent by Atlassian Jira
(v8.3.4#803005)