docs: comments for write null fields

src/main/java/com/influxdb/v3/client/InfluxDBClient.java

@@ -78,7 +78,12 @@ public interface InfluxDBClient extends AutoCloseable {
      * @param point the {@link Point} to write, can be null
      * <p>
      * Note: the timestamp passed will be converted to nanoseconds since the Unix epoch
-     * by NanosecondConverter helper class
+     * by NanosecondConverter helper class. <br>
+     * Warning: Fields with {@code null} values in a {@link Point} are not written to InfluxDB.
+     *
+     * If such fields are later queried explicitly, for example:
+     * {@code SELECT normalField, nullField FROM my_table}
+     * an error will be thrown.
      */
     void writePoint(@Nullable final Point point);
 
@@ -89,7 +94,12 @@ public interface InfluxDBClient extends AutoCloseable {
      * @param options the options for writing data to InfluxDB
      * <p>
      * Note: the timestamp passed will be converted to nanoseconds since the Unix epoch
-     * by NanosecondConverter helper class
+     * by NanosecondConverter helper class. <br>
+     * Warning: Fields with {@code null} values in a {@link Point} are not written to InfluxDB.
+     *
+     * If such fields are later queried explicitly, for example:
+     * {@code SELECT normalField, nullField FROM my_table}
+     * an error will be thrown.
      */
     void writePoint(@Nullable final Point point, @Nonnull final WriteOptions options);
 
@@ -99,7 +109,11 @@ public interface InfluxDBClient extends AutoCloseable {
      * @param points the list of {@link Point} to write, cannot be null
      * <p>
      * Note: the timestamp passed will be converted to nanoseconds since the Unix epoch
-     * by NanosecondConverter helper class
+     * by NanosecondConverter helper class. <br>
+     * Warning: If the provided list contains only one {@link Point}, and that {@code Point}
+     * contains fields with {@code null} values, those fields are not written to InfluxDB.
+     * If such fields are later queried explicitly, for example:
+     * {@code SELECT normalField, nullField FROM my_table} an error will be thrown.
      */
     void writePoints(@Nonnull final List<Point> points);
 
@@ -110,7 +124,14 @@ public interface InfluxDBClient extends AutoCloseable {
      * @param options the options for writing data to InfluxDB
      * <p>
      * Note: the timestamp passed will be converted to nanoseconds since the Unix epoch
-     * by NanosecondConverter helper class
+     * by NanosecondConverter helper class. <br>
+     *
+     * Warning: If the provided list contains only one {@link Point}, and that {@code Point}
+     * contains fields with {@code null} values, those fields are not written to InfluxDB.
+     *
+     * If such fields are later queried explicitly, for example:
+     * {@code SELECT normalField, nullField FROM my_table}
+     * an error will be thrown.
      */
     void writePoints(@Nonnull final List<Point> points, @Nonnull final WriteOptions options);