com.google.cloud.pubsublite.internal

Interface TopicStatsClient

All Superinterfaces:

ApiBackgroundResource, AutoCloseable, com.google.api.gax.core.BackgroundResource

All Known Implementing Classes:

TopicStatsClientImpl

public interface TopicStatsClient
extends ApiBackgroundResource

Method Summary

Modifier and Type	Method and Description
com.google.api.core.ApiFuture<Cursor>	computeHeadCursor(TopicPath path, Partition partition) Compute the head cursor for the partition.
com.google.api.core.ApiFuture<ComputeMessageStatsResponse>	computeMessageStats(TopicPath path, Partition partition, Offset start, Offset end) Compute statistics about the messages between two cursors in a topic partition.
static TopicStatsClient	create(TopicStatsClientSettings settings)
CloudRegion	region() The Google Cloud region this client operates on.

Methods inherited from interface com.google.cloud.pubsublite.internal.ApiBackgroundResource

close

Methods inherited from interface com.google.api.gax.core.BackgroundResource

awaitTermination, isShutdown, isTerminated, shutdown, shutdownNow

Method Detail

create

static TopicStatsClient create(TopicStatsClientSettings settings)
                        throws com.google.api.gax.rpc.ApiException

Throws:

com.google.api.gax.rpc.ApiException

region

CloudRegion region()

The Google Cloud region this client operates on.

computeMessageStats

com.google.api.core.ApiFuture<ComputeMessageStatsResponse> computeMessageStats(TopicPath path,
                                                                               Partition partition,
                                                                               Offset start,
                                                                               Offset end)

Compute statistics about the messages between two cursors in a topic partition.

Parameters:

path - The topic to compute statistics on

partition - The partition to compute statistics for

start - The start cursor

end - The end cursor

Returns:

A future that will have either an error ApiException or the ComputeMessageStatistics on success.

computeHeadCursor

com.google.api.core.ApiFuture<Cursor> computeHeadCursor(TopicPath path,
                                                        Partition partition)

Compute the head cursor for the partition. The head cursor's offset is guaranteed to be before or equal to all messages which have not yet been acknowledged to be published, and greater than the offset of any message whose publish has already been acknowledged. It is 0 if there have never been messages on the partition.

Parameters:

path - The topic to compute head cursor on

partition - The partition to compute head cursor for

Returns:

A future that will have either an error ApiException or the head cursor on success.