pojo

Author: norareidy

source/connection/connect.txt

@@ -9,7 +9,7 @@ Connect to MongoDB
    :backlinks: none
    :depth: 1
    :class: singlecol
-   
+
 .. facet::
    :name: genre
    :values: reference
@@ -206,7 +206,7 @@ class. Select the tab that corresponds to your preferred class.
                  .build();
          MongoClient mongoClient = MongoClients.create(settings);
 
-Frequently Asked Questions
+ked Questions
 --------------------------
 
 This section answers questions that may arise when
@@ -217,7 +217,7 @@ Why are there two types of ``MongoClient`` in the Java driver?
 
 There are two types of ``MongoClient`` because we wanted a cleaner API
 for new users that didn't have the confusion of including multiple CRUD
-APIs. We wanted to ensure that the new CRUD API was available in a Java
+Frequently AsAPIs. We wanted to ensure that the new CRUD API was available in a Java
 package structure that would work well with Java module support
 introduced in Java 9.
 

source/data-formats/document-data-format-pojo.txt

@@ -206,6 +206,48 @@ see the following API documentation:
 - `getDefaultCodecRegistry() <{+api+}/apidocs/mongodb-driver-core/com/mongodb/MongoClientSettings.html?is-external=true#getDefaultCodecRegistry()>`__
 - `fromProviders() <{+api+}/apidocs/bson/org/bson/codecs/configuration/CodecRegistries.html#fromProviders(org.bson.codecs.configuration.CodecProvider...)>`__
 
+Frequently Asked Questions
+--------------------------
+
+This section answers questions that may arise when storing
+POJOs in MongoDB.
+
+Do I have to specify an ID field value myself?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+No, the ``PojoCodecProvider`` automatically generates an ObjectId.
+
+Can the ID field be a compound key?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Yes. For an example of this, see `our implementation <https://github.com/niccottrell/mongo-java-tests/blob/master/src/test/PojoCompoundIdTest.java>`__
+in Github.
+
+Can I use polymorphism in a POJO accessor?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Yes, by using a discriminator. For more information, see the :ref:`Discriminators
+<pojo-discriminators>` section of the POJO Customization guide.
+
+Can I mix private, protected, and public setters and getters?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+No. The native POJO codec assumes that getters and setters have the same
+modifiers for each field.
+
+For example, the following methods throws an exception during encoding:
+
+.. code-block:: java
+
+   private String getField();
+   public String setField(String x);
+
+How do I fix: "org.bson.codecs.configuration.CodecConfigurationException: Can't find a codec for class X."?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+This exception means you must register a codec for the class since
+none exist.
+
 Summary
 -------
 

source/data-formats/pojo-customization.txt

@@ -749,7 +749,7 @@ see the following API Documentation:
 
 For more information about generics and type parameters, see the
 `Java language guide on Invoking and Instantiating a Generic Type <https://docs.oracle.com/javase/tutorial/java/generics/types.html#instantiation>`__.
- 
+
 Enum Type Support
 ^^^^^^^^^^^^^^^^^
 
@@ -759,31 +759,14 @@ a codec for ``enum`` types if you need one, such as the one in the default
 codec registry.
 
 See the documentation on the :ref:`default codec registry <codecs-default-codec-registry>`
-For more information about how to register the codecs it includes.
+for more information about how to register the codecs it includes.
 
 Frequently Asked Questions
 --------------------------
 
 This section answers questions that may arise when defining
 data conversion logic.
 
-Do I have to specify an ID field value myself?
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-No, the ``PojoCodecProvider`` automatically generates an ObjectId.
-
-Can the ID field be a compound key?
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Yes. For an example of this, see `our implementation <https://github.com/niccottrell/mongo-java-tests/blob/master/src/test/PojoCompoundIdTest.java>`__
-in Github.
-
-Can I use polymorphism in a POJO accessor?
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Yes, by using a discriminator. For more information, see the :ref:`Discriminators
-<pojo-discriminators>` section.
-
 Can I control serialization of ``LocalDate``?
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -812,25 +795,6 @@ You can configure the ``PojoCodecProvider`` to use the
 ``SET_PRIVATE_FIELDS_CONVENTION``, which sets a private field through
 reflection if no public setter is available.
 
-Can I mix private, protected, and public setters and getters?
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-No. The native POJO codec assumes that getters and setters have the same
-modifiers for each field.
-
-For example, the following methods throws an exception during encoding:
-
-.. code-block:: java
-
-   private String getField();
-   public String setField(String x);
-
-How do I fix: "org.bson.codecs.configuration.CodecConfigurationException: Can't find a codec for class X."?
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-This exception means you must register a codec for the class since
-none exist.
-
 How do I specify the collection name for a particular POJO class? Is there an annotation?
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~