Class OutboundQueueProducer
Produces to an endpoint.
Inheritance
Implements
Inherited Members
Namespace: Silverback.Messaging.Outbound.Routing
Assembly: Silverback.Integration.dll
Syntax
public class OutboundQueueProducer : Producer<TransactionalOutboxBroker, IProducerEndpoint>, IProducer
Constructors
| Improve this doc View sourceOutboundQueueProducer(IOutboxWriter, TransactionalOutboxBroker, IProducerEndpoint, IBrokerBehaviorsProvider<IProducerBehavior>, IServiceProvider, IOutboundLogger<Producer>)
Initializes a new instance of the OutboundQueueProducer class.
Declaration
public OutboundQueueProducer(IOutboxWriter queueWriter, TransactionalOutboxBroker broker, IProducerEndpoint endpoint, IBrokerBehaviorsProvider<IProducerBehavior> behaviorsProvider, IServiceProvider serviceProvider, IOutboundLogger<Producer> logger)
Parameters
| Type | Name | Description |
|---|---|---|
| IOutboxWriter | queueWriter | The IOutboxWriter to be used to write to the queue. |
| TransactionalOutboxBroker | broker | The IBroker that instantiated this producer. |
| IProducerEndpoint | endpoint | The endpoint to produce to. |
| IBrokerBehaviorsProvider<IProducerBehavior> | behaviorsProvider | |
| IServiceProvider | serviceProvider | The IServiceProvider to be used to resolve the needed services. |
| IOutboundLogger<Producer> | logger |
Methods
| Improve this doc View sourceProduceCore(object?, byte[]?, IReadOnlyCollection<MessageHeader>?, string)
Publishes the specified message and returns its identifier.
Declaration
protected override IBrokerMessageIdentifier ProduceCore(object? message, byte[]? messageBytes, IReadOnlyCollection<MessageHeader>? headers, string actualEndpointName)
Parameters
| Type | Name | Description |
|---|---|---|
| object | message | The message to be delivered before serialization. This might be null if RawProduce(byte[]?, IReadOnlyCollection<MessageHeader>?), RawProduce(Stream?, IReadOnlyCollection<MessageHeader>?), RawProduceAsync(byte[]?, IReadOnlyCollection<MessageHeader>?) or RawProduceAsync(Stream?, IReadOnlyCollection<MessageHeader>?) have been used to produce. |
| byte[] | messageBytes | The actual serialized message to be delivered. |
| IReadOnlyCollection<MessageHeader> | headers | The message headers. |
| string | actualEndpointName | The actual endpoint to produce to. |
Returns
| Type | Description |
|---|---|
| IBrokerMessageIdentifier | The message identifier assigned by the broker (the Kafka offset or similar). |
Overrides
| Improve this doc View sourceProduceCore(object?, byte[]?, IReadOnlyCollection<MessageHeader>?, string, Action<IBrokerMessageIdentifier?>, Action<Exception>)
Publishes the specified message and returns its identifier.
Declaration
protected override void ProduceCore(object? message, byte[]? messageBytes, IReadOnlyCollection<MessageHeader>? headers, string actualEndpointName, Action<IBrokerMessageIdentifier?> onSuccess, Action<Exception> onError)
Parameters
| Type | Name | Description |
|---|---|---|
| object | message | The message to be delivered before serialization. This might be null if RawProduce(byte[]?, IReadOnlyCollection<MessageHeader>?), RawProduce(Stream?, IReadOnlyCollection<MessageHeader>?), RawProduceAsync(byte[]?, IReadOnlyCollection<MessageHeader>?) or RawProduceAsync(Stream?, IReadOnlyCollection<MessageHeader>?) have been used to produce. |
| byte[] | messageBytes | The actual serialized message to be delivered. |
| IReadOnlyCollection<MessageHeader> | headers | The message headers. |
| string | actualEndpointName | The actual endpoint to produce to. |
| Action<IBrokerMessageIdentifier> | onSuccess | The callback to be invoked when the message is successfully produced. |
| Action<Exception> | onError | The callback to be invoked when the produce fails. |
Overrides
Remarks
In this implementation the message is synchronously enqueued but produced asynchronously. The callbacks are called when the message is actually produced (or the produce failed).
ProduceCore(object?, Stream?, IReadOnlyCollection<MessageHeader>?, string)
Publishes the specified message and returns its identifier.
Declaration
protected override IBrokerMessageIdentifier ProduceCore(object? message, Stream? messageStream, IReadOnlyCollection<MessageHeader>? headers, string actualEndpointName)
Parameters
| Type | Name | Description |
|---|---|---|
| object | message | The message to be delivered before serialization. This might be null if RawProduce(byte[]?, IReadOnlyCollection<MessageHeader>?), RawProduce(Stream?, IReadOnlyCollection<MessageHeader>?), RawProduceAsync(byte[]?, IReadOnlyCollection<MessageHeader>?) or RawProduceAsync(Stream?, IReadOnlyCollection<MessageHeader>?) have been used to produce. |
| Stream | messageStream | The actual serialized message to be delivered. |
| IReadOnlyCollection<MessageHeader> | headers | The message headers. |
| string | actualEndpointName | The actual endpoint to produce to. |
Returns
| Type | Description |
|---|---|
| IBrokerMessageIdentifier | The message identifier assigned by the broker (the Kafka offset or similar). |
Overrides
| Improve this doc View sourceProduceCore(object?, Stream?, IReadOnlyCollection<MessageHeader>?, string, Action<IBrokerMessageIdentifier?>, Action<Exception>)
Publishes the specified message and returns its identifier.
Declaration
protected override void ProduceCore(object? message, Stream? messageStream, IReadOnlyCollection<MessageHeader>? headers, string actualEndpointName, Action<IBrokerMessageIdentifier?> onSuccess, Action<Exception> onError)
Parameters
| Type | Name | Description |
|---|---|---|
| object | message | The message to be delivered before serialization. This might be null if RawProduce(byte[]?, IReadOnlyCollection<MessageHeader>?), RawProduce(Stream?, IReadOnlyCollection<MessageHeader>?), RawProduceAsync(byte[]?, IReadOnlyCollection<MessageHeader>?) or RawProduceAsync(Stream?, IReadOnlyCollection<MessageHeader>?) have been used to produce. |
| Stream | messageStream | The message to be delivered. |
| IReadOnlyCollection<MessageHeader> | headers | The message headers. |
| string | actualEndpointName | The actual endpoint to produce to. |
| Action<IBrokerMessageIdentifier> | onSuccess | The callback to be invoked when the message is successfully produced. |
| Action<Exception> | onError | The callback to be invoked when the produce fails. |
Overrides
Remarks
In this implementation the message is synchronously enqueued but produced asynchronously. The callbacks are called when the message is actually produced (or the produce failed).
ProduceCoreAsync(object?, byte[]?, IReadOnlyCollection<MessageHeader>?, string)
Publishes the specified message and returns its identifier.
Declaration
protected override Task<IBrokerMessageIdentifier?> ProduceCoreAsync(object? message, byte[]? messageBytes, IReadOnlyCollection<MessageHeader>? headers, string actualEndpointName)
Parameters
| Type | Name | Description |
|---|---|---|
| object | message | The message to be delivered before serialization. This might be null if RawProduce(byte[]?, IReadOnlyCollection<MessageHeader>?), RawProduce(Stream?, IReadOnlyCollection<MessageHeader>?), RawProduceAsync(byte[]?, IReadOnlyCollection<MessageHeader>?) or RawProduceAsync(Stream?, IReadOnlyCollection<MessageHeader>?) have been used to produce. |
| byte[] | messageBytes | The actual serialized message to be delivered. |
| IReadOnlyCollection<MessageHeader> | headers | The message headers. |
| string | actualEndpointName | The actual endpoint to produce to. |
Returns
| Type | Description |
|---|---|
| Task<IBrokerMessageIdentifier> | A Task<TResult> representing the asynchronous operation. The task result contains the message identifier assigned by the broker (the Kafka offset or similar). |
Overrides
| Improve this doc View sourceProduceCoreAsync(object?, byte[]?, IReadOnlyCollection<MessageHeader>?, string, Action<IBrokerMessageIdentifier?>, Action<Exception>)
Publishes the specified message and returns its identifier.
Declaration
protected override Task ProduceCoreAsync(object? message, byte[]? messageBytes, IReadOnlyCollection<MessageHeader>? headers, string actualEndpointName, Action<IBrokerMessageIdentifier?> onSuccess, Action<Exception> onError)
Parameters
| Type | Name | Description |
|---|---|---|
| object | message | The message to be delivered before serialization. This might be null if RawProduce(byte[]?, IReadOnlyCollection<MessageHeader>?), RawProduce(Stream?, IReadOnlyCollection<MessageHeader>?), RawProduceAsync(byte[]?, IReadOnlyCollection<MessageHeader>?) or RawProduceAsync(Stream?, IReadOnlyCollection<MessageHeader>?) have been used to produce. |
| byte[] | messageBytes | The actual serialized message to be delivered. |
| IReadOnlyCollection<MessageHeader> | headers | The message headers. |
| string | actualEndpointName | The actual endpoint to produce to. |
| Action<IBrokerMessageIdentifier> | onSuccess | The callback to be invoked when the message is successfully produced. |
| Action<Exception> | onError | The callback to be invoked when the produce fails. |
Returns
| Type | Description |
|---|---|
| Task | A Task representing the asynchronous operation. The Task will complete as soon as the message is enqueued. |
Overrides
Remarks
The returned Task completes when the message is enqueued while the callbacks are called when the message is actually produced (or the produce failed).
ProduceCoreAsync(object?, Stream?, IReadOnlyCollection<MessageHeader>?, string)
Publishes the specified message and returns its identifier.
Declaration
protected override Task<IBrokerMessageIdentifier?> ProduceCoreAsync(object? message, Stream? messageStream, IReadOnlyCollection<MessageHeader>? headers, string actualEndpointName)
Parameters
| Type | Name | Description |
|---|---|---|
| object | message | The message to be delivered before serialization. This might be null if RawProduce(byte[]?, IReadOnlyCollection<MessageHeader>?), RawProduce(Stream?, IReadOnlyCollection<MessageHeader>?), RawProduceAsync(byte[]?, IReadOnlyCollection<MessageHeader>?) or RawProduceAsync(Stream?, IReadOnlyCollection<MessageHeader>?) have been used to produce. |
| Stream | messageStream | The message to be delivered. |
| IReadOnlyCollection<MessageHeader> | headers | The message headers. |
| string | actualEndpointName | The actual endpoint to produce to. |
Returns
| Type | Description |
|---|---|
| Task<IBrokerMessageIdentifier> | A Task<TResult> representing the asynchronous operation. The task result contains the message identifier assigned by the broker (the Kafka offset or similar). |
Overrides
| Improve this doc View sourceProduceCoreAsync(object?, Stream?, IReadOnlyCollection<MessageHeader>?, string, Action<IBrokerMessageIdentifier?>, Action<Exception>)
Publishes the specified message and returns its identifier.
Declaration
protected override Task ProduceCoreAsync(object? message, Stream? messageStream, IReadOnlyCollection<MessageHeader>? headers, string actualEndpointName, Action<IBrokerMessageIdentifier?> onSuccess, Action<Exception> onError)
Parameters
| Type | Name | Description |
|---|---|---|
| object | message | The message to be delivered before serialization. This might be null if RawProduce(byte[]?, IReadOnlyCollection<MessageHeader>?), RawProduce(Stream?, IReadOnlyCollection<MessageHeader>?), RawProduceAsync(byte[]?, IReadOnlyCollection<MessageHeader>?) or RawProduceAsync(Stream?, IReadOnlyCollection<MessageHeader>?) have been used to produce. |
| Stream | messageStream | The message to be delivered. |
| IReadOnlyCollection<MessageHeader> | headers | The message headers. |
| string | actualEndpointName | The actual endpoint to produce to. |
| Action<IBrokerMessageIdentifier> | onSuccess | The callback to be invoked when the message is successfully produced. |
| Action<Exception> | onError | The callback to be invoked when the produce fails. |
Returns
| Type | Description |
|---|---|
| Task | A Task representing the asynchronous operation. The Task will complete as soon as the message is enqueued. |
Overrides
Remarks
The returned Task completes when the message is enqueued while the callbacks are called when the message is actually produced (or the produce failed).