- adds javadoc comments for serializing null values parameters

Author: baywet

src/main/java/com/microsoft/graph/serializer/DefaultSerializer.java

@@ -72,6 +72,11 @@ public DefaultSerializer(@Nonnull final ILogger logger) {
     /**
      * Creates a DefaultSerializer with an option to enable serializing of the null values.
      *
+     * Serializing of null values can have side effects on the service behavior.
+     * Sending null values in a PATCH request might reset existing values on the service side.
+     * Sending null values in a POST request might prevent the service from assigning default values to the properties.
+     * It is not recommended to send null values to the service in general and this setting should only be used when serializing information for a local store.
+     *
      * @param logger         the logger
      * @param serializeNulls the setting of whether or not to serialize the null values in the JSON object
      */

src/main/java/com/microsoft/graph/serializer/GsonFactory.java

@@ -78,6 +78,11 @@ public static Gson getGsonInstance(@Nonnull final ILogger logger) {
     /**
      * Creates an instance of GSON
      *
+     * Serializing of null values can have side effects on the service behavior.
+     * Sending null values in a PATCH request might reset existing values on the service side.
+     * Sending null values in a POST request might prevent the service from assigning default values to the properties.
+     * It is not recommended to send null values to the service in general and this setting should only be used when serializing information for a local store.
+     *
      * @param logger         the logger
      * @param serializeNulls the setting of whether or not to serialize the null values in the JSON object
      * @return the new instance