This is an automated email from the ASF dual-hosted git repository. spmallette pushed a commit to branch driver-35 in repository https://gitbox.apache.org/repos/asf/tinkerpop.git
commit 86e0178d5d7693636efab4f9b3f1a991e5c6bc36 Author: Stephen Mallette <[email protected]> AuthorDate: Tue Oct 1 07:01:54 2019 -0400 Added upgrade docs/changelog for java driver --- CHANGELOG.asciidoc | 1 + docs/src/reference/gremlin-variants.asciidoc | 9 +++++++-- docs/src/upgrade/release-3.5.x.asciidoc | 10 ++++++++++ 3 files changed, 18 insertions(+), 2 deletions(-) diff --git a/CHANGELOG.asciidoc b/CHANGELOG.asciidoc index 976c2c7..876e0be 100644 --- a/CHANGELOG.asciidoc +++ b/CHANGELOG.asciidoc @@ -31,6 +31,7 @@ This release also includes changes from <<release-3-4-3, 3.4.3>>. * Added a `Graph.Feature` for `supportsNullPropertyValues`. * Refactored `MapStep` to move its logic to `ScalarMapStep` so that the old behavior could be preserved while allow other implementations to have more flexibility. * Modified TinkerGraph to support `null` property values and can be configured to disable that feature. +* Refactored the Java driver to use one connection per request. * Modified `null` handling in mutations to be consistent for a new `Vertex` as well as update to an existing one. * Removed support for Python 2.x in gremlinpython. * Upgraded to Apache Commons Configuration2. diff --git a/docs/src/reference/gremlin-variants.asciidoc b/docs/src/reference/gremlin-variants.asciidoc index 03fb705..7d0c58c 100644 --- a/docs/src/reference/gremlin-variants.asciidoc +++ b/docs/src/reference/gremlin-variants.asciidoc @@ -273,9 +273,14 @@ Please see the link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/t ==== Choosing a value for ConnectionPool.maxSize -`ConnectionPool.maxSize` represents the maximum number of concurrent requests that the client can make to the server. Each request is made using its own websocket connection, hence, this parameter also controls the maximum number of WebSocket connections that can be concurrently opened to the server. +`ConnectionPool.maxSize` represents the maximum number of concurrent requests that the client can make to the server. +Each request is made using its own websocket connection, hence, this parameter also controls the maximum number of +WebSocket connections that can be concurrently opened to the server. + +While choosing a value for this parameter, determine how many requests you anticipate to run in parallel from your +client. Beyond this number you would start getting timeout exceptions and should handle those timeouts at the +application layer. -While choosing a value for this parameter, determine how many requests you anticipate to run in parallel from your client. Beyond this number you would start getting timeout exceptions and should handle those timeouts at the application layer. === Serialization Remote systems like Gremlin Server and Remote Gremlin Providers respond to requests made in a particular serialization diff --git a/docs/src/upgrade/release-3.5.x.asciidoc b/docs/src/upgrade/release-3.5.x.asciidoc index 2e8913e..417d335 100644 --- a/docs/src/upgrade/release-3.5.x.asciidoc +++ b/docs/src/upgrade/release-3.5.x.asciidoc @@ -29,6 +29,16 @@ Please see the link:https://github.com/apache/tinkerpop/blob/3.5.0/CHANGELOG.asc === Upgrading for Users +==== Java Driver + +The `gremlin-driver` has undergone some significant changes that have improved it's usability and stability. By +modifying its request processing model to utilize a single channel, the logic for configuring the driver becomes less +entangled and easier to reason about as the removal of multiplexing eliminates the need to think about simultaneous +connection usage and requests in process. Instead, users simply need to consider the connection pool size which +represents the maximum number of concurrent requests that the client can make to the server. + +See: link:https://issues.apache.org/jira/browse/TINKERPOP-2205[TINKERPOP-2205] + ==== Gryo Usage Since the first release of TinkerPop 3.x, Gryo has been the default serialization format for Gremlin Server and
