Package org.jclouds.openstack.marconi.v1.options

Class StreamMessagesOptions.Builder

java.lang.Object

org.jclouds.openstack.marconi.v1.options.StreamMessagesOptions.Builder

Enclosing class:

StreamMessagesOptions

public static class StreamMessagesOptions.Builder
extends Object

Constructor Summary

Constructors

Constructor	Description
Builder()

Method Summary

Modifier and Type	Method	Description
static StreamMessagesOptions	echo(boolean echo)	The echo parameter determines whether the API returns a client's own messages, as determined by the clientId (UUID) portion of the client.
static StreamMessagesOptions	includeClaimed(boolean includeClaimed)	The includeClaimed parameter determines whether the API returns claimed messages.
static StreamMessagesOptions	limit(int limit)	When more messages are available than can be returned in a single request, the client can pick up the next batch of messages by simply using the {@see StremOptions} returned from the previous call in MessageStream#nextStreamOptions().
static StreamMessagesOptions	marker(String marker)	Specifies an opaque string that the client can use to request the next batch of messages.
static StreamMessagesOptions	queryParameters(com.google.common.collect.Multimap<String,String> queryParams)

Methods inherited from class java.lang.Object

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

Constructor Detail

Builder

public Builder()

Method Detail

queryParameters

public static StreamMessagesOptions queryParameters(com.google.common.collect.Multimap<String,String> queryParams)

See Also:

PaginationOptions.queryParameters(Multimap)

marker

public static StreamMessagesOptions marker(String marker)

Specifies an opaque string that the client can use to request the next batch of messages. The marker parameter communicates to the server which messages the client has already received. If you do not specify a value, the API returns all messages at the head of the queue (up to the limit).

Clients should make no assumptions about the format or length of the marker. Furthermore, clients should assume that there is no relationship between markers and message IDs.

limit

public static StreamMessagesOptions limit(int limit)

When more messages are available than can be returned in a single request, the client can pick up the next batch of messages by simply using the {@see StremOptions} returned from the previous call in MessageStream#nextStreamOptions(). Specifies up to 10 messages (the default value) to return. If you do not specify a value for the limit parameter, the default value of 10 is used.

echo

public static StreamMessagesOptions echo(boolean echo)

The echo parameter determines whether the API returns a client's own messages, as determined by the clientId (UUID) portion of the client. If you do not specify a value, echo uses the default value of false. If you are experimenting with the API, you might want to set echo=true in order to see the messages that you posted.

includeClaimed

public static StreamMessagesOptions includeClaimed(boolean includeClaimed)

The includeClaimed parameter determines whether the API returns claimed messages.