From ce50b2c07bc6f5c9fd420208658459bc773808e6 Mon Sep 17 00:00:00 2001 From: norareidy Date: Wed, 7 May 2025 10:59:00 -0400 Subject: [PATCH 1/7] DOCSP-49751: v5.5 release --- config/redirects | 4 ++-- snooty.toml | 6 +++--- source/includes/language-compatibility-table-java.rst | 2 +- source/reference/whats-new.txt | 5 +++++ 4 files changed, 11 insertions(+), 6 deletions(-) diff --git a/config/redirects b/config/redirects index 88c49a2fa..d4a82eb86 100644 --- a/config/redirects +++ b/config/redirects @@ -1,8 +1,8 @@ define: prefix docs/drivers/java/sync define: base https://www.mongodb.com/${prefix} -define: versions v4.3 v4.4 v4.5 v4.6 v4.7 v4.8 v4.9 v4.10 v4.11 v5.0 v5.1 v5.2 v5.3 v5.4 master +define: versions v4.3 v4.4 v4.5 v4.6 v4.7 v4.8 v4.9 v4.10 v4.11 v5.0 v5.1 v5.2 v5.3 v5.4 v5.5 master -symlink: current -> v5.4 +symlink: current -> v5.5 symlink: upcoming -> master raw: ${prefix}/ -> ${base}/current/ diff --git a/snooty.toml b/snooty.toml index c7bac4125..779c5740d 100644 --- a/snooty.toml +++ b/snooty.toml @@ -27,13 +27,13 @@ sharedinclude_root = "https://raw.githubusercontent.com/10gen/docs-shared/main/" driver = "java" driver-long = "MongoDB Java Driver" driver-short = "Java driver" -version = "5.4" +version = "5.5" full-version = "{+version+}.0" mdb-server = "MongoDB Server" package-name-org = "mongodb-org" api-root = "https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs" -driver-api = "{+api-root+}/mongodb-driver-sync/com/mongodb/client" -core-api = "{+api-root+}/mongodb-driver-core/com/mongodb" +driver-api = "{+api-root+}/driver-sync/com/mongodb/client" +core-api = "{+api-root+}/driver-core/com/mongodb" stable-api = "Stable API" mongocrypt-version = "{+full-version+}" nettyVersion = "io.netty:netty-all:4.1.87.Final" diff --git a/source/includes/language-compatibility-table-java.rst b/source/includes/language-compatibility-table-java.rst index 7118145c5..308df95e6 100644 --- a/source/includes/language-compatibility-table-java.rst +++ b/source/includes/language-compatibility-table-java.rst @@ -12,7 +12,7 @@ - Java 6 - Java 5 - * - 4.11 to 5.4 + * - 4.11 to 5.5 - ✓ - ✓ - ✓ diff --git a/source/reference/whats-new.txt b/source/reference/whats-new.txt index 2ea492700..2aa706adf 100644 --- a/source/reference/whats-new.txt +++ b/source/reference/whats-new.txt @@ -43,6 +43,11 @@ What's New in 5.5 learn more about compatible versions of the server, see :ref:`java-compatibility-tables`. +The 5.5 driver release includes the following changes, fixes, +and features: + +.. sharedinclude:: dbx/jvm/v5.5-wn-items.rst + .. _java-version-5.4: What's New in 5.4 From be0ff34489f3e6d39eae551ba73cdb99712c796e Mon Sep 17 00:00:00 2001 From: norareidy Date: Wed, 7 May 2025 11:03:29 -0400 Subject: [PATCH 2/7] aws sdk --- source/security/auth/aws-iam.txt | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/security/auth/aws-iam.txt b/source/security/auth/aws-iam.txt index d5b6160d9..32d644a09 100644 --- a/source/security/auth/aws-iam.txt +++ b/source/security/auth/aws-iam.txt @@ -113,10 +113,10 @@ AWS documentation for the version you need: .. note:: For the AWS SDK for Java v2, the Java driver tests using the - ``software.amazon.awssdk:auth:2.18.9`` dependency. + ``software.amazon.awssdk:auth:2.30.31`` dependency. For the AWS SDK for Java v1, the Java driver tests using the - ``com.amazonaws:aws-java-sdk-core:1.12.337`` dependency. + ``com.amazonaws:aws-java-sdk-core:1.12.782`` dependency. To supply your credentials, see the following AWS documentation for the version you need: From 035b340be4369a9f22514a28ed8d4e2d238072b4 Mon Sep 17 00:00:00 2001 From: norareidy Date: Wed, 7 May 2025 11:19:48 -0400 Subject: [PATCH 3/7] fix --- source/api-documentation.txt | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/source/api-documentation.txt b/source/api-documentation.txt index 29b7a78d7..31ce09299 100644 --- a/source/api-documentation.txt +++ b/source/api-documentation.txt @@ -26,7 +26,7 @@ API Documentation BSON <{+api-root+}/bson/index.html> BSON Record Codec <{+api-root+}/bson-record-codec/index.html> - Core <{+api-root+}/mongodb-driver-core/index.html> - Java Driver (modern API) <{+api-root+}/mongodb-driver-sync/index.html> - Java Driver (legacy API) <{+api-root+}/mongodb-driver-legacy/index.html> + Core <{+api-root+}/driver-core/index.html> + Java Driver (modern API) <{+api-root+}/driver-sync/index.html> + Java Driver (legacy API) <{+api-root+}/driver-legacy/index.html> From 60bd8ef5cc128d154ee90fc29cdf353fc1ded5f2 Mon Sep 17 00:00:00 2001 From: norareidy Date: Wed, 7 May 2025 11:29:20 -0400 Subject: [PATCH 4/7] another fix --- source/api-documentation.txt | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/source/api-documentation.txt b/source/api-documentation.txt index 31ce09299..2138f4e50 100644 --- a/source/api-documentation.txt +++ b/source/api-documentation.txt @@ -12,11 +12,11 @@ API Documentation - `BSON Record Codec <{+api-root+}/bson-record-codec/index.html>`__ - classes for encoding and decoding between Java records and the BSON data format. -- `Core <{+api-root+}/mongodb-driver-core/index.html>`__ - classes that +- `Core <{+api-root+}/driver-core/index.html>`__ - classes that contain essential driver functionality. -- `Java Driver (modern API) <{+api-root+}/mongodb-driver-sync/index.html>`__ - +- `Java Driver (modern API) <{+api-root+}/driver-sync/index.html>`__ - classes for the current driver API. -- `Java Driver (legacy API) <{+api-root+}/mongodb-driver-legacy/index.html>`__ - +- `Java Driver (legacy API) <{+api-root+}/driver-legacy/index.html>`__ - classes that support the legacy driver API. To learn how to upgrade from the legacy API to the modern API from the :ref:`` documentation. From d321804fcf8a85dac28657df6ca98ff41545b521 Mon Sep 17 00:00:00 2001 From: norareidy Date: Wed, 7 May 2025 15:37:07 -0400 Subject: [PATCH 5/7] shared content staging --- source/reference/whats-new.txt | 146 ++++++++++++++++++++++++++++++++- 1 file changed, 145 insertions(+), 1 deletion(-) diff --git a/source/reference/whats-new.txt b/source/reference/whats-new.txt index 2aa706adf..74bb9c443 100644 --- a/source/reference/whats-new.txt +++ b/source/reference/whats-new.txt @@ -46,7 +46,151 @@ What's New in 5.5 The 5.5 driver release includes the following changes, fixes, and features: -.. sharedinclude:: dbx/jvm/v5.5-wn-items.rst +- Introduces performance improvements that are reflected in the driver performance + benchmarks. To view the results of the performance benchmark tests, see the following + :ref:`java-5.5-performance-metrics` section. + +.. _java-5.5-performance-metrics: + +Performance Improvement Metrics +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. note:: + + The tables in this section reflect the performance + results of the synchronous Java driver. Since the improvements + were made in the shared driver core, we expect similar performance + improvement percentages for all Java drivers. + +The following table shows the results of performance improvement +tests for v5.5 of the driver configured with standard transport settings: + +.. list-table:: + :header-rows: 1 + :stub-columns: 1 + :widths: 50 25 25 + + * - Feature + - Percent Improvement + - Z-score + + * - Deep BSON decoding + - 19.44% + - 5.4 + + * - Deep BSON encoding + - 102% + - 22.8 + + * - Find many and empty the cursor + - 25.08% + - 13.72 + + * - Find one by ID + - 2.7% + - 3.16 + + * - Flat BSON decoding + - 31.2% + - 9.38 + + * - Flat BSON encoding + - 199.5% + - 12.34 + + * - Full BSON decoding + - 16.5% + - 7.23 + + * - Full BSON encoding + - 147.3% + - 10.39 + + * - LDJSON multi-file import + - 21.8% + - 8.21 + + * - Client ``BulkWrite`` insert with large documents + - 91.3% + - 24.44 + + * - Collection ``BulkWrite`` insert with large documents + - 96.5% + - 8.79 + + * - Bulk insert with large documents + - 93.3% + - 8.11 + + * - Insert one with large documents + - 82.4% + - 7.28 + + * - Client ``BulkWrite`` insert with small documents + - 49.5% + - 17.99 + + * - Collection ``BulkWrite`` insert with small documents + - 47.8% + - 6.44 + +The following table shows the results of performance improvement +tests for v5.5 of the driver configured with Netty transport settings: + +.. list-table:: + :header-rows: 1 + :stub-columns: 1 + :widths: 50 25 25 + + * - Feature + - Percent Improvement + - Z-score + + * - Find many and empty the cursor + - 40.3% + - 14.81 + + * - Find one by ID + - 4.4% + - 4.12 + + * - LDJSON multi-file import + - 16.9% + - 3.77 + + * - Client ``BulkWrite`` insert with large documents + - 54.8% + - 14.49 + + * - Collection ``BulkWrite`` insert with large documents + - 104.9% + - 38.72 + + * - Bulk insert with large documents + - 74.6% + - 65.55 + + * - Insert one with large documents + - 66.6% + - 58.65 + + * - Client ``BulkWrite`` insert with small documents + - 36.1% + - 15.41 + + * - Collection ``BulkWrite`` insert with small documents + - 39.3% + - 37.38 + + * - Bulk insert with small documents + - 35.1% + - 41.51 + +.. tip:: + + To learn more about how we conduct driver performance benchmark + tests, see the :spec:`Performance Benchmarking ` + specification. .. _java-version-5.4: From 776ec334e261333e40545133ae1bd5944ba1b914 Mon Sep 17 00:00:00 2001 From: norareidy Date: Thu, 8 May 2025 16:56:53 -0400 Subject: [PATCH 6/7] shared include --- source/reference/whats-new.txt | 146 +-------------------------------- 1 file changed, 1 insertion(+), 145 deletions(-) diff --git a/source/reference/whats-new.txt b/source/reference/whats-new.txt index 74bb9c443..2aa706adf 100644 --- a/source/reference/whats-new.txt +++ b/source/reference/whats-new.txt @@ -46,151 +46,7 @@ What's New in 5.5 The 5.5 driver release includes the following changes, fixes, and features: -- Introduces performance improvements that are reflected in the driver performance - benchmarks. To view the results of the performance benchmark tests, see the following - :ref:`java-5.5-performance-metrics` section. - -.. _java-5.5-performance-metrics: - -Performance Improvement Metrics -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. note:: - - The tables in this section reflect the performance - results of the synchronous Java driver. Since the improvements - were made in the shared driver core, we expect similar performance - improvement percentages for all Java drivers. - -The following table shows the results of performance improvement -tests for v5.5 of the driver configured with standard transport settings: - -.. list-table:: - :header-rows: 1 - :stub-columns: 1 - :widths: 50 25 25 - - * - Feature - - Percent Improvement - - Z-score - - * - Deep BSON decoding - - 19.44% - - 5.4 - - * - Deep BSON encoding - - 102% - - 22.8 - - * - Find many and empty the cursor - - 25.08% - - 13.72 - - * - Find one by ID - - 2.7% - - 3.16 - - * - Flat BSON decoding - - 31.2% - - 9.38 - - * - Flat BSON encoding - - 199.5% - - 12.34 - - * - Full BSON decoding - - 16.5% - - 7.23 - - * - Full BSON encoding - - 147.3% - - 10.39 - - * - LDJSON multi-file import - - 21.8% - - 8.21 - - * - Client ``BulkWrite`` insert with large documents - - 91.3% - - 24.44 - - * - Collection ``BulkWrite`` insert with large documents - - 96.5% - - 8.79 - - * - Bulk insert with large documents - - 93.3% - - 8.11 - - * - Insert one with large documents - - 82.4% - - 7.28 - - * - Client ``BulkWrite`` insert with small documents - - 49.5% - - 17.99 - - * - Collection ``BulkWrite`` insert with small documents - - 47.8% - - 6.44 - -The following table shows the results of performance improvement -tests for v5.5 of the driver configured with Netty transport settings: - -.. list-table:: - :header-rows: 1 - :stub-columns: 1 - :widths: 50 25 25 - - * - Feature - - Percent Improvement - - Z-score - - * - Find many and empty the cursor - - 40.3% - - 14.81 - - * - Find one by ID - - 4.4% - - 4.12 - - * - LDJSON multi-file import - - 16.9% - - 3.77 - - * - Client ``BulkWrite`` insert with large documents - - 54.8% - - 14.49 - - * - Collection ``BulkWrite`` insert with large documents - - 104.9% - - 38.72 - - * - Bulk insert with large documents - - 74.6% - - 65.55 - - * - Insert one with large documents - - 66.6% - - 58.65 - - * - Client ``BulkWrite`` insert with small documents - - 36.1% - - 15.41 - - * - Collection ``BulkWrite`` insert with small documents - - 39.3% - - 37.38 - - * - Bulk insert with small documents - - 35.1% - - 41.51 - -.. tip:: - - To learn more about how we conduct driver performance benchmark - tests, see the :spec:`Performance Benchmarking ` - specification. +.. sharedinclude:: dbx/jvm/v5.5-wn-items.rst .. _java-version-5.4: From 54cd845cea9d8ccdd4529d09bad33d7e8bebe4c9 Mon Sep 17 00:00:00 2001 From: norareidy Date: Fri, 9 May 2025 10:05:26 -0400 Subject: [PATCH 7/7] SA feedback --- source/index.txt | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/source/index.txt b/source/index.txt index 1667ebfb5..96aceb34c 100644 --- a/source/index.txt +++ b/source/index.txt @@ -91,13 +91,13 @@ and links to the API documentation. * - `BSON Record Codec <{+api-root+}/bson-record-codec/index.html>`__ - Classes that support records - * - `Core <{+api-root+}/mongodb-driver-core/index.html>`__ + * - `Core <{+api-root+}/driver-core/index.html>`__ - Shared core classes - * - `Java Driver <{+api-root+}/mongodb-driver-sync/index.html>`__ + * - `Java Driver <{+api-root+}/driver-sync/index.html>`__ - Modern API - * - `Legacy Java Driver <{+api-root+}/mongodb-driver-legacy/index.html>`__ + * - `Legacy Java Driver <{+api-root+}/driver-legacy/index.html>`__ - Legacy API Connection Troubleshooting