MongoDB C++11 Driver 3.0.0-rc0

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:

Known Issues

• [CXX-778] - C++ driver SSL cannot be configured independently of C driver
• [CXX-771] - Max time argument to some collection methods is ignored
• [CXX-784] - Cannot use `document::view` with stream builder
• [CXX-522] - Windows calling convention not specified for free functions
• [CXX-805] - `options::find::comment` is not honored
• [CXX-758] - Read concern is not inherited when not explicitly set
• [CXX-807] - Required compiler minima not enforced by CMake
• [CXX-808] - Missing error codes for server-side errors

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

Bugs Fixed

• [CXX-638] - C++ Driver on master fails to compile with Visual Studio 2015
• [CXX-640] - actually set options in mongocxx::client constructor
• [CXX-661] - bsoncxx::oid hex string constructor broken
• [CXX-677] - bsoncxx static lib wrongly called bson.a
• [CXX-681] - Cannot get deleted_count from result of collection::delete_one/many
• [CXX-687] - collection::create_index does not support any options
• [CXX-702] - database::create_collection not implemented
• [CXX-713] - Add MONGOCXX_PRIVATE macro to all private constructors / methods
• [CXX-723] - Actually sort documents with find
• [CXX-730] - string_view.data() is unsafe
• [CXX-731] - New driver examples seg fault
• [CXX-742] - client::database() should raise an exception if client is uninitialized
• [CXX-743] - Documentation for database::list_collections doesn't match declaration
• [CXX-745] - Implement mongocxx::database::drop()
• [CXX-755] - C++ driver fails to build when ssl is disabled on the C driver
• [CXX-757] - document{} << const char* casts argument to bool
• [CXX-759] - document/array::view.begin() != .end() for empty documents
• [CXX-761] - Stream builder error for invalid context is unfriendly
• [CXX-762] - Audit construction, copy, move and destruction of bsoncxx::v0::types::value
• [CXX-774] - Cmake/Make parallelized build fails
• [CXX-781] - CMake path incorrect when subproject
• [CXX-788] - Number of 'const' qualifiers in return values
• [CXX-791] - bulk_write constructor should take an enum not a boolean
• [CXX-798] - Printing the inserted IDs returned by a bulk_write throws
• [CXX-801] - bsoncxx::view_or_value should have private members
• [CXX-802] - coll.drop() throws if collection doesn't exist

Improvements

• [CXX-578] - expose wrapper for mongoc_log_handler
• [CXX-580] - add syntactic sugar for reaching into deeply nested BSON structures
• [CXX-585] - Make all publicly visible macros hygenic
• [CXX-608] - Permit default construction of client/db/collection
• [CXX-616] - simplify bsoncxx/util/functor.hpp
• [CXX-626] - Provide support to construct b_date from std::chrono::time_point
• [CXX-628] - Create an unreachable macro and use where needed
• [CXX-629] - Attach visibility attribute to enum classes where needed
• [CXX-630] - Improve move semantics of model::write
• [CXX-631] - collection::create_index should return server response
• [CXX-632] - de-inline collection::insert_many body to the extent possible
• [CXX-633] - Understand requirements on count::hint
• [CXX-634] - Find a home for options::return_document enum
• [CXX-635] - Determine desired visibility of insert_many constructor
• [CXX-636] - Determine return type of write_concern::tag
• [CXX-654] - Add empty() to bsoncxx::array::view()
• [CXX-704] - Create Write Concern W enum (for majority, default, etc)
• [CXX-710] - Allow copying of collections
• [CXX-712] - Add ordered option to insert_many
• [CXX-715] - Add CRL file to SSL options
• [CXX-716] - use stdx names in the mongocxx via mongocxx/stdx.hpp
• [CXX-727] - Make it possible to rename collections
• [CXX-733] - Move BSONCXX_INLINE and MONGOCXX_INLINE to a compiler header
• [CXX-750] - Rename database::command to database::run_command
• [CXX-751] - specified timeouts with chrono
• [CXX-753] - Allow copying of databases
• [CXX-756] - Make accessor...

MongoDB Legacy C++ Driver 1.1.0

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.

Bug

• [CXX-744] - RandomTest.NextInt64SanityCheck Fails on PPC

MongoDB Legacy C++ Driver 1.0.7

The following tickets were resolved in this release:

Task

• [CXX-666] - Backport server r3.0.6..r3.0.7 changes

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

• SERVER-19088
• SERVER-20121

MongoDB Legacy C++ Driver 1.1.0-rc0

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.

Improvement

• [CXX-657] - Use constant-time hash comparison functions

New Feature

• [CXX-685] - Support Filtered (Partial) Indexes
• [CXX-689] - Support bypassDocumentValidation
• [CXX-692] - findAndModify take a write concern
• [CXX-696] - Ensure spec compliance for unacknowledged write concerns.

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.

MongoDB Legacy C++ Driver 1.0.6

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.

Bug

• [CXX-646] - C++ driver does not connect to replica sets when all members specified
• [CXX-664] - No way to enable IPv6 support
• [CXX-698] - DBClientTest.Comment uses incorrect query on profiling collection for 3.2+ servers
• [CXX-699] - Queries may return incomplete result sets due to incorrect calculation of nToReturn
• [CXX-707] - don't run tests that create v0 indexes against 3.1+ servers
• [CXX-709] - Legacy C++ Driver Tests do not compile with VS 2015

Improvement

• [CXX-662] - Build error with g++ using '-pedantic-errors' key

Task

• [CXX-622] - Backport server r3.0.5..r3.0.6 changes
• [CXX-623] - clang-format the legacy driver
• [CXX-656] - Deprecate eval helpers

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

• SERVER-19389
• SERVER-19464

MongoDB Legacy C++ Driver 1.0.5

Task

• [CXX-621] - Backport server r3.0.4..r3.0.5 changes

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

• SERVER-17567
• SERVER-18371

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.

MongoDB 2.6 Compatible C++ Driver 2.6.11

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.

MongoDB Legacy C++ Driver 1.0.4

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.

Bug

• [CXX-639] - verifyFailed() in assert_util.cpp has undesired behavior in _DEBUG

MongoDB Legacy C++ Driver 1.0.4-rc0

Bug

• [CXX-597] - Use electionId to detect stale primaries.
• [CXX-618] - scons install does not copy mongo/bson/bson_validate.h

Task

• [CXX-607] - Backport server 3.0.3..3.0.4 changes

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

• SERVER-6826
• SERVER-18246
• SERVER-18280
• SERVER-18326

MongoDB Legacy C++ Driver 1.0.3

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.