kafka.tier.state

Class FileTierPartitionState.MaterializationListener.LeaderEpoch

java.lang.Object

kafka.tier.state.FileTierPartitionState.MaterializationListener.LeaderEpoch

All Implemented Interfaces:

FileTierPartitionState.MaterializationListener

Enclosing interface:

FileTierPartitionState.MaterializationListener

public static class FileTierPartitionState.MaterializationListener.LeaderEpoch
extends Object
implements FileTierPartitionState.MaterializationListener

Listener for materialization to reach or surpass a particular leader epoch.

Nested Class Summary

Nested classes/interfaces inherited from interface kafka.tier.state.FileTierPartitionState.MaterializationListener

FileTierPartitionState.MaterializationListener.Initialization, FileTierPartitionState.MaterializationListener.LeaderEpoch, FileTierPartitionState.MaterializationListener.ReplicationTargetObjectId, FileTierPartitionState.MaterializationListener.ReplicationTargetOffset

Constructor Summary

Constructors

Constructor and Description
LeaderEpoch(org.slf4j.Logger log, TopicIdPartition topicIdPartition, CompletableFuture<Optional<kafka.log.TierLogSegment>> promise, int leaderEpochToMaterialize)

Method Summary

Modifier and Type	Method and Description
void	cancel(Exception e) Complete this MaterializationListener without a result.
boolean	complete(kafka.tier.state.FileTierPartitionState.State flushedState) Try to complete this listener.
boolean	mayComplete(kafka.tier.state.FileTierPartitionState.State unflushedState, Optional<AbstractTierMetadata> ignored) Observe the unflushed FileTierPartitionState.State to determine if this listener can be completed after a flush.
String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

LeaderEpoch

public LeaderEpoch(org.slf4j.Logger log,
                   TopicIdPartition topicIdPartition,
                   CompletableFuture<Optional<kafka.log.TierLogSegment>> promise,
                   int leaderEpochToMaterialize)

Method Detail

mayComplete

public boolean mayComplete(kafka.tier.state.FileTierPartitionState.State unflushedState,
                           Optional<AbstractTierMetadata> ignored)

Description copied from interface: FileTierPartitionState.MaterializationListener

Observe the unflushed FileTierPartitionState.State to determine if this listener can be completed after a flush. This is used as a hint to indicate that flushing the FileTierPartitionState.State *may* allow the listener to complete. There is no guarantee that MaterializationListener::canComplete will be called prior to MaterializationListener::complete, or at all.

Specified by:

mayComplete in interface FileTierPartitionState.MaterializationListener

Parameters:

unflushedState - The unflushed TierPartitionState.State

ignored - Optionally, an unflushed message which has mutated the provided FileTierPartitionState.State. This is sometimes useful for situations where it is expensive to query the unflushedState, but a cheaper check is possible by observing the most recently applied AbstractTierMetadata.

Returns:

True if a state flush *may* allow the listener to complete.

complete

public boolean complete(kafka.tier.state.FileTierPartitionState.State flushedState)
                 throws IOException

Description copied from interface: FileTierPartitionState.MaterializationListener

Try to complete this listener. Completed listeners will not be called again. It's important that implementation of this method do not rely on MaterializationListener::canComplete, as there are no guarantees that MaterializationListener::canComplete will be called prior to MaterializationListener::complete.

Specified by:

complete in interface FileTierPartitionState.MaterializationListener

Parameters:

flushedState - The flushed TierPartitionState.State.

Returns:

True if this listener has completed.

Throws:

IOException

cancel

public void cancel(Exception e)

Description copied from interface: FileTierPartitionState.MaterializationListener

Complete this MaterializationListener without a result. In cases where the FileTierPartitionState.State needs to interrupt materialization for closing, or replacing the current FileTierPartitionState.State, this will be called.

Specified by:

cancel in interface FileTierPartitionState.MaterializationListener

toString

public String toString()

Overrides:

toString in class Object