com.azure.messaging.eventhubs

Class EventDataBatch

java.lang.Object

com.azure.messaging.eventhubs.EventDataBatch

public final class EventDataBatch
extends Object

A class for aggregating EventData into a single, size-limited, batch. It is treated as a single message when sent to the Azure Event Hubs service.

See Also:

EventHubProducerClient.createBatch(), EventHubProducerAsyncClient.createBatch(), See EventHubClientBuilder for examples of building an asynchronous or synchronous producer.

Method Summary

Modifier and Type	Method and Description
int	getCount() Gets the number of events in the batch.
int	getMaxSizeInBytes() Gets the maximum size, in bytes, of the EventDataBatch.
int	getSizeInBytes() Gets the size of the EventDataBatch in bytes.
boolean	tryAdd(EventData eventData) Tries to add an event to the batch.

Methods inherited from class java.lang.Object

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

Method Detail

getCount

public int getCount()

Gets the number of events in the batch.

Returns:

The number of events in the batch.

getMaxSizeInBytes

public int getMaxSizeInBytes()

Gets the maximum size, in bytes, of the EventDataBatch.

Returns:

The maximum size, in bytes, of the EventDataBatch.

getSizeInBytes

public int getSizeInBytes()

Gets the size of the EventDataBatch in bytes.

Returns:

the size of the EventDataBatch in bytes.

tryAdd

public boolean tryAdd(EventData eventData)

Tries to add an event to the batch.

Parameters:

eventData - The EventData to add to the batch.

Returns:

true if the event could be added to the batch; false if the event was too large to fit in the batch.

Throws:

IllegalArgumentException - if eventData is null.

com.azure.core.amqp.exception.AmqpException - if eventData is larger than the maximum size of the EventDataBatch.