Java 4.9 whats new (#329)

* DOCSP-27978: added exception for BsonCreator constructor
* DOCSP-27417: Command monitoring log format change

Author: Chris Cho

source/fundamentals/logging.txt

@@ -133,9 +133,9 @@ tab corresponding to the logging framework you would like to use in your project
          :copyable: false
 
          ...
-         16:03:59.468 [main] DEBUG org.mongodb.driver.connection - Opened connection [connectionId{localValue:7, serverValue:<server value>}] to <connection uri>
-         16:03:59.483 [main] DEBUG org.mongodb.driver.protocol.command - Sending command '{"find": "<my collection>", "filter": {}, "limit": 1, "singleBatch": true, "$db": "<my database>", "lsid": {"id": {"$binary": {"base64": "<_id>", "subType": "04"}}}}' with request id 13 to database <my database> on connection [connectionId{localValue:7, serverValue:<server value>}] to server <connection uri>
-         16:03:59.502 [main] DEBUG org.mongodb.driver.protocol.command - Execution of command with request id 13 completed successfully in 27.79 ms on connection [connectionId{localValue:7, serverValue:<server value>}] to server <connection uri>
+         12:14:55.853 [main] DEBUG org.mongodb.driver.connection - Opened connection [connectionId{localValue:3, serverValue:3}] to <MongoDB hostname>
+         12:14:55.861 [main] DEBUG org.mongodb.driver.protocol.command - Command "find" started on database <database> using a connection with driver-generated ID 3 and server-generated ID 3 to <MongoDB hostname>. The request ID is 5. Command: {"find": "<collection>", "filter": {}, "limit": 1, "singleBatch": true, "$db": "<database>", "lsid": {"id": {"$binary": {"base64": "<_id>", "subType": "04"}}}, "$readPreference": {"mode": "primaryPreferred"}}
+         12:14:55.864 [main] DEBUG org.mongodb.driver.protocol.command - Command "find" succeeded in 4.34 ms using a connection with driver-generated ID 3 and server-generated ID 3 to <MongoDB hostname. The request ID is 5. Command reply: {"cursor": {"id": 0, "ns": "<database>.<collection>", "firstBatch": []}, "ok": 1.0, "$clusterTime": {"clusterTime": {"$timestamp": {"t": 1673778535, "i": 1}}, "signature": {"hash": {"$binary": {"base64": "<_id>", "subType": "00"}}, "keyId": 0}}, "operationTime": {"$timestamp": {"t": 1673778535, "i": 1}}}
 
       .. note:: Default Log Level
 

source/includes/fundamentals/logging.rst

@@ -1,6 +1,6 @@
 .. code-block:: java
 
-   MongoClient mongoClient = MongoClients.create(<my uri>);
-   MongoDatabase database = mongoClient.getDatabase(<my database>);
-   MongoCollection<Document> collection = database.getCollection(<my collection>);
+   MongoClient mongoClient = MongoClients.create(<connection uri>);
+   MongoDatabase database = mongoClient.getDatabase(<database>);
+   MongoCollection<Document> collection = database.getCollection(<collection>);
    collection.find().first();

source/whats-new.txt

@@ -13,6 +13,7 @@ What's New
 Learn what's new in:
 
 
+* :ref:`Version 4.9 <version-4.9>`
 * :ref:`Version 4.8 <version-4.8>`
 * :ref:`Version 4.7.1 <version-4.7.1>`
 * :ref:`Version 4.7.0 <version-4.7.0>`
@@ -26,10 +27,21 @@ Learn what's new in:
 
 .. _upcoming-breaking-changes:
 
+.. _version-4.9:
+
+What's New in 4.9
+-----------------
+
+- Added a new exception to identify when a constructor annotated by
+  ``BsonCreator`` contains parameters with annotations other than 
+  ``BsonProperty`` or ``BsonId``.
+- Changed the log message format for command monitoring messages reported
+  by the ``org.mongodb.driver.protocol.command`` package.
+
 .. _version-4.8:
 
 What's New in 4.8
--------------------
+-----------------
 
 - The 4.8 driver ends support for MongoDB v3.4 and earlier. To learn
   more about breaking changes in this driver version and how to address
@@ -43,10 +55,10 @@ What's New in 4.8
 
 .. important:: Deprecation Notice
 
-    The ``IterableCodec`` and ``MapCodec`` classes are deprecated. Instead,
-    use ``CollectionCodec`` and ``MapCodecV2``.
-    These support any class that implements ``Collection`` or
-    ``Map``.
+   The ``IterableCodec`` and ``MapCodec`` classes are deprecated. Instead,
+   use ``CollectionCodec`` and ``MapCodecV2``.
+   These support any class that implements ``Collection`` or
+   ``Map``.
 
 Behavioral changes with the 4.8 driver release include: