kenhuuu commented on code in PR #3433:
URL: https://github.com/apache/tinkerpop/pull/3433#discussion_r3357522226
##########
docs/src/upgrade/release-4.x.x.asciidoc:
##########
@@ -489,10 +489,37 @@ unwrap(toInt(29)); // 29
unwrap('hello'); // 'hello'
----
+==== Provider Defined Types
+
+Graph providers may now expose custom types as Provider Defined Types (PDT)
(replacing the old `CustomTypeSerializer`
+mechanism). The key improvement is that the default case now works out of the
box — drivers deserialize PDT values
+as `ProviderDefinedType` objects containing a `name` and a `properties` map
without any configuration, eliminating
+the serializer errors that occurred with unknown custom types in TP3. For
automatic conversion between PDT values and
+application-specific types, each driver supports an optional registry or
annotation mechanism, which requires similar
+effort to the old custom serializer approach but is entirely optional for
basic usage:
+
+* <<gremlin-java-pdt,Gremlin-Java>>
+* <<gremlin-python-pdt,Gremlin-Python>>
+* <<gremlin-javascript-pdt,Gremlin-JavaScript>>
+* <<gremlin-dotnet-pdt,Gremlin.Net>>
+* <<gremlin-go-pdt,Gremlin-Go>>
+
=== Upgrading for Providers
==== Graph System Providers
+===== Provider Defined Types
+
+TinkerPop 4 replaces the TP3 `CustomTypeSerializer` mechanism with Provider
Defined Types (PDT). The key improvement
Review Comment:
You might want to highlight this first sentence more. Providers need to know
that their current custom types will break and they have to move to using the
ProviderDefined mechanisms.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
