Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

[service-bus] Improve doc strings for create() methods on ServiceBusClient #8778

Merged
merged 11 commits into from
May 11, 2020
Merged

[service-bus] Improve doc strings for create() methods on ServiceBusClient #8778

Changes from 1 commit
Commits
Show all changes
11 commits
Select commit Hold shift + click to select a range
c815757
Improve doc comments for the various overloads.
richardpark-msft May 7, 2020
62c5363
Update documentation to reflect what the mode the user has chosen act…
richardpark-msft May 7, 2020
c4b0dc4
Meant to propagate the receiveMode to the deadLetterReceivers as well.
richardpark-msft May 7, 2020
6e5ad83
Updated with similar text to Ramya's suggestion
richardpark-msft May 7, 2020
909b9fc
Let's try this one out.
richardpark-msft May 7, 2020
3427842
We've got those entity specific names!
richardpark-msft May 7, 2020
7236754
Updated with Ramya's addition to mention the dead letter queue and im…
richardpark-msft May 7, 2020
e9fffc5
Improve the docs a bit more with feedback from Ramya.
richardpark-msft May 8, 2020
832f774
Add in the session enabled bit of documentation.
richardpark-msft May 9, 2020
37bab1c
Updated to include link to dead letter queues
richardpark-msft May 9, 2020
94fd960
Updated with links to how peekLock mode works in the service bus docu…
richardpark-msft May 11, 2020
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
48 changes: 48 additions & 0 deletions sdk/servicebus/service-bus/src/serviceBusClient.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -81,20 +81,33 @@ export class ServiceBusClient {
/**
* Creates a receiver for an Azure Service Bus queue in peekLock mode.
*
* In peekLock mode, the receiver has a lock on the message for the duration specified on the
* queue or subscription.
richardpark-msft marked this conversation as resolved.
Show resolved Hide resolved
*
* If the message is not settled during this time it becomes available to other receivers.
richardpark-msft marked this conversation as resolved.
Show resolved Hide resolved
ramya-rao-a marked this conversation as resolved.
Show resolved Hide resolved
*
* @param queueName The name of the queue to receive from.
* @param receiveMode The receive mode, defaulted to peekLock.
*/
createReceiver(queueName: string, receiveMode: "peekLock"): Receiver<ReceivedMessageWithLock>;
/**
* Creates a receiver for an Azure Service Bus queue in receiveAndDelete mode.
*
* In receiveAndDelete mode, messages are automatically removed from Service Bus as they are
richardpark-msft marked this conversation as resolved.
Show resolved Hide resolved
* received.
*
* @param queueName The name of the queue to receive from.
* @param receiveMode The receive mode, defaulted to receiveAndDelete.
*/
createReceiver(queueName: string, receiveMode: "receiveAndDelete"): Receiver<ReceivedMessage>;
/**
* Creates a receiver for an Azure Service Bus subscription in peekLock mode.
*
* In peekLock mode, the receiver has a lock on the message for the duration specified on the
* queue or subscription.
*
* If the message is not settled during this time it becomes available to other receivers.
*
* @param topicName Name of the topic for the subscription we want to receive from.
* @param subscriptionName Name of the subscription (under the `topic`) that we want to receive from.
* @param receiveMode The receive mode, defaulted to peekLock.
Expand All @@ -107,6 +120,9 @@ export class ServiceBusClient {
/**
* Creates a receiver for an Azure Service Bus subscription in receiveAndDelete mode.
*
* In receiveAndDelete mode, messages are automatically removed from Service Bus as they are
* received.
*
* @param topicName Name of the topic for the subscription we want to receive from.
* @param subscriptionName Name of the subscription (under the `topic`) that we want to receive from.
* @param receiveMode The receive mode, defaulted to receiveAndDelete.
Expand Down Expand Up @@ -154,6 +170,11 @@ export class ServiceBusClient {
/**
* Creates a receiver for an Azure Service Bus queue in peekLock mode.
richardpark-msft marked this conversation as resolved.
Show resolved Hide resolved
*
* In peekLock mode, the receiver has a lock on the message for the duration specified on the
richardpark-msft marked this conversation as resolved.
Show resolved Hide resolved
* queue or subscription.
*
* If the message is not settled during this time it becomes available to other receivers.
richardpark-msft marked this conversation as resolved.
Show resolved Hide resolved
*
* @param queueName The name of the queue to receive from.
* @param receiveMode The receive mode, defaulted to peekLock.
* @param options Options for the receiver itself.
Expand All @@ -166,6 +187,9 @@ export class ServiceBusClient {
/**
* Creates a receiver for an Azure Service Bus queue in receiveAndDelete mode.
*
* In receiveAndDelete mode, messages are automatically removed from Service Bus as they are
* received.
*
* @param queueName The name of the queue to receive from.
* @param receiveMode The receive mode, defaulted to receiveAndDelete.
* @param options Options for the receiver itself.
Expand All @@ -178,6 +202,11 @@ export class ServiceBusClient {
/**
* Creates a receiver for an Azure Service Bus subscription in peekLock mode.
*
* In peekLock mode, the receiver has a lock on the message for the duration specified on the
* queue or subscription.
*
* If the message is not settled during this time it becomes available to other receivers.
*
* @param topicName Name of the topic for the subscription we want to receive from.
* @param subscriptionName Name of the subscription (under the `topic`) that we want to receive from.
* @param receiveMode The receive mode, defaulted to peekLock.
Expand All @@ -192,6 +221,9 @@ export class ServiceBusClient {
/**
* Creates a receiver for an Azure Service Bus subscription in receiveAndDelete mode.
*
* In receiveAndDelete mode, messages are automatically removed from Service Bus as they are
* received.
*
* @param topicName Name of the topic for the subscription we want to receive from.
* @param subscriptionName Name of the subscription (under the `topic`) that we want to receive from.
* @param receiveMode The receive mode, defaulted to receiveAndDelete.
Expand Down Expand Up @@ -273,6 +305,11 @@ export class ServiceBusClient {
/**
* Creates a receiver for an Azure Service Bus queue's dead letter queue in peekLock mode.
*
* In peekLock mode, the receiver has a lock on the message for the duration specified on the
* queue or subscription.
*
* If the message is not settled during this time it becomes available to other receivers.
*
* @param queueName The name of the queue to receive from.
* @param receiveMode The receive mode.
richardpark-msft marked this conversation as resolved.
Show resolved Hide resolved
*/
Expand All @@ -283,6 +320,9 @@ export class ServiceBusClient {
/**
* Creates a receiver for an Azure Service Bus queue's dead letter queue in receiveAndDelete mode.
*
* In receiveAndDelete mode, messages are automatically removed from Service Bus as they are
* received.
*
* @param queueName The name of the queue to receive from.
* @param receiveMode The receive mode.
*/
Expand All @@ -293,6 +333,11 @@ export class ServiceBusClient {
/**
* Creates a receiver for an Azure Service Bus subscription's dead letter queue in peekLock mode.
*
* In peekLock mode, the receiver has a lock on the message for the duration specified on the
* queue or subscription.
*
* If the message is not settled during this time it becomes available to other receivers.
*
* @param topicName Name of the topic for the subscription we want to receive from.
* @param subscriptionName Name of the subscription (under the `topic`) that we want to receive from.
* @param receiveMode The receive mode.
Expand All @@ -305,6 +350,9 @@ export class ServiceBusClient {
/**
* Creates a receiver for an Azure Service Bus subscription's dead letter queue in receiveAndDelete mode.
*
* In receiveAndDelete mode, messages are automatically removed from Service Bus as they are
* received.
*
* @param topicName Name of the topic for the subscription we want to receive from.
* @param subscriptionName Name of the subscription (under the `topic`) that we want to receive from.
* @param receiveMode The receive mode.
Expand Down