You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@tinkerpop.apache.org by jo...@apache.org on 2017/09/20 10:32:37 UTC
[30/50] [abbrv] tinkerpop git commit: Merged TINKERPOP-1692
Merged TINKERPOP-1692
Project: http://git-wip-us.apache.org/repos/asf/tinkerpop/repo
Commit: http://git-wip-us.apache.org/repos/asf/tinkerpop/commit/1fc2ad7b
Tree: http://git-wip-us.apache.org/repos/asf/tinkerpop/tree/1fc2ad7b
Diff: http://git-wip-us.apache.org/repos/asf/tinkerpop/diff/1fc2ad7b
Branch: refs/heads/TINKERPOP-1730
Commit: 1fc2ad7b363cad5c662ad2037bf1c55a62480e55
Parents: dd09c05 3e764d8
Author: Robert Dale <ro...@gmail.com>
Authored: Fri Sep 15 07:45:52 2017 -0400
Committer: Robert Dale <ro...@gmail.com>
Committed: Fri Sep 15 07:45:52 2017 -0400
----------------------------------------------------------------------
CHANGELOG.asciidoc | 2 +
.../reference/implementations-neo4j.asciidoc | 16 ++++----
docs/src/upgrade/release-3.3.x.asciidoc | 16 ++++++++
.../conf/neo4j-standalone.properties | 6 ++-
gremlin-server/conf/neo4j-empty.properties | 6 ++-
neo4j-gremlin/pom.xml | 41 ++++++++++++++++----
.../neo4j/process/NativeNeo4jCypherCheck.java | 4 +-
.../structure/NativeNeo4jStructureCheck.java | 22 +++++------
8 files changed, 80 insertions(+), 33 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/tinkerpop/blob/1fc2ad7b/CHANGELOG.asciidoc
----------------------------------------------------------------------
diff --cc CHANGELOG.asciidoc
index e067a99,2c66d9e..6afa37f
--- a/CHANGELOG.asciidoc
+++ b/CHANGELOG.asciidoc
@@@ -28,8 -28,8 +28,10 @@@ TinkerPop 3.3.1 (Release Date: NOT OFFI
This release also includes changes from <<release-3-2-7, 3.2.7>>.
+* Added `Io.requiresVersion(Object)` to allow graph providers a way to check the `Io` type and version being constructed.
+* Defaulted `IoCore.gryo()` and `IoCore.graphson()` to both use their 3.0 formats which means that `Graph.io()` will use those by default.
+ * Bumped Neo4j 3.2.3
+
[[release-3-3-0]]
TinkerPop 3.3.0 (Release Date: August 21, 2017)
http://git-wip-us.apache.org/repos/asf/tinkerpop/blob/1fc2ad7b/docs/src/upgrade/release-3.3.x.asciidoc
----------------------------------------------------------------------
diff --cc docs/src/upgrade/release-3.3.x.asciidoc
index 702a0a3,3ba8226..5bcbbf8
--- a/docs/src/upgrade/release-3.3.x.asciidoc
+++ b/docs/src/upgrade/release-3.3.x.asciidoc
@@@ -32,43 -32,22 +32,59 @@@ Please see the link:https://github.com/
Upgrading for Users
~~~~~~~~~~~~~~~~~~~
+IO Defaults
+^^^^^^^^^^^
+
+While 3.3.0 released Gryo 3.0 and GraphSON 3.0 and these versions were defaulted in a number of places, it seems that
+some key defaults were missed. Specifically, calls to `Graph.io(graphson())` and `Graph.io(gryo())` were still using
+the old versions. The defaults have now been changed to ensure 3.0 is properly referenced in those cases.
+
+Upgrading for Providers
+~~~~~~~~~~~~~~~~~~~~~~~
+
+IMPORTANT: It is recommended that providers also review all the upgrade instructions specified for users. Many of the
+changes there may prove important for the provider's implementation.
+
+Graph Database Providers
+^^^^^^^^^^^^^^^^^^^^^^^^
+
+IO Version Check
+++++++++++++++++
+
+In the `Graph.io()` method, providers are to bootstrap the `Io` instance returned with their own custom serializers
+typically provided through a custom `IoRegistry` instance. Prior to this change it was not possible to easily determine
+the version of `Io` that was expected (nor was it especially necessary as TinkerPop didn't have breaking format changes
+between versions). As of 3.3.0 however, there could be IO test incompatibilities for some providers who need to
+register a different `IoRegistry` instance depending on the version the user wants.
+
+To allow for that check, the `Io` interface now has the following method:
+
+[source,java]
+----
+public <V> boolean requiresVersion(final V version);
+----
+
+which allows the graph provider to check if a specific `GryoVersion` or `GraphSONVersion` is required. Using that
+information, the provider could then assign the right `IoRegistry` to match that.
+
+See: link:https://issues.apache.org/jira/browse/TINKERPOP-1767[TINKERPOP-1767]
+
+ Upgrade Neo4j
+ ^^^^^^^^^^^^^
+
+ See Neo4j's link:https://neo4j.com/guides/upgrade/[3.2 Upgrade FAQ] for a complete guide on how to upgrade from the previous 2.3.3 version. Also note that many of the configuration settings have link:https://neo4j.com/developer/kb/manually-migrating-configuration-settings-from-neo4j-2x-to-neo4j-3x/[changed from neo4j 2x to 3x]
+
+ In particular, these properties referenced in TinkerPop documentation and configuration were renamed:
+
+ |=========================================================
+ |old (2.3) |new (3.3)
+ |node_auto_indexing |dbms.auto_index.nodes.enabled
+ |relationship_auto_indexing |dbms.auto_index.relationships.enabled
+ |ha.cluster_server |ha.host.coordination
+ |ha.server |ha.host.data
+ |=========================================================
+
+
TinkerPop 3.3.0
---------------