grpc.cache_client.pubsub

Class PubsubGrpc.PubsubFutureStub

java.lang.Object

io.grpc.stub.AbstractStub<S>

io.grpc.stub.AbstractFutureStub<PubsubGrpc.PubsubFutureStub>

grpc.cache_client.pubsub.PubsubGrpc.PubsubFutureStub

Enclosing class:

PubsubGrpc

public static final class PubsubGrpc.PubsubFutureStub
extends io.grpc.stub.AbstractFutureStub<PubsubGrpc.PubsubFutureStub>

 For working with topics in a cache.
 Momento topics are conceptually located on a cache. They are best-effort multicast.
 To use them, create a cache then start subscribing and publishing!
 Momento topic subscriptions try to give you information about the quality of the
   stream you are receiving. For example, you might miss messages if your network
   is slow, or if some intermediate switch fails, or due to rate limiting. It is
   also possible, though we try to avoid it, that messages could briefly come out
   of order between subscribers.
   We try to tell you when things like this happen via a Discontinuity in your
   subscription stream. If you do not care about occasional discontinuities then
   don't bother handling them! You might still want to log them just in case ;-)
 

Nested Class Summary

Nested classes/interfaces inherited from class io.grpc.stub.AbstractStub

io.grpc.stub.AbstractStub.StubFactory<T extends io.grpc.stub.AbstractStub<T>>

Method Summary

Modifier and Type	Method and Description
protected PubsubGrpc.PubsubFutureStub	build(io.grpc.Channel channel, io.grpc.CallOptions callOptions)
com.google.common.util.concurrent.ListenableFuture<_Empty>	publish(_PublishRequest request) Publish a message to a topic.

Methods inherited from class io.grpc.stub.AbstractFutureStub

newStub, newStub

Methods inherited from class io.grpc.stub.AbstractStub

getCallOptions, getChannel, withCallCredentials, withChannel, withCompression, withDeadline, withDeadlineAfter, withExecutor, withInterceptors, withMaxInboundMessageSize, withMaxOutboundMessageSize, withOption, withWaitForReady

Methods inherited from class java.lang.Object

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

Method Detail

build

protected PubsubGrpc.PubsubFutureStub build(io.grpc.Channel channel,
                                            io.grpc.CallOptions callOptions)

Specified by:

build in class io.grpc.stub.AbstractStub<PubsubGrpc.PubsubFutureStub>

publish

public com.google.common.util.concurrent.ListenableFuture<_Empty> publish(_PublishRequest request)

 Publish a message to a topic.
 If a topic has no subscribers, then the effect of Publish MAY be either of:
 * It is dropped and the topic is nonexistent.
 * It is accepted to the topic as the next message.
 Publish() does not wait for subscribers to accept. It returns Ok upon accepting
 the topic value. It also returns Ok if there are no subscribers and the value
 happens to be dropped. Publish() can not guarantee delivery in theory but in
 practice it should almost always deliver to subscribers.
 REQUIRES HEADER authorization: Momento auth token