Changes requested in code review.

Author: fmeheust

ojdbc-provider-common/src/main/java/oracle/jdbc/provider/parameter/ParameterSetBuilder.java

@@ -44,13 +44,17 @@
 public interface ParameterSetBuilder {
 
   /**
-   * Adds a parameter with a given name and value.
+   * Adds a parameter with a given name and value. If the value is null, the 
+   * ParameterSet will behave as if no value has been set for the parameter. 
+   * Calling this method with a null value allows the ParameterSet to create 
+   * error messages that identify the {@code name} of missing parameters.
    *
    * @param <T> The type of value that is assigned to the parameter
-   * @param name The parameter name
+   * @param name The parameter name. Not null.
    * @param parameter The parameter that is assigned with the {@code name} and
-   *                  {@code value} in this set
-   * @param value The value
+   *                  {@code value} in this set. Not null.
+   * @param value The value, or null if the parameter is not configured with a 
+   *              value.
    * @return A reference to this object
    */
   <T> ParameterSetBuilder add(String name, Parameter<T> parameter, T value);

ojdbc-provider-common/src/main/java/oracle/jdbc/provider/parameter/ParameterSetParser.java

@@ -189,6 +189,11 @@ <T> Builder addParameter(
      * the parsed input includes an assignment such as "x=0", then "0" is input
      * to the {@code valueSetter}.
      * </p><p>
+     * The {@code valueSetter} must be able to handle a null input. A null input will occur
+     * when no value is set for the parameter. The {@code valueSetter} may simply pass
+     * the null value onto the {@code ParameterSetBuilder}, or it may pass in a default
+     * value.
+     * </p><p>
      * This method is designed for cases where a single parameter in text format
      * may map to multiple {@link Parameter} objects. The {@code valueSetter}
      * function can perform multiple calls to set each parameter, as in this

ojdbc-provider-common/src/main/java/oracle/jdbc/provider/parameter/ParameterSetParserImpl.java

@@ -129,7 +129,8 @@ public Builder addParameter(
       String name, Parameter<String> parameter, String defaultValue) {
       addParameterParser(
           name,
-          (value, builder) -> builder.add(name, parameter, value));
+          (value, builder) -> builder.add(name, parameter, 
+                              value == null ? defaultValue : value));
       return this;
     }