- All Known Implementing Classes:
public interface TimestampExtractor
An interface that allows the Kafka Streams framework to extract a timestamp from an instance of
ConsumerRecord. The extracted timestamp is defined as milliseconds.
Method SummaryModifier and TypeMethodDescription
(ConsumerRecord<Object, Object> record, long partitionTime)Extracts a timestamp from a record.
(ConsumerRecord<Object, Object> record, long partitionTime)Extracts a timestamp from a record. The timestamp must be positive to be considered a valid timestamp. Returning a negative timestamp will cause the record not to be processed but rather silently skipped. In case the record contains a negative timestamp and this is considered a fatal error for the application, throwing a
RuntimeExceptioninstead of returning the timestamp is a valid option too. For this case, Streams will stop processing and shut down to allow you investigate in the root cause of the negative timestamp.
The timestamp extractor implementation must be stateless.
The extracted timestamp MUST represent the milliseconds since midnight, January 1, 1970 UTC.
It is important to note that this timestamp may become the message timestamp for any messages sent to changelogs updated by
KTables and joins. The message timestamp is used for log retention and log rolling, so using nonsensical values may result in excessive log rolling and therefore broker performance degradation.
record- a data record
partitionTime- the highest extracted valid timestamp of the current record's partition˙ (could be -1 if unknown)
- the timestamp of the record