Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

@return a mapping from partition to the timestamp and offset of the first message with timestamp greater
than or equal to the target timestamp. {@code null}
will be returned for the partition if there is no
such message.

This design introduces inconsistency risks: developers often assume that if Map.containsKey() returns true, the corresponding value is non-null. This can lead to unexpected NullPointerExceptions when null checks are omitted.

...

Code Block
languagejava
@Deprecated(since = "4.1")
public static final String ALLOW_NULL_OFFSETS_ENTRIES_CONFIG = "allow.null.offsets.entries";
@Deprecated(since = "4.1")
public static final boolean DEFAULT_ALLOW_NULL_OFFSETS_ENTRIES = true;
@Deprecated(since = "4.1")
private static final String ALLOW_NULL_OFFSETS_ENTRIES_DOC = "Specifies whether to allow null entries in certain public admin APIs. " +
    "The following methods are affected: " +
	"<code>listOffsets(Map)</code>, listOffsets(Map, ListOffsetsOptions). "
    "If set to <code>true</code>, -1 entries are permitted, and the behavior of these methods remains unchanged. " +
    "If set to <code>false</code>, -1 entries are not allowed, and these methods will not return -1 values. " +
    "This configuration acts as a transitional bridge. Starting from Kafka 5.0, these methods will no longer return null-1 " +
    "entries by default, and this configuration will be removed.";

...