org.apache.pulsar.client.api

接口 Reader<T>

所有超级接口:

AutoCloseable, Closeable

public interface Reader<T>
extends Closeable

A Reader can be used to scan through all the messages currently available in a topic.

方法概要

限定符和类型	方法和说明
CompletableFuture<Void>	closeAsync() Asynchronously close the reader and stop the broker to push more messages
String	getTopic()
boolean	hasMessageAvailable() Check if there is any message available to read from the current position.
CompletableFuture<Boolean>	hasMessageAvailableAsync() Asynchronously check if there is any message available to read from the current position.
boolean	hasReachedEndOfTopic() Return true if the topic was terminated and this reader has reached the end of the topic.
boolean	isConnected()
Message<T>	readNext() Read the next message in the topic.
Message<T>	readNext(int timeout, TimeUnit unit) Read the next message in the topic waiting for a maximum time.
CompletableFuture<Message<T>>	readNextAsync() Read asynchronously the next message in the topic.
void	seek(long timestamp) Reset the subscription associated with this reader to a specific message publish time.
void	seek(MessageId messageId) Reset the subscription associated with this reader to a specific message id.
CompletableFuture<Void>	seekAsync(long timestamp) Reset the subscription associated with this reader to a specific message publish time.
CompletableFuture<Void>	seekAsync(MessageId messageId) Reset the subscription associated with this reader to a specific message id.

从接口继承的方法 java.io.Closeable

close

方法详细资料

getTopic

String getTopic()

返回:

the topic from which this reader is reading from

readNext

Message<T> readNext()
             throws PulsarClientException

Read the next message in the topic.

This method will block until a message is available.

返回:

the next message

抛出:

PulsarClientException

readNext

Message<T> readNext(int timeout,
                    TimeUnit unit)
             throws PulsarClientException

Read the next message in the topic waiting for a maximum time.

Returns null if no message is received before the timeout.

返回:

the next message(Could be null if none received in time)

抛出:

PulsarClientException

readNextAsync

CompletableFuture<Message<T>> readNextAsync()

Read asynchronously the next message in the topic.

返回:

a future that will yield a message (when it's available) or PulsarClientException if the reader is already closed.

closeAsync

CompletableFuture<Void> closeAsync()

Asynchronously close the reader and stop the broker to push more messages

返回:

a future that can be used to track the completion of the operation

hasReachedEndOfTopic

boolean hasReachedEndOfTopic()

Return true if the topic was terminated and this reader has reached the end of the topic.

Note that this only applies to a "terminated" topic (where the topic is "sealed" and no more messages can be published) and not just that the reader is simply caught up with the publishers. Use hasMessageAvailable() to check for for that.

hasMessageAvailable

boolean hasMessageAvailable()
                     throws PulsarClientException

Check if there is any message available to read from the current position.

This check can be used by an application to scan through a topic and stop when the reader reaches the current last published message. For example:

 while (reader.hasMessageAvailable()) {
     Message<String> msg = reader.readNext();
     // Do something
 }

 // Done reading
 

Note that this call might be blocking (see #hasMessageAvailableAsync() for async version) and that even if this call returns true, that will not guarantee that a subsequent call to {@link #readNext()} will not block.

返回:

true if the are messages available to be read, false otherwise

抛出:

PulsarClientException - if there was any error in the operation

hasMessageAvailableAsync

CompletableFuture<Boolean> hasMessageAvailableAsync()

Asynchronously check if there is any message available to read from the current position.

This check can be used by an application to scan through a topic and stop when the reader reaches the current last published message.

返回:

a future that will yield true if the are messages available to be read, false otherwise, or a PulsarClientException if there was any error in the operation

isConnected

boolean isConnected()

返回:

Whether the reader is connected to the broker

seek

void seek(MessageId messageId)
   throws PulsarClientException

Reset the subscription associated with this reader to a specific message id.

The message id can either be a specific message or represent the first or last messages in the topic.

• MessageId.earliest : Reset the reader on the earliest message available in the topic
• MessageId.latest : Reset the reader on the latest message in the topic

Note: this operation can only be done on non-partitioned topics. For these, one can rather perform the seek() on the individual partitions.

参数:

messageId - the message id where to reposition the reader

抛出:

PulsarClientException

seek

void seek(long timestamp)
   throws PulsarClientException

Reset the subscription associated with this reader to a specific message publish time. Note: this operation can only be done on non-partitioned topics. For these, one can rather perform the seek() on the individual partitions.

参数:

timestamp - the message publish time where to reposition the reader

抛出:

PulsarClientException

seekAsync

CompletableFuture<Void> seekAsync(MessageId messageId)

Reset the subscription associated with this reader to a specific message id.

The message id can either be a specific message or represent the first or last messages in the topic.

• MessageId.earliest : Reset the reader on the earliest message available in the topic
• MessageId.latest : Reset the reader on the latest message in the topic

Note: this operation can only be done on non-partitioned topics. For these, one can rather perform the seek() on the individual partitions.

参数:

messageId - the message id where to position the reader

返回:

a future to track the completion of the seek operation

seekAsync

CompletableFuture<Void> seekAsync(long timestamp)

Reset the subscription associated with this reader to a specific message publish time. Note: this operation can only be done on non-partitioned topics. For these, one can rather perform the seek() on the individual partitions.

参数:

timestamp - the message publish time where to position the reader

返回:

a future to track the completion of the seek operation