Important
This is the first release supporting a stable ABI for the bsoncxx and mongocxx libraries.
- The stable ABI is declared under the
v1namespace of the bsoncxx and mongocxx libraries. - The unstable ABI declared under the
v_noabinamespace is still supported. - Root namespace redeclarations (e.g.
bsoncxx::document::value) are recommended when ABI stability is not a requirement. These redeclarations will be updated to the latest ABI version equivalents in an upcoming API major release.
See ABI Versioning for more information.
Fixed
- Include of
v1/text_options.hpp(normal header) byoptions/text-fwd.hpp(forward header). - Include of v_noabi macro guard headers by
text_options.hpp(v1).
Deprecated
- Support for MongoDB Server 4.2.
Changed
- Stable ABI (v1) is now officially supported for both bsoncxx and mongocxx libraries.
- The soversion for both bsoncxx and mongocxx libraries is now set to
1. - Library filenames now include the ABI version number, e.g.
libbsoncxx1.so.4.4.0. - pkg-config config filenames now include the ABI version number, e.g.
libbsoncxx1.pc. - CMake package config filenames now use
camelCase, e.g.bsoncxxConfig.cmake. - Bump the minimum required C Driver version to 2.3.1.
Added
- Support for the "readConcern" option field to "delete", "insert", "replace", "bulkWrite", "findOneAnd*", "count", and "distinct" operations.
- Support for
MONGODB-OIDCauthMechanism. - Support for client bulk write API (
mongocxx::client_bulk_write).- Unlike collection bulk write (
mongocxx::bulk_write), client bulk write supports writes across more than one collection and can group inserts, updates, and deletes in the same network payload. - Requires MongoDB Server 8.0 or newer.
- See:
- Unlike collection bulk write (
See the full list of changes in Jira.
Feedback
To report a bug or request a feature, please open a ticket in the MongoDB issue management tool Jira:
- Create an account and login.
- Navigate to the CXX project
- Click
Create.
Signature Verification
Release artifacts may be verified by using the accompanying detached signature (.asc) and the cpp-driver public key obtained from https://pgp.mongodb.com.