org.springframework.cloud.gcp.pubsub.core.subscriber

Interface PubSubSubscriberOperations

All Known Subinterfaces:

PubSubOperations

All Known Implementing Classes:

PubSubSubscriberTemplate, PubSubTemplate

public interface PubSubSubscriberOperations

An abstraction for Google Cloud Pub/Sub subscription / pulling operations.

Since:

1.1

Author:

Vinicius Carvalho, João André Martins, Mike Eltsufin, Chengyuan Zhao, Doug Hoard

Method Summary

Modifier and Type	Method and Description
org.springframework.util.concurrent.ListenableFuture<Void>	ack(Collection<AcknowledgeablePubsubMessage> acknowledgeablePubsubMessages) Acknowledge a batch of messages.
org.springframework.util.concurrent.ListenableFuture<Void>	modifyAckDeadline(Collection<AcknowledgeablePubsubMessage> acknowledgeablePubsubMessages, int ackDeadlineSeconds) Modify the ack deadline of a batch of messages.
org.springframework.util.concurrent.ListenableFuture<Void>	nack(Collection<AcknowledgeablePubsubMessage> acknowledgeablePubsubMessages) Negatively acknowledge a batch of messages.
List<AcknowledgeablePubsubMessage>	pull(String subscription, Integer maxMessages, Boolean returnImmediately) Pull a number of messages from a Google Cloud Pub/Sub subscription.
List<com.google.pubsub.v1.PubsubMessage>	pullAndAck(String subscription, Integer maxMessages, Boolean returnImmediately) Pull and auto-acknowledge a number of messages from a Google Cloud Pub/Sub subscription.
<T> List<ConvertedAcknowledgeablePubsubMessage<T>>	pullAndConvert(String subscription, Integer maxMessages, Boolean returnImmediately, Class<T> payloadType) Pull a number of messages from a Google Cloud Pub/Sub subscription and convert them to Spring messages with the desired payload type.
com.google.pubsub.v1.PubsubMessage	pullNext(String subscription) Pull and auto-acknowledge a message from a Google Cloud Pub/Sub subscription.
com.google.cloud.pubsub.v1.Subscriber	subscribe(String subscription, Consumer<BasicAcknowledgeablePubsubMessage> messageConsumer) Add a callback method to an existing subscription.
com.google.cloud.pubsub.v1.Subscriber	subscribe(String subscription, com.google.cloud.pubsub.v1.MessageReceiver messageReceiver) Deprecated. as of 1.1, use subscribe(String, Consumer) instead.
<T> com.google.cloud.pubsub.v1.Subscriber	subscribeAndConvert(String subscription, Consumer<ConvertedBasicAcknowledgeablePubsubMessage<T>> messageConsumer, Class<T> payloadType) Add a callback method to an existing subscription that receives Pub/Sub messages converted to the requested payload type.

Method Detail

subscribe

@Deprecated
com.google.cloud.pubsub.v1.Subscriber subscribe(String subscription,
                                                            com.google.cloud.pubsub.v1.MessageReceiver messageReceiver)

Deprecated. as of 1.1, use subscribe(String, Consumer) instead.

Subscribe to a subscription with a given message receiver.

Parameters:

messageReceiver - the message receiver with which to subscribe

subscription - the subscription to subscribe to

Returns:

the subscriber

subscribe

com.google.cloud.pubsub.v1.Subscriber subscribe(String subscription,
                                                Consumer<BasicAcknowledgeablePubsubMessage> messageConsumer)

Add a callback method to an existing subscription.

The created Subscriber is returned so it can be stopped.

Parameters:

subscription - the name of an existing subscription

messageConsumer - the callback method triggered when new messages arrive

Returns:

subscriber listening to new messages

Since:

1.1

subscribeAndConvert

<T> com.google.cloud.pubsub.v1.Subscriber subscribeAndConvert(String subscription,
                                                              Consumer<ConvertedBasicAcknowledgeablePubsubMessage<T>> messageConsumer,
                                                              Class<T> payloadType)

Add a callback method to an existing subscription that receives Pub/Sub messages converted to the requested payload type.

The created Subscriber is returned so it can be stopped.

Type Parameters:

T - the type of the payload

Parameters:

subscription - the name of an existing subscription

messageConsumer - the callback method triggered when new messages arrive

payloadType - the type to which the payload of the Pub/Sub message should be converted

Returns:

subscriber listening to new messages

Since:

1.1

pullAndAck

List<com.google.pubsub.v1.PubsubMessage> pullAndAck(String subscription,
                                                    Integer maxMessages,
                                                    Boolean returnImmediately)

Pull and auto-acknowledge a number of messages from a Google Cloud Pub/Sub subscription.

Parameters:

subscription - the subscription name

maxMessages - the maximum number of pulled messages

returnImmediately - returns immediately even if subscription doesn't contain enough messages to satisfy maxMessages

Returns:

the list of received messages

pull

List<AcknowledgeablePubsubMessage> pull(String subscription,
                                        Integer maxMessages,
                                        Boolean returnImmediately)

Pull a number of messages from a Google Cloud Pub/Sub subscription.

Parameters:

subscription - the subscription name

maxMessages - the maximum number of pulled messages

returnImmediately - returns immediately even if subscription doesn't contain enough messages to satisfy maxMessages

Returns:

the list of received acknowledgeable messages

pullAndConvert

<T> List<ConvertedAcknowledgeablePubsubMessage<T>> pullAndConvert(String subscription,
                                                                  Integer maxMessages,
                                                                  Boolean returnImmediately,
                                                                  Class<T> payloadType)

Pull a number of messages from a Google Cloud Pub/Sub subscription and convert them to Spring messages with the desired payload type.

Type Parameters:

T - the type of the payload

Parameters:

subscription - the subscription name

maxMessages - the maximum number of pulled messages

returnImmediately - returns immediately even if subscription doesn't contain enough messages to satisfy maxMessages

payloadType - the type to which the payload of the Pub/Sub messages should be converted

Returns:

the list of received acknowledgeable messages

Since:

1.1

pullNext

com.google.pubsub.v1.PubsubMessage pullNext(String subscription)

Pull and auto-acknowledge a message from a Google Cloud Pub/Sub subscription.

Parameters:

subscription - the subscription name

Returns:

a received message, or null if none exists in the subscription

ack

org.springframework.util.concurrent.ListenableFuture<Void> ack(Collection<AcknowledgeablePubsubMessage> acknowledgeablePubsubMessages)

Acknowledge a batch of messages. The messages must have the same project id.

Parameters:

acknowledgeablePubsubMessages - messages to be acknowledged

Returns:

ListenableFuture<Void> the ListenableFuture for the asynchronous execution

nack

org.springframework.util.concurrent.ListenableFuture<Void> nack(Collection<AcknowledgeablePubsubMessage> acknowledgeablePubsubMessages)

Negatively acknowledge a batch of messages. The messages must have the same project id.

Parameters:

acknowledgeablePubsubMessages - messages to be negatively acknowledged

Returns:

ListenableFuture<Void> the ListenableFuture for the asynchronous execution

modifyAckDeadline

org.springframework.util.concurrent.ListenableFuture<Void> modifyAckDeadline(Collection<AcknowledgeablePubsubMessage> acknowledgeablePubsubMessages,
                                                                             int ackDeadlineSeconds)

Modify the ack deadline of a batch of messages. The messages must have the same project id.

Parameters:

acknowledgeablePubsubMessages - messages to be modified

ackDeadlineSeconds - the new ack deadline in seconds. A deadline of 0 effectively nacks the messages.

Returns:

ListenableFuture<Void> the ListenableFuture for the asynchronous execution

Since:

1.1