com.rabbitmq.stream

Interface Environment

All Superinterfaces:

AutoCloseable

public interface Environment
extends AutoCloseable

The Environment is the main entry point to a node or a cluster of nodes. Producer and Consumer instances are created from an Environment instance. An Environment can also create and delete streams.

Applications are supposed to use a single Environment instance to interact with a cluster.

Use builder() to configure and create an Environment instance.

Environment instances are expected to be thread-safe.

See Also:

EnvironmentBuilder

Method Summary

Modifier and Type	Method and Description
static EnvironmentBuilder	builder() Create a builder to configure and create an Environment
void	close() Close the environment and its resources.
ConsumerBuilder	consumerBuilder() Create a ConsumerBuilder to configure and create a Consumer
void	deleteStream(String stream) Delete a stream
void	deleteSuperStream(String superStream) Delete a super stream.
ProducerBuilder	producerBuilder() Create a ProducerBuilder to configure and create a Producer.
StreamStats	queryStreamStats(String stream) Query statistics on a stream.
StreamCreator	streamCreator() Return a StreamCreator to configure and create a stream.
boolean	streamExists(String stream) Return whether a stream exists or not.

Method Detail

builder

static EnvironmentBuilder builder()

Create a builder to configure and create an Environment

Returns:

the environment builder

See Also:

EnvironmentBuilder

streamCreator

StreamCreator streamCreator()

Return a StreamCreator to configure and create a stream.

Returns:

the stream creator

See Also:

StreamCreator

deleteStream

void deleteStream(String stream)

Delete a stream

Parameters:

stream - the stream to delete

Since:

0.15.0

deleteSuperStream

void deleteSuperStream(String superStream)

Delete a super stream.

Requires RabbitMQ 3.13.0 or more.

Parameters:

superStream - the super stream to delete

queryStreamStats

StreamStats queryStreamStats(String stream)

Query statistics on a stream.

Requires RabbitMQ 3.11 or more.

Parameters:

stream - the stream to get statistics from

Returns:

statistics on the stream

Throws:

UnsupportedOperationException - if the broker does not support this command

streamExists

boolean streamExists(String stream)

Return whether a stream exists or not.

Parameters:

stream - the stream to check the existence

Returns:

true if stream exists, false if it does not exist

Throws:

StreamException - if response code is different from Constants.RESPONSE_CODE_OK or Constants.RESPONSE_CODE_STREAM_DOES_NOT_EXIST

producerBuilder

ProducerBuilder producerBuilder()

Create a ProducerBuilder to configure and create a Producer.

Returns:

the producer builder

See Also:

ProducerBuilder

consumerBuilder

ConsumerBuilder consumerBuilder()

Create a ConsumerBuilder to configure and create a Consumer

Returns:

the consumer builder

See Also:

ConsumerBuilder

close

void close()

Close the environment and its resources.

Specified by:

close in interface AutoCloseable