Skip to content

Release 3.9.0 with Release Notes instead of Summary #134

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Aug 12, 2025
Merged

Release 3.9.0 with Release Notes instead of Summary #134

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
617a9d3
Release 3.9.0 with Release Notes instead of Summary
mikereiche Aug 11, 2025
2931063
Gardening
RichardSmedley Aug 12, 2025
c1dad65
Update sdk-release-notes.adoc
RichardSmedley Aug 12, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
118 changes: 53 additions & 65 deletions modules/project-docs/pages/sdk-release-notes.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -71,92 +71,80 @@ The supported and tested dependencies for this release are:
* org.reactivestreams:**reactive-streams:1.0.4**


====New Features
==== Behavioral Changes

https://couchbasecloud.atlassian.net/browse/SCBC-378[SCBC-378]:
Support Scala 3.

https://couchbasecloud.atlassian.net/browse/SCBC-476[SCBC-476]:
Implement `ExtGetMulti` (aka Enhanced Read Committed Isolation).

https://couchbasecloud.atlassian.net/browse/SCBC-483[SCBC-483]:
Support FTS like Pre-Filters while doing Vector Search.

https://couchbasecloud.atlassian.net/browse/SCBC-490[SCBC-490]:
Operational SDK is now prevented from connecting to an Enterprise Analytics Cluster.

https://couchbasecloud.atlassian.net/browse/JVMCBC-1637[JVMCBC-1637]:
Publish a BOM.
* https://couchbasecloud.atlassian.net/browse/JVMCBC-1660[JVMCBC-1660]:
The "auto" network selection heuristic has been changed to fall back to the "external" network if the "external" network is present.
Previously, if there was no exact match between an address in the connection string and an address in the cluster topology reported by the server, the SDK would select the "default" network.
Now, if there is no match and an "external" network is present, the SDK selects the "external" network.
+
If this change causes the SDK to select the incorrect network for your deployment, use the xref:ref:client-settings.adoc#io.networkResolution[io.networkResolution] client setting to configure the SDK to use the "default" network.

==== Bug Fixes

https://couchbasecloud.atlassian.net/browse/SCBC-491[SCBC-491]:
NPE when accessing unscoped (cluster-level) eventing function manager.

https://couchbasecloud.atlassian.net/browse/JVMCBC-1644[JVMCBC-1644]
`Query_context` namespace should not be surrounded by backticks.
* https://couchbasecloud.atlassian.net/browse/SCBC-491[SCBC-491]:
Fixed a regression in 1.6.2 where attempting to manage unscoped (cluster-level) eventing functions throws a `NullPointerException`.

https://couchbasecloud.atlassian.net/browse/JVMCBC-1656[JVMCBC-1656]:
Java SDK Seed Nodes Don't Always Get Correctly Updated.
* https://couchbasecloud.atlassian.net/browse/JVMCBC-1656[JVMCBC-1656]:
Fixed an issue that could prevent the SDK from periodically updating its list of KV node addresses.
This could occur if the addresses in the connection string (or DNS SRV record) differ from the server’s self-reported address as they appear in the admin UI.
This issue can lead to `UnknownHostException` messages in the SDK logs.
To resolve the issue, the SDK now feeds both “global” and “bucket” topology info into the same funnel, so the SDK can update its list of node addresses from either source.

https://couchbasecloud.atlassian.net/browse/JVMCBC-1660[JVMCBC-1660]:
Change Network Heuristic for JVM SDKs.
* https://couchbasecloud.atlassian.net/browse/JVMCBC-1662[JVMCBC-1662]:
Fixed an issue that prevented the SDK from honoring the "preferred server group" option inside transactions.

https://couchbasecloud.atlassian.net/browse/JVMCBC-1662[JVMCBC-1662]:
Preferred server group not honored in transactions.
* https://couchbasecloud.atlassian.net/browse/JVMCBC-1664[JVMCBC-1664]:
Exceptionally long-running analytics queries no longer throw `ArrayIndexOutOfBoundsException`.

https://couchbasecloud.atlassian.net/browse/JVMCBC-1664[JVMCBC-1664]:
`ArrayIndexOutOfBoundsException` when request takes more than 1 hour.

https://couchbasecloud.atlassian.net/browse/JVMCBC-1671[JVMCBC-1671]:
Transactions metrics not reporting all required attributes.
* https://couchbasecloud.atlassian.net/browse/JVMCBC-1671[JVMCBC-1671]:
All expected attributes are now included in transactions metrics exported by the SDK.

==== Improvements

https://couchbasecloud.atlassian.net/browse/JVMCBC-1607[JVMCBC-1607]:
Improve how trusted certificates are logged.

https://couchbasecloud.atlassian.net/browse/JVMCBC-1612[JVMCBC-1612]:
Use `IdleStateHandler` to detect dead or half-open KV connections.

https://couchbasecloud.atlassian.net/browse/JVMCBC-1634[JVMCBC-1634]:
Flatten published POMs.

https://couchbasecloud.atlassian.net/browse/JVMCBC-1648[JVMCBC-1648]:
Upgrade Jackson from 2.17.3 to 2.19.2.

https://couchbasecloud.atlassian.net/browse/JVMCBC-1651[JVMCBC-1651]:
Support `accessDeleted` reads for subdoc replica reads.

https://couchbasecloud.atlassian.net/browse/JVMCBC-1652[JVMCBC-1652]:
Read library version from a new `version.properties` resource instead of JAR manifest.

https://couchbasecloud.atlassian.net/browse/JVMCBC-1657[JVMCBC-1657]:
Improve backpressure implementation for row-based HTTP services.
* https://couchbasecloud.atlassian.net/browse/JVMCBC-1639[JVMCBC-1639]:
We’ve adopted a mono-versioning strategy for the Couchbase JVM client libraries.
The Scala and Kotlin SDKs, along with the core library and optional modules, are now aligned with the Java SDK at version 3.9.0.
+
Although this is a technically a major version bump for some components, in this exceptional case it does not indicate a breaking change.
The goal of this alignment is twofold: to minimize confusion about which versions are compatible with each other, and to enable a more disciplined branch management strategy where patch releases contain only low-risk bug fixes.

https://couchbasecloud.atlassian.net/browse/JVMCBC-1658[JVMCBC-1658]:
Better filtering of suppressed exception stack traces.
* https://couchbasecloud.atlassian.net/browse/JVMCBC-1607[JVMCBC-1607]:
Improved how the SDK logs information about trusted TLS certificates on startup.
It now logs up to 5 certificates at `INFO` level, and the full list at `DEBUG` level.
Previously, the SDK logged the full list at `INFO` level, which could prevent other interesting configuration info from being included in the log, depending on how logging was configured.

https://couchbasecloud.atlassian.net/browse/JVMCBC-1661[JVMCBC-1661]:
Upgrade `Gson` from 2.11.0 to 2.13.1.
* https://couchbasecloud.atlassian.net/browse/JVMCBC-1612[JVMCBC-1612]:
The SDK is now more aggressive about detecting dead or half-open KV connections.
It closes a connection if there is no incoming traffic for the duration specified by `io.configIdleRedialTimeout` (default value: 5 minutes), and sends a `NOOP` request if there is no incoming traffic for half that duration.

https://couchbasecloud.atlassian.net/browse/JVMCBC-1665[JVMCBC-1665]:
Let internal Couchbase products bypass cluster type check.
* https://couchbasecloud.atlassian.net/browse/JVMCBC-1648[JVMCBC-1648]:
Upgraded `Jackson` from `2.17.3` to `2.19.2`.

https://couchbasecloud.atlassian.net/browse/JVMCBC-1667[JVMCBC-1667]
Make `IgnoreWhen` annotation repeatable.
* https://couchbasecloud.atlassian.net/browse/JVMCBC-1651[JVMCBC-1651]:
Improved internal support for sub-document replica reads against upcoming server versions.

https://couchbasecloud.atlassian.net/browse/JVMCBC-1639[JVMCBC-1639]:
Migrated to mono-versioning.
* https://couchbasecloud.atlassian.net/browse/JVMCBC-1652[JVMCBC-1652]:
Shading the Couchbase SDK no longer causes it report a version number of `0.0.0`.

https://couchbasecloud.atlassian.net/browse/JVMCBC-1659[JVMCBC-1659]:
Automate publishing API reference documentation.
* https://couchbasecloud.atlassian.net/browse/JVMCBC-1657[JVMCBC-1657]:
Improved the backpressure implementation for reactive {sqlpp}, Analytics, and Full-Text Search queries.
The SDK now requires less memory to buffer results if the consumer cannot keep up with the producer.

https://couchbasecloud.atlassian.net/browse/JVMCBC-1668[JVMCBC-1668]:
Remove Project Reactor links from API reference documentation.
* https://couchbasecloud.atlassian.net/browse/JVMCBC-1658[JVMCBC-1658]:
When the SDK removes uninteresting Netty stack frames from stack traces, it now also applies the filtering to suppressed exceptions.
This improves stack trace readability in some cases when Project Reactor debugging is enabled.

==== New Features

* https://couchbasecloud.atlassian.net/browse/SCBC-483[SCBC-483]:
A Full-Text Search vector query now has an optional "prefilter" parameter.
This is a non-vector query that the server executes first to get an intermediate result.
Then it executes the vector query on the intermediate result to get the final result.

* https://couchbasecloud.atlassian.net/browse/JVMCBC-1637[JVMCBC-1637]:
A Bill of Materials (BOM) for Couchbase JVM clients is now available.
It specifies compatible versions of the Java, Scala, and Kotlin clients, as well as the optional metrics and tracing components. https://central.sonatype.com/artifact/com.couchbase.client/couchbase-client-bom[https://central.sonatype.com/artifact/com.couchbase.client/couchbase-client-bom].


== Scala SDK 1.8 Releases
Expand Down