This is the first release candidate for mongocxx 3.1.0, the MongoDB C++11 driver.
This release provides support for new features in MongoDB 3.4.
Please note that this version of mongocxx requires the MongoDB C driver 1.5.0.
See the MongoDB C++ Driver Manual and the Driver Installation Instructions for more details on downloading, installing, and using this driver.
NOTE: The mongocxx 3.1.x series does not promise API or ABI stability across patch releases.
The full list of user-visible issues that have been resolved in 3.1.0-rc0 since the prior 3.0.x series are as follows:
Bug
- [CXX-894] - Return disengaged result optionals for unack'ed write operations
- [CXX-938] - stdx polyfills are not declared in the ABI inline namespace
- [CXX-1001] - mongocxx::cursor.begin() increments the iterator
- [CXX-1009] - mongocxx::pool should take options::pool, not options::ssl
- [CXX-1039] - Update link to final collation page in 3.4 manual
- [CXX-1047] - MSVC warning C4714, bsoncxx operator <<, view() etc. marked as __forceinline not inlined
- [CXX-1061] - Update link to final views page in 3.4 manual
- [CXX-1065] - read_concern::acknowledge_string should return const string_view
- [CXX-1070] - Confusing installation instructions
- [CXX-1093] - collection::distinct() should return error to user if collation specified and connection max wire version < 5
- [CXX-1100] - Having more than one iterator per cursor violates mongoc lifecycle constraints
- [CXX-1109] - Integration tests should pass against server versions 2.4 through 3.0
- [CXX-1135] - Read preference option not applied to distinct
New Feature
- [CXX-778] - Allow configuration of SSL independently of the C driver
- [CXX-859] - Implement Decimal 128 type spec
- [CXX-927] - Support sending writeConcern for commands that write
- [CXX-948] - Support new readConcern level "linearizable"
- [CXX-957] - Allow a user to decide whether to build static or shared libraries
- [CXX-971] - Support providing collation per operation
- [CXX-976] - Allow users to set a limit on acceptable staleness
- [CXX-978] - Add application name and driver version to the MongoDB handshake
- [CXX-999] - Support read-only views
- [CXX-1042] - Write mongocxx configuration guide
- [CXX-1051] - Add new top-level find options and deprecate options::find::modifiers()
- [CXX-1053] - Add getters to options::create_collection/options::create_view/validation_criteria classes, make setters support chaining, deprecate to_document() methods
- [CXX-1059] - Add aggregation pipeline class builder methods for new MongoDB 3.4 stages
- [CXX-1124] - Username no longer required for MONGODB-X509 auth
- [CXX-1132] - Test that collection::find(), collection::find_one(), and collection::find_one_and_*() fail with error if collation specified and server lacks collation support
- [CXX-1134] - Add bsoncxx generic internal error code
- [CXX-1142] - Make minimum value of maxStalenessSeconds 90 seconds