Skip to content

DOCSP-61752: Add JVM v5.9 what's new items#173

Merged
mcmorisi merged 3 commits into
10gen:mainfrom
mcmorisi:5.9-wn-items
Jul 7, 2026
Merged

DOCSP-61752: Add JVM v5.9 what's new items#173
mcmorisi merged 3 commits into
10gen:mainfrom
mcmorisi:5.9-wn-items

Conversation

@mcmorisi

@mcmorisi mcmorisi commented Jul 7, 2026

Copy link
Copy Markdown
Collaborator

Summary

Adds the shared JVM v5.9-wn-items.rst for the mongo-java-driver 5.9.0 release, consumed via sharedinclude by the Java, Java Reactive Streams, Kotlin Coroutine, Kotlin Sync, and Scala driver release notes.

Content (5.8.0 → 5.9.0 delta):

  • Queryable Encryption prefix/suffix/substring queries promoted to GA (server 9.0+)
  • Explicit encryption API renamed TextString (TextOptions deprecated)
  • libmongocrypt upgraded to 1.20.0

Related

  • Companion docs PR in 10gen/docs-mongodb-internal (JVM 5.9 version update)

JIRA: https://jira.mongodb.org/browse/DOCSP-61752

@norareidy norareidy left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The release notes in the source code have more changes, should we document those too?

Comment thread dbx/jvm/v5.9-wn-items.rst
@@ -0,0 +1,13 @@
- Promotes Queryable Encryption (QE) prefix, suffix, and substring

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Q: (maybe for tech reviewer) should we document this yet, if MongoDB 9.0 won't be released until september?

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The release notes are also only a draft right now so at most, these notes would be added to the upcoming version of the docs. Agreed that engineering would be helpful here to provide guidance on the release timeline.

Comment thread dbx/jvm/v5.9-wn-items.rst Outdated
Comment on lines +5 to +11
- Renames the explicit encryption API for QE string queries from
``Text`` to ``String``. The new ``StringOptions`` class and the
``EncryptOptions.stringOptions()`` and
``EncryptOptions.getStringOptions()`` methods replace the deprecated
``TextOptions`` class and its ``textOptions()`` and
``getTextOptions()`` methods. To perform a QE string query, set the
encryption algorithm to ``"String"``.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

S: it's a little hard to tell what's deprecated and which updates to make, maybe format as a list:

Suggested change
- Renames the explicit encryption API for QE string queries from
``Text`` to ``String``. The new ``StringOptions`` class and the
``EncryptOptions.stringOptions()`` and
``EncryptOptions.getStringOptions()`` methods replace the deprecated
``TextOptions`` class and its ``textOptions()`` and
``getTextOptions()`` methods. To perform a QE string query, set the
encryption algorithm to ``"String"``.
- Renames the explicit encryption API for QE string queries from
``Text`` to ``String``. To perform a QE string query, make the following changes:
- Use the ``StringOptions`` class instead of ``TextOptions``
- Use the ``EncryptOptions.stringOptions()`` method instead of ``textOptions()``
- Use the ``EncryptOptions.getStringOptions()`` method instead of ``getTextOptions()``
- Set the encryption algorithm to ``"String"``

@mcmorisi mcmorisi requested a review from norareidy July 7, 2026 17:23

@norareidy norareidy left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lgtm!

@mcmorisi mcmorisi merged commit 3efbb75 into 10gen:main Jul 7, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants