tinkerpop-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From spmalle...@apache.org
Subject [tinkerpop] branch driver-35 updated: Added upgrade docs/changelog for java driver
Date Tue, 01 Oct 2019 11:02:30 GMT
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


The following commit(s) were added to refs/heads/driver-35 by this push:
     new b993a06  Added upgrade docs/changelog for java driver
b993a06 is described below

commit b993a06afcef63552f0a94f0f2ad66580cf7994d
Author: Stephen Mallette <spmva@genoprime.com>
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 b1b9e80..3645400 100644
--- a/CHANGELOG.asciidoc
+++ b/CHANGELOG.asciidoc
@@ -25,6 +25,7 @@ image::https://raw.githubusercontent.com/apache/tinkerpop/master/docs/static/ima
 
 This release also includes changes from <<release-3-4-3, 3.4.3>>.
 
+* 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.
 * Upgraded to Apache Commons Configuration2.
 * Renamed `StoreStep` to `AggregateLocalStep`.
diff --git a/docs/src/reference/gremlin-variants.asciidoc b/docs/src/reference/gremlin-variants.asciidoc
index 5aea700..28798bc 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 cd04b4e..e4f6310 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


Mime
View raw message