/// <summary>
/// Initializes a new instance of the <see cref="ServiceBusProcessorClient"/> class.
/// </summary>
///
/// <param name="connectionString">The connection string to use for connecting to the Service Bus namespace; it is expected that the shared key properties are contained in this connection string, but not the Service Bus entity name.</param>
/// <param name="queueOrSubscriptionName">The name of the specific Service Bus entity to associate the consumer with.</param>
/// <param name="clientOptions"></param>
///
/// <remarks>
/// If the connection string is copied from the Service Bus entity itself, it will contain the name of the desired Service Bus entity,
/// and can be used directly without passing the <paramref name="queueOrSubscriptionName" />. The name of the Service Bus entity should be
/// passed only once, either as part of the connection string or separately.
/// </remarks>
///
public ServiceBusProcessorClient(
string connectionString,
string queueOrSubscriptionName,
ServiceBusProcessorClientOptions clientOptions = default)
: this(new ServiceBusConnection(connectionString, queueOrSubscriptionName, clientOptions?.ConnectionOptions), clientOptions?.Clone() ?? new ServiceBusProcessorClientOptions())
{
}
/// <summary>
/// Initializes a new instance of the <see cref="ServiceBusProcessorClient"/> class.
/// </summary>
///
/// <param name="fullyQualifiedNamespace">The fully qualified Service Bus namespace to connect to. This is likely to be similar to <c>{yournamespace}.servicebus.windows.net</c>.</param>
/// <param name="queueName">The name of the specific Service Bus entity to associate the consumer with.</param>
/// <param name="credential">The Azure managed identity credential to use for authorization. Access controls may be specified by the Service Bus namespace or the requested Service Bus entity, depending on Azure configuration.</param>
/// <param name="clientOptions">A set of options to apply when configuring the consumer.</param>
///
public ServiceBusProcessorClient(
string fullyQualifiedNamespace,
string queueName,
TokenCredential credential,
ServiceBusProcessorClientOptions clientOptions = default)
: this(new ServiceBusConnection(fullyQualifiedNamespace, queueName, credential, clientOptions?.ConnectionOptions), clientOptions?.Clone() ?? new ServiceBusProcessorClientOptions())
{
}
/// <summary>
/// Initializes a new instance of the <see cref="ServiceBusProcessorClient"/> class.
/// </summary>
///
/// <param name="connectionString">The connection string to use for connecting to the Service Bus namespace; it is expected that the shared key properties are contained in this connection string, but not the Service Bus entity name.</param>
/// <param name="topicName"></param>
/// <param name="subscriptionName"></param>
/// <param name="clientOptions"></param>
///
/// <remarks>
/// If the connection string is copied from the Service Bus entity itself, it will contain the name of the desired Service Bus entity,
/// and can be used directly without passing the <paramref name="topicName" />. The name of the Service Bus entity should be
/// passed only once, either as part of the connection string or separately.
/// </remarks>
///
public ServiceBusProcessorClient(
string connectionString,
string topicName,
string subscriptionName,
ServiceBusProcessorClientOptions clientOptions = default)
: this(new ServiceBusConnection(connectionString, EntityNameFormatter.FormatSubscriptionPath(topicName, subscriptionName), clientOptions?.ConnectionOptions), clientOptions?.Clone() ?? new ServiceBusProcessorClientOptions())
{
}
/// <summary>
/// Initializes a new instance of the <see cref="ServiceBusProcessorClient"/> class.
/// </summary>
///
/// <param name="fullyQualifiedNamespace">The fully qualified Service Bus namespace to connect to. This is likely to be similar to <c>{yournamespace}.servicebus.windows.net</c>.</param>
/// <param name="topicName"></param>
/// <param name="subscriptionName"></param>
/// <param name="credential">The Azure managed identity credential to use for authorization. Access controls may be specified by the Service Bus namespace or the requested Service Bus entity, depending on Azure configuration.</param>
/// <param name="clientOptions">A set of options to apply when configuring the consumer.</param>
///
public ServiceBusProcessorClient(
string fullyQualifiedNamespace,
string topicName,
string subscriptionName,
TokenCredential credential,
ServiceBusProcessorClientOptions clientOptions = default)
: this(new ServiceBusConnection(fullyQualifiedNamespace, EntityNameFormatter.FormatSubscriptionPath(topicName, subscriptionName), credential, clientOptions?.ConnectionOptions), clientOptions?.Clone() ?? new ServiceBusProcessorClientOptions())
{
}
/// <summary>
/// Initializes a new instance of the <see cref="ServiceBusProcessorClient"/> class.
/// </summary>
///
/// <param name="connection">The <see cref="ServiceBusConnection" /> connection to use for communication with the Service Bus service.</param>
/// <param name="clientOptions">A set of options to apply when configuring the consumer.</param>
///
public ServiceBusProcessorClient(
ServiceBusConnection connection,
ServiceBusProcessorClientOptions clientOptions = default)
{
_receiver = new ServiceBusReceiverClient(connection, clientOptions?.ToServiceBusReceiverClientOptions() ?? new ServiceBusReceiverClientOptions());
}
/// <summary>
/// Initializes a new instance of the <see cref="ServiceBusProcessorClient"/> class.
/// </summary>
///
/// <param name="connectionString">The connection string to use for connecting to the Service Bus namespace; it is expected that the Service Bus entity name and the shared key properties are contained in this connection string.</param>
/// <param name="clientOptions">The set of options to use for this consumer.</param>
///
/// <remarks>
/// If the connection string is copied from the Service Bus namespace, it will likely not contain the name of the desired Service Bus entity,
/// which is needed. In this case, the name can be added manually by adding ";EntityPath=[[ SERVICE BUS ENTITY NAME ]]" to the end of the
/// connection string. For example, ";EntityPath=telemetry-hub".
///
/// If you have defined a shared access policy directly on the Service Bus entity itself, then copying the connection string from that
/// Service Bus entity will result in a connection string that contains the name.
/// </remarks>
///
public ServiceBusProcessorClient(
string connectionString,
ServiceBusProcessorClientOptions clientOptions)
: this(new ServiceBusConnection(connectionString, clientOptions?.ConnectionOptions), clientOptions?.Clone() ?? new ServiceBusProcessorClientOptions())
{
}
