ReceiveOptions Classe

Pacote:

com.azure.messaging.eventhubs.models

Artefato Maven:

com.azure:azure-messaging-eventhubs:5.19.2

• java.lang.Object
• • com.azure.messaging.eventhubs.models.ReceiveOptions

public class ReceiveOptions

Conjunto de opções que podem ser especificadas ao receber eventos de um EventHubConsumerAsyncClient ou EventHubConsumerClient.

Resumo do Construtor

Construtor	Description
ReceiveOptions()	Cria uma nova instância.

Resumo do método

Modificador e tipo	Método e descrição
Long	getOwnerLevel() Obtém o nível de proprietário para esse consumidor.
boolean	getTrackLastEnqueuedEventProperties() Obtém se a operação de recebimento deve ou não solicitar informações sobre o último evento enfileirado em sua partição associada e acompanhar essas informações à medida que os eventos são recebidos.
ReceiveOptions	setOwnerLevel(Long priority) Define o ownerLevel valor nessa operação de recebimento.
ReceiveOptions	setTrackLastEnqueuedEventProperties(boolean trackLastEnqueuedEventProperties) Define se a operação de recebimento deve ou não solicitar informações sobre o último evento enfileirado em sua partição associada e acompanhar essas informações à medida que os eventos são recebidos.

Métodos herdados de java.lang.Object

clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Detalhes do construtor

ReceiveOptions

public ReceiveOptions()

Cria uma nova instância.

Detalhes do método

getOwnerLevel

public Long getOwnerLevel()

Obtém o nível de proprietário para esse consumidor. Se o valor for null, esse não será um consumidor exclusivo. Caso contrário, ele é um consumidor exclusivo e só pode haver um consumidor ativo para cada combinação de partição e grupo de consumidores. O consumidor exclusivo é baseado em qual deles tem o valor de nível de proprietário mais alto.

Retornos:

O nível de proprietário para essa operação de recebimento. Se o null, isso não será um consumidor exclusivo.

getTrackLastEnqueuedEventProperties

public boolean getTrackLastEnqueuedEventProperties()

Obtém se a operação de recebimento deve ou não solicitar informações sobre o último evento enfileirado em sua partição associada e acompanhar essas informações à medida que os eventos são recebidos.

Retornos:

true se a operação de recebimento resultante manter o controle das últimas informações enfileiradas para essa partição; false Caso contrário.

setOwnerLevel

public ReceiveOptions setOwnerLevel(Long priority)

Define o ownerLevel valor nessa operação de recebimento. Quando populado, o nível indica que a operação de recebimento destina-se a ser o único leitor de eventos para a partição solicitada e o grupo de consumidores associados. Para fazer isso, essa operação de recebimento tentará declarar a propriedade sobre a partição; no caso em que houver mais de uma operação de recebimento exclusivo para o mesmo par de partição/grupo de consumidores, aquele com um valor maior getOwnerLevel() "ganhará".

Quando uma operação de recebimento exclusivo é usada, essas operações de recebimento que não são exclusivas ou que têm uma prioridade mais baixa não terão permissão para serem criadas. Se eles já existirem, encontrará uma exceção durante a próxima tentativa de operação.

Parâmetros:

priority - A prioridade associada a uma operação de recebimento exclusivo; para uma operação de recebimento não exclusiva, esse valor deve ser null.

Retornos:

O objeto atualizado ReceiveOptions.

setTrackLastEnqueuedEventProperties

public ReceiveOptions setTrackLastEnqueuedEventProperties(boolean trackLastEnqueuedEventProperties)

Define se a operação de recebimento deve ou não solicitar informações sobre o último evento enfileirado em sua partição associada e acompanhar essas informações à medida que os eventos são recebidos.

Quando informações sobre o último evento enfileirado da partição estiverem sendo rastreadas, cada evento recebido do serviço hubs de eventos carregará metadados sobre a partição que, de outra forma, não o faria. Isso resulta em uma pequena quantidade de consumo adicional de largura de banda de rede que geralmente é uma compensação favorável quando considerada para fazer periodicamente solicitações de propriedades de partição usando o cliente do Hub de Eventos.

Parâmetros:

trackLastEnqueuedEventProperties - true se os eventos resultantes acompanharem as últimas informações enfileiradas para essa partição; false Caso contrário.

Retornos:

O objeto atualizado ReceiveOptions.