neo4j-dotnet-driver

What's Changed

🔬 Experimental change

• Fixed an issue bookmark manager experimental classes: correctly exposing WithBookmarkManager to use bookmark managers on session configuration(#654).

Full Changelog: https://github.com/neo4j/neo4j-dotnet-driver/compare/5.1.0...5.2.0

What's Changed

No changes.

Full Changelog: https://github.com/neo4j/neo4j-dotnet-driver/compare/5.0.0...5.1.0

5.0 Changelog

final tidying for major release.

Nuget

⭐ New Features

• Introduce Experimental Bookmark Manager. (Not recommended for production use currently.) (#632)
  • Using Neo4j.Driver.Experimental.GraphDatabase.BookmarkManagerFactory users can create an IBookmarkManager.
  • IBookmarkManager can be passed to SessionConfigBuilder when creating a creating a session by using the Neo4j.Driver.Experimental.ExperimentalExtensions to add WithBookmarkManager to SessionConfigBuilder.
  • The Experimental methods will be finalized as:
    • Neo4j.Driver.Experimental.GraphDatabase.BookmarkManagerFactory -> Neo4j.Driver.GraphDatabase.BookmarkManagerFactory
    • Neo4j.Driver.Experimental.ExperimentalExtensions -> Neo4j.Driver.SessionConfigBuilder.

🔧 Fixes

• Transaction lifetimes. (#640)
  • ⚠️ remaining managed transactions have been deprecated and replaced, removing the ability to commit or rollback transactions inside the unit of work scope.
    • ISession.ReadTransaction -> ISession.ExecuteRead
    • ISession.WriteTransaction -> ISession.ExecuteWrite
    • IRxSession.ReadTransaction -> IRxSession.ExecuteRead
    • IRxSession.WriteTransaction -> IRxSession.ExecuteWrite

🧹 Clean-up

• Removal of 4.X Deprecations
  • Removal of IServerInfo.Version (#638)

This release introduces full support for Neo4j 5.0 Servers.

Nuget

👏 .NET 6 Support

We now release for .NET 6.0 and .NET Standard 2.0.

• Support for DateOnly, TimeOnly types. (#616)

⭐ New Features

• Support for Bolt protocol version 5.0
  • ⚠️ Deprecate all IEntity integer ids replacing them with string ids:
    • IEntity.Id -> IEntity.ElementId
    • INode.Id -> INode.ElementId
    • IRelationship.Id -> IRelationship.ElementId
    • IRelationship.EndNodeId -> IRelationship.EndNodeElementId
    • IRelationship.StartNodeId -> IRelationship.StartNodeElementId
      (#573 #591 #600 #618)
  • Utc Encoding of ZonedDateTime (#630 #637)
• SSL Configuration(#585)
  • SSL certificate trust rules can be set on driver initialization using ConfigBuilder.WithCertificateTrustRule
    • CertificateTrustRule.TrustSystem
      • Will verify certificates against the system's Certificate Authority store.
    • CertificateTrustRule.TrustList
      • Users can specify a collection of X509Certificate2 or paths to load as trusted certificates.
    • CertificateTrustRule.TrustAny
      • Will trust any SSL Cert.
  • ⚠️ Users can not use both ConfigBuilder.WithCertificateTrustRule and +s/+ssc in the url scheme at the same time.
• Added Driver.GetServerInfoAsync. (#605)
  • Will verify connectivity and return a IServerInfo detailing server summary.
• Added CanBeRetried to Exception. (#613)
  • All errors from driver that can be resolved by retrying an operation will return true.
• Add IsOpen to Result cursors. (#610)
  • IsOpen will return if the underlying cursor is open to read records; Attempting to read from a closed cursor will throw a ResultConsumedException.
• Connection Acquisition Timeout (#588)
  • ConfigBuilder.WithConnectionAcquisitionTimeout allows users to set maximum wait time to get a connection from the pool or create a new connection on driver initialization.
  • ⚠️ default: 60 seconds

🔧 Fixes

• Transaction lifetimes. (#612)
  • ⚠️ Async managed transactions have been deprecated and replaced, removing the ability to commit or rollback transactions inside the unit of work scope.
    • IAsyncSession.ReadTransactionAsync -> IAsyncSession.ExecuteReadAsync
    • IAsyncSession.WriteTransactionAsync -> IAsyncSession.ExecuteWriteAsync
  • Attempting close a transaction after it has been closed will now throw a TransactionClosedException.
• Rename Bookmark to Bookmarks. (#609)
  • ⚠️ Due to a mix of language Bookmark and all references to bookmarks have been pluralized as it allows for multiple values.
  • Bookmark -> Bookmarks
  • Session.LastBookmark -> Session.LastBookmarks
  • SessionConfigBuilder.WithBookmarks(Bookmark[]) -> SessionConfigBuilder.WithBookmarks(Bookmarks[])
• Transaction timeout (#574)
  • TransactionConfigBuilder.WithTimeout now accepts Nullable<TimeSpan> for timeout.
    • ⚠️ null will use the server's default transaction timeout.
    • ⚠️ TimeSpan.Zero will remove timeout from transaction.
• No longer throwing when using APOC procedures in a profiled query. (#633)
• Discovery exceptions. (#594)
• Error message handling. (#592)

Full Changelog: https://github.com/neo4j/neo4j-dotnet-driver/compare/4.4.0...5.0.0-beta01

4.4.0

This release introduces support for Neo4j 4.4 alongside new features and improvements.

⭐ New Features

• Introduce impersonation support
• Add bearer authentication support for single sign on
• Add Bolt 4.4 support

👏 Improvements

• Added InvalidBookmarkException to the driver Invalid bookmark exception
• Inheritance in protocol objects improved to reduce code duplication and bloat.
• Introduction examples have been improved Examples
• Added ConnectionReadTimeoutException to the driver Timeout exception
• Implemented an extension method to the .Net Stream class, ReadWithTimeoutAsync. This is used by the ChunkReader at the lowest level so that it can timeout if the nothing is read from the stream for a specified time.

✅ Testkit

• Add kerberos auth to TestKit backend
• Add Feature:Auth:Custom Testkit feature support
• Add supported protocol versions to testkit backend
• Testkit output now goes to stdout/etderr. From there TestKit can pick it up and write it into logfiles if desired #562

The first release of 1.7 series drivers.
Checkout the changelog for more details.

This release provides a bug fix. See changelog for more details.

This release provides a couple of bug fixes and improvements. See changelog for more details.

General availability release. See changelog for more details.

This release provides a couple of bug fixes and dependency improvements. See changelog for more details.

This release provides full support for temporal and spatial types with an updated public API. See changelog for more details.

This release provides a few bugs fixes. See changelog for more details.

This release provides a few bugs fixes we found since the first release of 1.5.0.
We also improved the stability of cluster connection pool to not kill connection with on-going transactions.

General availability release. See changelog for more details.

Small improvement to Config default values.
See changelog for more info.

This release provides a few bug fixes and internal implementation improvement.
Check the changelog for more information.

This release include full support of Both Sync and Async API for both Direct and Routing driver.