diff --git a/source/fundamentals/connection/mongoclientsettings.txt b/source/fundamentals/connection/mongoclientsettings.txt index 4f1ade7ee..154cec5c6 100644 --- a/source/fundamentals/connection/mongoclientsettings.txt +++ b/source/fundamentals/connection/mongoclientsettings.txt @@ -259,26 +259,23 @@ settings to modify the driver's behavior: * - ``serverSelector()`` - Adds a server selector to apply before server selection. - + * - ``srvHost()`` - - Sets the host name to use to look up an SRV DNS record to find the - MongoDB hosts. - - .. note:: - - When setting ``srvHost``, the driver does not process any - associated TXT records associated with the host. - - If you want to enable the processing of TXT records, you must - specify the SRV host in the connection string using the - ``applyConnectionString()`` method. - - .. code-block:: java - :emphasize-lines: 3 - - MongoClient mongoClient = MongoClients.create( - MongoClientSettings.builder() - .applyConnectionString(new ConnectionString("mongodb+srv://host1.acme.com"))) + - | Sets the host name to use to look up an SRV DNS record to find the + MongoDB hosts. + | + | If you want to enable the processing of TXT records associated with the host, + specify the SRV host in the connection string + using the ``applyConnectionString()`` method. + | + | For example: + + .. code-block:: java + :emphasize-lines: 3 + + MongoClient mongoClient = + MongoClients.create(MongoClientSettings.builder() + .applyConnectionString(new ConnectionString("mongodb+srv://host1.acme.com"))) * - ``srvMaxHosts()`` - | Sets the maximum number of hosts the driver can connect to when using diff --git a/source/fundamentals/data-formats/pojo-customization.txt b/source/fundamentals/data-formats/pojo-customization.txt index eb79ee05a..ea54ddce4 100644 --- a/source/fundamentals/data-formats/pojo-customization.txt +++ b/source/fundamentals/data-formats/pojo-customization.txt @@ -285,11 +285,7 @@ package: * - ``BsonRepresentation`` - Specifies the BSON type used to store the value when different from the - POJO property. - - .. seealso:: - - :ref:`bsonrepresentation-annotation-code-example` + POJO property. See an example of :ref:`bsonrepresentation-annotation-code-example` on this page. * - ``BsonId`` - Marks a property to serialize as the _id property. @@ -299,28 +295,24 @@ package: and/or deserialize a property. * - ``BsonProperty`` - - Specifies a custom document field name when converting the POJO - field to BSON. You can include a discriminator to serialize POJOs - nested within the field. - - .. important:: + - | Specifies a custom document field name when converting the POJO + field to BSON. You can include a discriminator to serialize POJOs + nested within the field. + | + | When applying ``@BsonProperty`` to a private field, + **you must also add getter and setter methods for that field to serialize and + customize the field name**. - When applying ``@BsonProperty`` to a private field, you must also add - getter and setter methods for that field to serialize and customize - the field name. * - ``BsonExtraElements`` - - Specifies the POJO field on which to deserialize all elements that are - not mapped to a field. The POJO field must be one of the following - types: - - - `Document <{+api+}/apidocs/bson/org/bson/Document.html>`__ - - `BsonDocument <{+api+}/apidocs/bson/org/bson/BsonDocument.html>`__ - - ``Map`` - - .. seealso:: - - :ref:`BsonExtraElements Annotation Example ` + - | Specifies the POJO field on which to deserialize all elements that are + not mapped to a field. The POJO field must be one of the following + types: + | - `Document <{+api+}/apidocs/bson/org/bson/Document.html>`__ + | - `BsonDocument <{+api+}/apidocs/bson/org/bson/BsonDocument.html>`__ + | - ``Map`` + | + | See an example of a :ref:`BsonExtraElements Annotation Example `. The following code snippet shows a sample POJO called ``Product`` that uses several of the preceding annotations.