Skip to content

Gremlinq.Extensions 14.2.0

Gremlinq.Extensions 14.2.0 is built against ExRam.Gremlinq 14.2.0. See the ExRam.Gremlinq 14.2.0 release notes for what changed there, TinkerPop 3.8 support above all. (#306)

Features

TinkerPop 3.8 in System.Text.Json

The System.Text.Json support in Gremlinq.Extensions.Support.SystemTextJson follows the server compatibility range that ExRam.Gremlinq 14.2.0 introduces, and writes and reads the same forms as Newtonsoft.

  • Gremlinq.Extensions now depends on Gremlin.Net 3.8.2, through ExRam.Gremlinq. The requests, the answers and the public API stay the same. (#288)
  • A gx:OffsetDateTime, which a TinkerPop 3.8 server answers asDate() and dateAdd() with, is now read as a DateTimeOffset that keeps its offset. Before, it was moved to UTC or stayed a string. (#291)
  • For a server compatibility range from 3.8 on, a DateTimeOffset is written as gx:OffsetDateTime instead of g:Date. (#293)
  • For a range from 3.8 on, a gx:Byte is read as an sbyte, as Gremlin.Net 3.8 reads it. Below 3.8, and for a range that spans both, it stays a byte. (#292)
  • For a range from 3.8 on, strategies and strategy types are written as Gremlin.Net 3.8 writes them. Gremlin Server 3.8.2 cannot read the 3.7 form. (#298)
  • UseCosmosDb sets the server compatibility range to TinkerPop 3.4.13, the version CosmosDb understands, before a configured range is applied. No query changes. (#294)

Deserialization

  • A g:Map or a plain object is now built into any dictionary class with a public parameterless constructor, such as SortedDictionary<,>, SortedList<,> or a class derived from Dictionary<,>, keys as they were typed. (#247)
  • A ReadOnlyDictionary<,> and a class that implements IDictionary<,> twice are now built, as Newtonsoft builds them. (#252)
  • A class that implements IReadOnlyDictionary<,> but no IDictionary<,> is built again. 14.1.2 declined it. (#257)
  • A dictionary is also built through a constructor that takes an IReadOnlyDictionary<,>, where only a constructor taking IDictionary<,> counted before. (#259)
  • A value requested as a generic interface of a scalar type, such as IEquatable<int> or INumber<int>, is now read as that scalar type instead of being declined. (#251)

Fixes

  • System.Text.Json no longer throws for input it cannot read, such as a number too large for the requested int or a null value for a Property<string>. It declines the value. A type of your own that derives from Property<T> is read like Property<T>, and a VertexProperty<T> gets its key. (#239)
  • A dictionary keeps a null value when its value type can hold one, from a g:Map as from a plain object. It is a real null, never a JsonElement. (#240)
  • A typed value such as a g:Int32 is no longer read as a dictionary of its @type and @value. A collection of key-value pairs gets the same answer as a Dictionary<string, object>, and a vertex read into a dictionary gives its properties. (#241)

Performance

  • Typed g:Tree values are read faster: the tree converter reads them itself, without a detour through the typed-value converter per level. (#260)

Full changelog: https://github.com/Gremlinq/Gremlinq.Extensions/compare/14.1.2...14.2.0