Page History

    
    /**
     * Determines if this StateStore manages its own offsets.
     * <p>
     * If this method returns {@code true}, then offsets provided to {@link #commit(Map)} will be retrievable using
     * {@link #committedOffset(TopicPartition)}, even if the store is {@link #close() closed} and later re-opened.
     * <p>
     * If this method returns {@code false}, offsets provided to {@link #commit(Map)} will be ignored, and {@link
     * #committedOffset(TopicPartition)} will be expected to always return {@code null}.
     * <p>
     * This method is provided to enable custom StateStores to opt-in to managing their own offsets. This is highly
     * recommended, if possible, to ensure that custom StateStores provide the consistency guarantees that Kafka Streams
     * expects when operating under the {@code exactly-once} {@code processing.mode}.
     * 
     * @return Whether this StateStore manages its@deprecated New implementations should always return {@code true} and manage their own offsets.
 In    */the future,
    default boolean* managesOffsets() {
        return false;
  this method }

will be removed and /**
it will be assumed to *always Flushreturn any cached data{@code true}.
     * 
@return Whether this StateStore manages *its @deprecated Use {@link org.apache.kafka.streams.processor.api.ProcessingContext#commit() ProcessorContext#commit()}own offsets.
     */
    @Deprecated
    default boolean managesOffsets() {
  instead.
     */
    @Deprecated
    default void flush() {
     return false;
   // no-op
    }

    /**
     * CommitFlush allany written records to this StateStore.cached data
     * <p>
     * This@deprecated methodUse <b>MUST NOT<b> be called by users from {@link org.{@link org.apache.kafka.streams.processor.api.ProcessorProcessingContext#commit() ProcessorContext#commit()}
     * processors}, as doing so may violate the consistency guarantees provided by this store, and expected by Kafkainstead.
     */
     * Streams.@Deprecated
    default * <p>
void flush() {
        // no-op
 * Instead, users should}

 call {@link org.apache.kafka.streams.processor.api.ProcessingContext#commit()  /**
     * ProcessorContext#commit()} to request a Task commit Commit all written records to this StateStore.
     * <p>
     * If {@link #managesOffsets()} returns {@code true}, the given {@code changelogOffsets} will be guaranteed to be 
     * persisted to disk along with the written records.This method <b>MUST NOT<b> be called by users from {@link org.apache.kafka.streams.processor.api.Processor
     * processors}, as doing so may violate the consistency guarantees provided by this store, and expected by Kafka
     * <p>Streams.
     * {@code<p>
 changelogOffsets} will usually contain a* single partitionInstead, inusers theshould casecall of a regular StateStore. However,
     * they may contain multiple partitions in the case of a Global StateStore with multiple partitions. All provided{@link org.apache.kafka.streams.processor.api.ProcessingContext#commit() 
     * partitions <em>MUST</em> be persisted to diskProcessorContext#commit()} to request a Task commit.
     * <p>
     * Implementations <em>SHOULD</em> ensure thatIf {@link #managesOffsets()} returns {@code true}, the given {@code changelogOffsets} will arebe committedguaranteed to be disk
 atomically with the
  * persisted to *disk recordsalong theywith represent,the ifwritten possiblerecords.
     * <p>
     * @param{@code changelogOffsets} Thewill changelog offset(s) corresponding to the most recently written records.usually contain a single partition, in the case of a regular StateStore. However,
     */
 they may contain defaultmultiple voidpartitions commit(final Map<TopicPartition, Long> changelogOffsets) {
        flush();in the case of a Global StateStore with multiple partitions. All provided
    }

    /** * partitions <em>MUST</em> be persisted to disk.
     * Returns<p>
 the most recently {@link #commit(Map) committed} offset for the given {@link TopicPartition}.
     * <p> * Implementations <em>SHOULD</em> ensure that {@code changelogOffsets} are committed to disk atomically with the
     * Ifrecords {@link #managesOffsets()} and {@link #persistent()} both return {@code true}, this method will return the
     * offset that correspondsthey represent, if possible.
     * 
     * @param changelogOffsets The changelog offset(s) corresponding to the changelog record most recently written torecords.
 this store, for the given {@code */
    default * partition}.
     * 
void commit(final Map<TopicPartition, Long> changelogOffsets) {
       * @paramflush();
 partition The partition to get the committed offset for. }

    /**
     * @returnReturns the Themost lastrecently {@link #commit(Map) committed} offset for the given {@code@link partitionTopicPartition};.
 or {@code null} if no* offset<p>
     *         has been committed for the partition, or if either If {@link #persistent#managesOffsets()} orand {@link #managesOffsets#persistent()}
 both return {@code true}, *this method will return the
     return {@code false}.
     */
    default Long committedOffset(final TopicPartition partition) {
   * offset that corresponds to the changelog record most recently written to this store, for the given {@code
     * partition}.
     return* null;
    }

     * @param partition The partition to get the committed offset for.
     * @return The last {@link #commit(Map) committed} offset for the {@code partition}; or {@code null} if no offset
     *         has been committed for the partition, or if either {@link #persistent()} or {@link #managesOffsets()}
     *         return {@code false}.
     */
    default Long committedOffset(final TopicPartition partition) {
        return null;
    }