@@ -52,7 +52,8 @@ const (
5252type DriverWithContext interface {
5353 // DefaultExecuteQueryBookmarkManager returns the bookmark manager instance used by ExecuteQuery by default.
5454 //
55- // This API is currently experimental and may change or be removed at any time.
55+ // DefaultExecuteQueryBookmarkManager is part of the BookmarkManager preview feature (see README on what it means in
56+ // terms of support and compatibility guarantees)
5657 //
5758 // This is useful when ExecuteQuery is called without custom bookmark managers and the lower-level
5859 // neo4j.SessionWithContext APIs are called as well.
@@ -87,7 +88,8 @@ type DriverWithContext interface {
8788
8889// ResultTransformer is a record accumulator that produces an instance of T when the processing of records is over.
8990//
90- // This API is currently experimental and may change or be removed at any time.
91+ // ResultTransformer is part of the ExecuteQuery preview feature (see README on what it means in terms of support
92+ // and compatibility guarantees)
9193type ResultTransformer [T any ] interface {
9294 // Accept is called whenever a new record is fetched from the server
9395 // Implementers are free to accumulate or discard the specified record
@@ -350,7 +352,7 @@ func (d *driverWithContext) Close(ctx context.Context) error {
350352// ExecuteQuery runs the specified query with its parameters and returns the query result, transformed by the specified
351353// ResultTransformer function.
352354//
353- // This API is currently experimental and may change or be removed at any time.
355+ // This is currently a preview feature (see README on what it means in terms of support and compatibility guarantees)
354356//
355357// result, err := ExecuteQuery[*EagerResult](ctx, driver, query, params, EagerResultTransformer)
356358//
@@ -545,12 +547,14 @@ func (e *eagerResultTransformer) Complete(keys []string, summary ResultSummary)
545547
546548// ExecuteQueryConfigurationOption is a callback that configures the execution of DriverWithContext.ExecuteQuery
547549//
548- // This API is currently experimental and may change or be removed at any time.
550+ // ExecuteQueryConfigurationOption is part of the ExecuteQuery preview feature (see README on what it means in terms of
551+ // support and compatibility guarantees)
549552type ExecuteQueryConfigurationOption func (* ExecuteQueryConfiguration )
550553
551554// ExecuteQueryWithReadersRouting configures DriverWithContext.ExecuteQuery to route to reader members of the cluster
552555//
553- // This API is currently experimental and may change or be removed at any time.
556+ // ExecuteQueryWithReadersRouting is part of the ExecuteQuery preview feature (see README on what it means in terms of
557+ // support and compatibility guarantees)
554558func ExecuteQueryWithReadersRouting () ExecuteQueryConfigurationOption {
555559 return func (configuration * ExecuteQueryConfiguration ) {
556560 configuration .Routing = Readers
@@ -559,7 +563,8 @@ func ExecuteQueryWithReadersRouting() ExecuteQueryConfigurationOption {
559563
560564// ExecuteQueryWithWritersRouting configures DriverWithContext.ExecuteQuery to route to writer members of the cluster
561565//
562- // This API is currently experimental and may change or be removed at any time.
566+ // ExecuteQueryWithWritersRouting is part of the ExecuteQuery preview feature (see README on what it means in terms of
567+ // support and compatibility guarantees)
563568func ExecuteQueryWithWritersRouting () ExecuteQueryConfigurationOption {
564569 return func (configuration * ExecuteQueryConfiguration ) {
565570 configuration .Routing = Writers
@@ -568,7 +573,8 @@ func ExecuteQueryWithWritersRouting() ExecuteQueryConfigurationOption {
568573
569574// ExecuteQueryWithImpersonatedUser configures DriverWithContext.ExecuteQuery to impersonate the specified user
570575//
571- // This API is currently experimental and may change or be removed at any time.
576+ // ExecuteQueryWithImpersonatedUser is part of the ExecuteQuery preview feature (see README on what it means in terms of
577+ // support and compatibility guarantees)
572578func ExecuteQueryWithImpersonatedUser (user string ) ExecuteQueryConfigurationOption {
573579 return func (configuration * ExecuteQueryConfiguration ) {
574580 configuration .ImpersonatedUser = user
@@ -577,7 +583,8 @@ func ExecuteQueryWithImpersonatedUser(user string) ExecuteQueryConfigurationOpti
577583
578584// ExecuteQueryWithDatabase configures DriverWithContext.ExecuteQuery to target the specified database
579585//
580- // This API is currently experimental and may change or be removed at any time.
586+ // ExecuteQueryWithDatabase is part of the ExecuteQuery preview feature (see README on what it means in terms of
587+ // support and compatibility guarantees)
581588func ExecuteQueryWithDatabase (db string ) ExecuteQueryConfigurationOption {
582589 return func (configuration * ExecuteQueryConfiguration ) {
583590 configuration .Database = db
@@ -586,7 +593,8 @@ func ExecuteQueryWithDatabase(db string) ExecuteQueryConfigurationOption {
586593
587594// ExecuteQueryWithBookmarkManager configures DriverWithContext.ExecuteQuery to rely on the specified BookmarkManager
588595//
589- // This API is currently experimental and may change or be removed at any time.
596+ // ExecuteQueryWithBookmarkManager is part of the ExecuteQuery preview feature (see README on what it means in terms of
597+ // support and compatibility guarantees)
590598func ExecuteQueryWithBookmarkManager (bookmarkManager BookmarkManager ) ExecuteQueryConfigurationOption {
591599 return func (configuration * ExecuteQueryConfiguration ) {
592600 configuration .BookmarkManager = bookmarkManager
@@ -595,7 +603,8 @@ func ExecuteQueryWithBookmarkManager(bookmarkManager BookmarkManager) ExecuteQue
595603
596604// ExecuteQueryWithoutBookmarkManager configures DriverWithContext.ExecuteQuery to not rely on any BookmarkManager
597605//
598- // This API is currently experimental and may change or be removed at any time.
606+ // ExecuteQueryWithoutBookmarkManager is part of the ExecuteQuery preview feature (see README on what it means in terms of
607+ // support and compatibility guarantees)
599608func ExecuteQueryWithoutBookmarkManager () ExecuteQueryConfigurationOption {
600609 return func (configuration * ExecuteQueryConfiguration ) {
601610 configuration .BookmarkManager = nil
@@ -604,7 +613,8 @@ func ExecuteQueryWithoutBookmarkManager() ExecuteQueryConfigurationOption {
604613
605614// ExecuteQueryWithBoltLogger configures DriverWithContext.ExecuteQuery to log Bolt messages with the provided BoltLogger
606615//
607- // This API is currently experimental and may change or be removed at any time.
616+ // ExecuteQueryWithBoltLogger is part of the ExecuteQuery preview feature (see README on what it means in terms of
617+ // support and compatibility guarantees)
608618func ExecuteQueryWithBoltLogger (boltLogger log.BoltLogger ) ExecuteQueryConfigurationOption {
609619 return func (configuration * ExecuteQueryConfiguration ) {
610620 configuration .BoltLogger = boltLogger
@@ -613,7 +623,8 @@ func ExecuteQueryWithBoltLogger(boltLogger log.BoltLogger) ExecuteQueryConfigura
613623
614624// ExecuteQueryConfiguration holds all the possible configuration settings for DriverWithContext.ExecuteQuery
615625//
616- // This API is currently experimental and may change or be removed at any time.
626+ // ExecuteQueryConfiguration is part of the ExecuteQuery preview feature (see README on what it means in terms of
627+ // support and compatibility guarantees)
617628type ExecuteQueryConfiguration struct {
618629 Routing RoutingControl
619630 ImpersonatedUser string
@@ -624,17 +635,20 @@ type ExecuteQueryConfiguration struct {
624635
625636// RoutingControl specifies how the query executed by DriverWithContext.ExecuteQuery is to be routed
626637//
627- // This API is currently experimental and may change or be removed at any time.
638+ // RoutingControl is part of the ExecuteQuery preview feature (see README on what it means in terms of support and
639+ // compatibility guarantees)
628640type RoutingControl int
629641
630642const (
631643 // Writers routes the query to execute to a writer member of the cluster
632644 //
633- // This API is currently experimental and may change or be removed at any time.
645+ // Writers is part of the ExecuteQuery preview feature (see README on what it means in terms of
646+ // support and compatibility guarantees)
634647 Writers RoutingControl = iota
635648 // Readers routes the query to execute to a writer member of the cluster
636649 //
637- // This API is currently experimental and may change or be removed at any time.
650+ // Readers is part of the ExecuteQuery preview feature (see README on what it means in terms of
651+ // support and compatibility guarantees)
638652 Readers
639653)
640654
@@ -662,7 +676,8 @@ func (c *ExecuteQueryConfiguration) selectTxFunctionApi(session SessionWithConte
662676
663677// EagerResult holds the result and result metadata of the query executed via DriverWithContext.ExecuteQuery
664678//
665- // This API is currently experimental and may change or be removed at any time.
679+ // EagerResult is part of the ExecuteQuery preview feature (see README on what it means in terms of
680+ // support and compatibility guarantees)
666681type EagerResult struct {
667682 Keys []string
668683 Records []* Record
0 commit comments