Class CreateSubscriptionOptions
java.lang.Object
com.azure.messaging.servicebus.administration.models.CreateSubscriptionOptions
Options to set when creating a subscription.
-
Constructor Summary
ConstructorDescriptionCreates an instance.CreateSubscriptionOptions
(SubscriptionProperties subscription) Initializes a new instance based on the specifiedSubscriptionProperties
instance. -
Method Summary
Modifier and TypeMethodDescriptionGet the autoDeleteOnIdle property: ISO 8601 timeSpan idle interval after which the subscription is automatically deleted.Get the defaultMessageTimeToLive property: ISO 8601 default message timespan to live value.Get the forwardDeadLetteredMessagesTo property: The name of the recipient entity to which all the messages sent to the subscription are forwarded to.Get the forwardTo property: The name of the recipient entity to which all the messages sent to the subscription are forwarded to.Get the lockDuration property: ISO 8601 time-span duration of a peek-lock; that is, the amount of time that the message is locked for other receivers.int
Get the maxDeliveryCount property: The maximum delivery count.Get the status property: Status of a Service Bus resource.Get the userMetadata property: Metadata associated with the subscription.boolean
Get the enableBatchedOperations property: Value that indicates whether server-side batched operations are enabled.boolean
Get the deadLetteringOnFilterEvaluationExceptions property: A value that indicates whether this subscription has dead letter support when a message expires.boolean
Get the deadLetteringOnMessageExpiration property: A value that indicates whether this subscription has dead letter support when a message expires.boolean
Get the requiresSession property: A value that indicates whether the queue supports the concept of sessions.setAutoDeleteOnIdle
(Duration autoDeleteOnIdle) Set the autoDeleteOnIdle property: ISO 8601 timeSpan idle interval after which the subscription is automatically deleted.setBatchedOperationsEnabled
(boolean enableBatchedOperations) Set the enableBatchedOperations property: Value that indicates whether server-side batched operations are enabled.setDeadLetteringOnMessageExpiration
(boolean deadLetteringOnMessageExpiration) Set the deadLetteringOnMessageExpiration property: A value that indicates whether this subscription has dead letter support when a message expires.setDefaultMessageTimeToLive
(Duration defaultMessageTimeToLive) Set the defaultMessageTimeToLive property: ISO 8601 default message timespan to live value.setEnableDeadLetteringOnFilterEvaluationExceptions
(boolean deadLetteringOnFilterEvaluationExceptions) Set the deadLetteringOnFilterEvaluationExceptions property: A value that indicates whether this subscription has dead letter support when a message expires.setForwardDeadLetteredMessagesTo
(String forwardDeadLetteredMessagesTo) Set the forwardDeadLetteredMessagesTo property: The name of the recipient entity to which all the messages sent to the subscription are forwarded to.setForwardTo
(String forwardTo) Set the forwardTo property: The name of the recipient entity to which all the messages sent to the subscription are forwarded to.setLockDuration
(Duration lockDuration) Set the lockDuration property: ISO 8601 time-span duration of a peek-lock; that is, the amount of time that the message is locked for other receivers.setMaxDeliveryCount
(int maxDeliveryCount) Set the maxDeliveryCount property: The maximum delivery count.setSessionRequired
(boolean requiresSession) Set the requiresSession property: A value that indicates whether the queue supports the concept of sessions.setStatus
(EntityStatus status) Set the status property: Status of a Service Bus resource.setUserMetadata
(String userMetadata) Set the userMetadata property: Metadata associated with the subscription.
-
Constructor Details
-
CreateSubscriptionOptions
public CreateSubscriptionOptions()Creates an instance. Default values for the subscription are populated. The properties populated with defaults are:setAutoDeleteOnIdle(Duration)
is max duration value.setDeadLetteringOnMessageExpiration(boolean)
is false.setDefaultMessageTimeToLive(Duration)
is max duration value.setBatchedOperationsEnabled(boolean)
is true.setEnableDeadLetteringOnFilterEvaluationExceptions(boolean)
is true.setLockDuration(Duration)
is 1 minute.setMaxDeliveryCount(int)
is 10.setSessionRequired(boolean)
is false.setStatus(EntityStatus)
isEntityStatus.ACTIVE
.
- Throws:
NullPointerException
- iftopicName
orsubscriptionName
are null.IllegalArgumentException
- iftopicName
orsubscriptionName
are empty strings.
-
CreateSubscriptionOptions
Initializes a new instance based on the specifiedSubscriptionProperties
instance. This is useful for creating a new subscription based on the properties of an existing subscription.- Parameters:
subscription
- Existing subscription to create options with.
-
-
Method Details
-
getLockDuration
Get the lockDuration property: ISO 8601 time-span duration of a peek-lock; that is, the amount of time that the message is locked for other receivers. The maximum value for LockDuration is 5 minutes; the default value is 1 minute.- Returns:
- the lockDuration value.
-
setLockDuration
Set the lockDuration property: ISO 8601 time-span duration of a peek-lock; that is, the amount of time that the message is locked for other receivers. The maximum value for LockDuration is 5 minutes; the default value is 1 minute.- Parameters:
lockDuration
- the lockDuration value to set.- Returns:
- the CreateSubscriptionOptions object itself.
-
isSessionRequired
public boolean isSessionRequired()Get the requiresSession property: A value that indicates whether the queue supports the concept of sessions.- Returns:
- the requiresSession value.
-
setSessionRequired
Set the requiresSession property: A value that indicates whether the queue supports the concept of sessions.- Parameters:
requiresSession
- the requiresSession value to set.- Returns:
- the CreateSubscriptionOptions object itself.
-
getDefaultMessageTimeToLive
Get the defaultMessageTimeToLive property: ISO 8601 default message timespan to live value. This is the duration after which the message expires, starting from when the message is sent to Service Bus. This is the default value used when TimeToLive is not set on a message itself.- Returns:
- the defaultMessageTimeToLive value.
-
setDefaultMessageTimeToLive
Set the defaultMessageTimeToLive property: ISO 8601 default message timespan to live value. This is the duration after which the message expires, starting from when the message is sent to Service Bus. This is the default value used when TimeToLive is not set on a message itself.- Parameters:
defaultMessageTimeToLive
- the defaultMessageTimeToLive value to set.- Returns:
- the CreateSubscriptionOptions object itself.
-
isDeadLetteringOnMessageExpiration
public boolean isDeadLetteringOnMessageExpiration()Get the deadLetteringOnMessageExpiration property: A value that indicates whether this subscription has dead letter support when a message expires.- Returns:
- the deadLetteringOnMessageExpiration value.
-
setDeadLetteringOnMessageExpiration
public CreateSubscriptionOptions setDeadLetteringOnMessageExpiration(boolean deadLetteringOnMessageExpiration) Set the deadLetteringOnMessageExpiration property: A value that indicates whether this subscription has dead letter support when a message expires.- Parameters:
deadLetteringOnMessageExpiration
- the deadLetteringOnMessageExpiration value to set.- Returns:
- the CreateSubscriptionOptions object itself.
-
isDeadLetteringOnFilterEvaluationExceptions
public boolean isDeadLetteringOnFilterEvaluationExceptions()Get the deadLetteringOnFilterEvaluationExceptions property: A value that indicates whether this subscription has dead letter support when a message expires.- Returns:
- the deadLetteringOnFilterEvaluationExceptions value.
-
setEnableDeadLetteringOnFilterEvaluationExceptions
public CreateSubscriptionOptions setEnableDeadLetteringOnFilterEvaluationExceptions(boolean deadLetteringOnFilterEvaluationExceptions) Set the deadLetteringOnFilterEvaluationExceptions property: A value that indicates whether this subscription has dead letter support when a message expires.- Parameters:
deadLetteringOnFilterEvaluationExceptions
- the deadLetteringOnFilterEvaluationExceptions value to set.- Returns:
- the CreateSubscriptionOptions object itself.
-
getMaxDeliveryCount
public int getMaxDeliveryCount()Get the maxDeliveryCount property: The maximum delivery count. A message is automatically deadlettered after this number of deliveries. Default value is 10.- Returns:
- the maxDeliveryCount value.
-
setMaxDeliveryCount
Set the maxDeliveryCount property: The maximum delivery count. A message is automatically deadlettered after this number of deliveries. Default value is 10.- Parameters:
maxDeliveryCount
- the maxDeliveryCount value to set.- Returns:
- the CreateSubscriptionOptions object itself.
-
isBatchedOperationsEnabled
public boolean isBatchedOperationsEnabled()Get the enableBatchedOperations property: Value that indicates whether server-side batched operations are enabled.- Returns:
- the enableBatchedOperations value.
-
setBatchedOperationsEnabled
Set the enableBatchedOperations property: Value that indicates whether server-side batched operations are enabled.- Parameters:
enableBatchedOperations
- the enableBatchedOperations value to set.- Returns:
- the CreateSubscriptionOptions object itself.
-
getStatus
Get the status property: Status of a Service Bus resource.- Returns:
- the status value.
-
setStatus
Set the status property: Status of a Service Bus resource.- Parameters:
status
- the status value to set.- Returns:
- the CreateSubscriptionOptions object itself.
-
getForwardTo
Get the forwardTo property: The name of the recipient entity to which all the messages sent to the subscription are forwarded to.- Returns:
- the forwardTo value.
-
setForwardTo
Set the forwardTo property: The name of the recipient entity to which all the messages sent to the subscription are forwarded to.- Parameters:
forwardTo
- the forwardTo value to set.- Returns:
- the CreateSubscriptionOptions object itself.
-
getUserMetadata
Get the userMetadata property: Metadata associated with the subscription. Maximum number of characters is 1024.- Returns:
- the userMetadata value.
-
setUserMetadata
Set the userMetadata property: Metadata associated with the subscription. Maximum number of characters is 1024.- Parameters:
userMetadata
- the userMetadata value to set.- Returns:
- the CreateSubscriptionOptions object itself.
-
getForwardDeadLetteredMessagesTo
Get the forwardDeadLetteredMessagesTo property: The name of the recipient entity to which all the messages sent to the subscription are forwarded to.- Returns:
- the forwardDeadLetteredMessagesTo value.
-
setForwardDeadLetteredMessagesTo
public CreateSubscriptionOptions setForwardDeadLetteredMessagesTo(String forwardDeadLetteredMessagesTo) Set the forwardDeadLetteredMessagesTo property: The name of the recipient entity to which all the messages sent to the subscription are forwarded to.- Parameters:
forwardDeadLetteredMessagesTo
- the forwardDeadLetteredMessagesTo value to set.- Returns:
- the CreateSubscriptionOptions object itself.
-
getAutoDeleteOnIdle
Get the autoDeleteOnIdle property: ISO 8601 timeSpan idle interval after which the subscription is automatically deleted. The minimum duration is 5 minutes.- Returns:
- the autoDeleteOnIdle value.
-
setAutoDeleteOnIdle
Set the autoDeleteOnIdle property: ISO 8601 timeSpan idle interval after which the subscription is automatically deleted. The minimum duration is 5 minutes.- Parameters:
autoDeleteOnIdle
- the autoDeleteOnIdle value to set.- Returns:
- the CreateSubscriptionOptions object itself.
-