mongo-cxx-driver

This is the second patch release of the new MongoDB C++11 driver. Please see the release notes for the 3.0.1 driver below for additional details on this new driver.

Please note that this version of the driver requires the MongoDB C driver 1.3.4 in order to build and exhibit expected behavior.

The MongoDB C++11 driver 3.0.x series does not promise API or ABI stability across patch releases. There are some minor API breaking changes in the 3.0.2 release. We apologize for any inconvenience. We are aiming to achieve API stability for the upcoming 3.1.x series. Some known changes include:

• bsoncxx::oid objects are now default initialized to a valid state
• JSON-ification of element and types has been removed
• JSON formatting has changed to use libbson's JSON algorithm

This is a minor patch release above the prior legacy-1.1.1 release, and is a recommended upgrade for all users of legacy-1.1.1 or older legacy driver releases.

There are only trivial differences between this release and the legacy-1.1.1 release, below. This release is being issued to roll up backports from MongoDB r3.0.8...r3.0.12.

This is a minor patch release above the prior legacy-1.1.0 release, and is a recommended upgrade for all users of legacy-1.1.0 or older legacy driver releases.

There are only trivial differences between this release and the legacy-1.1.0 release, below. This release is being issued to roll up backports from MongoDB r3.0.7...r3.0.8 and improve test coverage ahead of a larger drop of backports from MongoDB r3.0.8..r3.0.11.

There are no interesting user-facing bugs or changes to report in this release.

PLEASE NOTE: You should prefer "legacy" release series if possible. At the time of this writing, the most current release in the legacy-1.1 release series is https://github.com/mongodb/mongo-cxx-driver/releases/tag/legacy-1.1.0.

Please also note that the C++11 driver is now stable. Users of both the 26compat and legacy drivers are encouraged to migrate to the C++11 driver if at all possible.

See the MongoDB Server r2.6.11..r2.6.12 changelog for details on the changes in this release.

This is the first patch release of the new MongoDB C++11 driver. Please see the release notes for the 3.0.0 driver below for additional details on this new driver.

Please note that this version of the driver requires the MongoDB C driver 1.3.4 in order to build and exhibit expected behavior.

Please note that this version includes a small breaking change, related to CXX-862. Some operations on array and document elements that previously would throw exceptions now return invalid elements instead, which is more consistent with the overall library design.

Please note the following known issues in this release:

The following issues have been resolved in 3.0.1 since the prior 3.0.0 release:

This is the first stable release of the new MongoDB C++11 driver.

Please see our blog post for a full description of the new driver's design goals. The new driver is incompatible with all previous MongoDB C++ drivers. Due to the long history and complex version numbering of prior C++ drivers released by MongoDB, the C++11 driver is issuing its first stable release as 3.0.0. This is the lowest major version number that was found to be unambiguous with all previously released MongoDB C++ driver versions.

As specified in the Quickstart Guide, building the driver requires a conforming C++11 compiler (GCC 4.8.2, clang-3.5, VS 2015 Update 1, etc.) and depends on the 1.3.1 release of the MongoDB C Driver.

While we plan to commit to a stable ABI in the future, versions prior to 3.1.0 will not offer a stable ABI. The library currently has a soname ABI version of _noabi which indicates no API or ABI stability guarantee across any two releases. We are holding off on setting an ABI version so that we can incorporate post-GA feedback before locking down the ABI. We anticipate releasing 3.1.0 with an ABI this Spring.

API documentation can be found here. Please file JIRA tickets if you encounter any problems using the driver. Pull requests against the master branch are welcomed and encouraged.

Please note the following known issues in this release:

The following issues have been resolved in 3.0.0 since the prior 3.0.0-rc0 release:

This is the first release candidate of the new MongoDB C++11 driver. This is a pre-release version of the driver and is not suitable for production use.

Please see our blog post for a full description of the new driver's design goals. The new driver is incompatible with all previous MongoDB C++ drivers. Due to the long history and complex version numbering of prior C++ drivers released by MongoDB, the C++11 driver is issuing its first stable release as 3.0.0. This is the lowest major version number that was found to be unambiguous with all previously released MongoDB C++ driver versions.

As specified in the Quickstart Guide, building the driver requires a conforming C++11 compiler (GCC 4.9, clang-3.4, VS 2015 Update 1, etc.) and depends on the 1.3 release of the MongoDB C Driver.

While we plan to commit to a stable ABI in the future, versions prior to 3.1.0 will not offer a stable ABI. The library currently has a soname ABI version of _noabi which indicates no API or ABI stability guarantee across any two releases. We are holding off on setting an ABI version so that we can incorporate post-GA feedback before locking down the ABI.

API documentation can be found here. Please file JIRA tickets if you encounter any problems using the driver. Pull requests against the master branch are welcomed and encouraged.

Please note the following known issues in this release:

Detailed information on the changes in this release since 0.2.0 (the prior alpha) can be found in the tickets below:

This release introduces support for select MongoDB 3.2 features.

There are only minor differences between this release and the legacy-1.1.0-rc0 release, as identified below. Please see the release notes for legacy-1.1.0-rc0 for details on what is new in this release.

This release obsoletes the legacy-1.0 release stream: all future updates to the legacy C++ driver will be delivered in the legacy-1.1 release series.

This is a release candidate for the next minor version of the Legacy C++ driver, legacy-1.1, which will include support for the upcoming MongoDB 3.2 release.

This is an unstable release and is not suitable for production use. Testing is greatly appreciated! Bugs should be filed in the MongoDB C++ Driver JIRA Project.

To fully explore the new features identified below, you will need to install MongoDB 3.2-rc2 or newer.

The following tickets were resolved in this release candidate. Many of these tickets reflect new features associated with MongoDB 3.2.

Please note that support for the new read-committed isolation level added in MongoDB 3.2 is not being implemented in the legacy C++ driver.

The following tickets were resolved in this release:

Select portions of the following relevant SERVER tickets were backported to this release in CXX-666:

This is a larger than typical release for the legacy C++ driver. Several bugs were reported against legacy-1.0.5 which have been fixed in this release. Please see the links to the JIRA tickets below for more details.

Additionally, the Legacy C++ driver has been run through clang-format. All files are now uniformly formatted, and all whitespace errors have been corrected.

Finally, please note that the various "eval" helpers in DBClientInterface have been deprecated. MongoDB 3.0 deprecated "eval", but the driver had erroneously not yet deprecated the associated helper methods. The methods have been deprecated by adding the compiler appropriate deprecation attribute, which will issue a warning if the deprecated method is used.

If you need to avoid the deprecation warning for these helpers in existing code, you can replace any call to a deprecated method "X" with a call to "Xdeprecated", which has the same behavior, but will not issue a deprecation warning.

Given the atypical size of this release, we reiterate our standing advice to test the new driver release in an acceptance test environment before deploying to production.

Select portions of the following relevant SERVER tickets were backported to this release in CXX-622:

Select portions of the following relevant SERVER tickets were backported to this release in CXX-621:

Please note that the --ssl-fips-capability flag has been removed. The build system will now auto-detect whether the OpenSSL libraries provide FIPS support. If you previously used the --ssl-fips-capability flag, you no longer need to do so.

PLEASE NOTE: You should prefer the stable legacy-1.0 release series if possible. At the time of this writing, the most current release in the legacy-1.0 release series is https://github.com/mongodb/mongo-cxx-driver/releases/tag/legacy-1.0.4.

See MongoDB Server r2.6.10..r2.6.11 change log for details on the changes in this release.

There are only minor differences between this release and the legacy-1.0.4-rc0 release, as identified below. Please see the release notes for legacy-1.0.4-rc0 for details on what has changed since legacy-1.0.3.

Select portions of the following relevant SERVER tickets were backported to this release in CXX-607:

There are no material differences between this release and the legacy-1.0.3-rc0 release. Please see the release notes for that release for details on what has changed since legacy-1.0.2.

Select portions of the following relevant SERVER tickets were backported to this release in CXX-599:

Note that many of the above tickets are SSL related. If you make heavy use of SSL with the legacy C++ driver, we strongly encourage you to test this release candidate.

There are no material differences between this release and the legacy-1.0.2-rc0 release. Please see the release notes for that release for details on what has changed since legacy-1.0.1.

PLEASE NOTE: You should prefer the stable legacy-1.0 release series if possible. At the time of this writing, the most current release in the legacy-1.0 release series is https://github.com/mongodb/mongo-cxx-driver/releases/tag/legacy-1.0.1.

See MongoDB Server r2.6.9..r2.6.10 change log for details on the changes in this release.

This is the second alpha release of the next-generation MongoDB C++ Driver.

Please see our blog post for a full description of the new driver's design goals.

As specified in the Quickstart Guide, building the driver requires a C++11 conformant compiler and depends on the 1.2.0-dev branch of the MongoDB C Driver.

The driver cannot currently be built with MSVC - please use clang 3.4 or g++ 4.8 (or newer). We are planning to incorporate support for MSVC 2015 after it ships.

While we also plan to commit to a stable ABI in the future, the prerelease versions before 1.0.0 will not offer a stable ABI. The library currently has a soname ABI version of 0 which indicates no stability guarantee.

API documentation can be found here. Please file JIRA tickets if you encounter any problems using the driver.

Changes in 0.2.0 since 0.1.0:

Special thanks to community contributors @yhager and @tracyJsonar for their contributions to this release.