azure-docs-sdk-java/legacy/docs-ref-autogen/com.microsoft.azure.service...

150 строки
15 KiB
YAML

### YamlMime:JavaType
uid: "com.microsoft.azure.servicebus.SessionHandlerOptions"
fullName: "com.microsoft.azure.servicebus.SessionHandlerOptions"
name: "SessionHandlerOptions"
nameWithType: "SessionHandlerOptions"
summary: "The On<wbr>Session handler processing options."
inheritances:
- "<xref href=\"java.lang.Object?displayProperty=fullName\" data-throw-if-not-resolved=\"False\" />"
inheritedClassMethods:
- classRef: "java.lang.<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html\">Object</a>"
methodsRef:
- "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#clone--\">clone</a>"
- "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#equals-java.lang.Object-\">equals</a>"
- "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#finalize--\">finalize</a>"
- "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#getClass--\">getClass</a>"
- "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#hashCode--\">hashCode</a>"
- "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#notify--\">notify</a>"
- "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#notifyAll--\">notifyAll</a>"
- "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#toString--\">toString</a>"
- "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#wait--\">wait</a>"
- "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#wait-long-\">wait</a>"
- "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#wait-long-int-\">wait</a>"
syntax: "public final class **SessionHandlerOptions**"
constructors:
- uid: "com.microsoft.azure.servicebus.SessionHandlerOptions.SessionHandlerOptions()"
fullName: "com.microsoft.azure.servicebus.SessionHandlerOptions.SessionHandlerOptions()"
name: "SessionHandlerOptions()"
nameWithType: "SessionHandlerOptions.SessionHandlerOptions()"
summary: "Default constructor with default values Default <xref uid=\"com.microsoft.azure.servicebus.SessionHandlerOptions.getMaxConcurrentSessions()\" data-throw-if-not-resolved=\"false\" data-raw-source=\"SessionHandlerOptions#getMaxConcurrentSessions()\"></xref> is 1 Default <xref uid=\"com.microsoft.azure.servicebus.SessionHandlerOptions.getMaxConcurrentCallsPerSession()\" data-throw-if-not-resolved=\"false\" data-raw-source=\"SessionHandlerOptions#getMaxConcurrentCallsPerSession()\"></xref> is 1 Default <xref uid=\"com.microsoft.azure.servicebus.SessionHandlerOptions.getMaxAutoRenewDuration()\" data-throw-if-not-resolved=\"false\" data-raw-source=\"SessionHandlerOptions#getMaxAutoRenewDuration()\"></xref> is 5 minutes Default <xref uid=\"com.microsoft.azure.servicebus.SessionHandlerOptions.isAutoComplete()\" data-throw-if-not-resolved=\"false\" data-raw-source=\"SessionHandlerOptions#isAutoComplete()\"></xref> is true."
syntax: "public SessionHandlerOptions()"
desc: "Default constructor with default values Default <xref uid=\"com.microsoft.azure.servicebus.SessionHandlerOptions.getMaxConcurrentSessions()\" data-throw-if-not-resolved=\"false\" data-raw-source=\"SessionHandlerOptions#getMaxConcurrentSessions()\"></xref> is 1 Default <xref uid=\"com.microsoft.azure.servicebus.SessionHandlerOptions.getMaxConcurrentCallsPerSession()\" data-throw-if-not-resolved=\"false\" data-raw-source=\"SessionHandlerOptions#getMaxConcurrentCallsPerSession()\"></xref> is 1 Default <xref uid=\"com.microsoft.azure.servicebus.SessionHandlerOptions.getMaxAutoRenewDuration()\" data-throw-if-not-resolved=\"false\" data-raw-source=\"SessionHandlerOptions#getMaxAutoRenewDuration()\"></xref> is 5 minutes Default <xref uid=\"com.microsoft.azure.servicebus.SessionHandlerOptions.isAutoComplete()\" data-throw-if-not-resolved=\"false\" data-raw-source=\"SessionHandlerOptions#isAutoComplete()\"></xref> is true. Default <xref uid=\"com.microsoft.azure.servicebus.SessionHandlerOptions.getMessageWaitDuration()\" data-throw-if-not-resolved=\"false\" data-raw-source=\"SessionHandlerOptions#getMessageWaitDuration()\"></xref> is 1 minute"
- uid: "com.microsoft.azure.servicebus.SessionHandlerOptions.SessionHandlerOptions(int,boolean,java.time.Duration)"
fullName: "com.microsoft.azure.servicebus.SessionHandlerOptions.SessionHandlerOptions(int maxConcurrentSessions, boolean autoComplete, Duration maxAutoRenewDuration)"
name: "SessionHandlerOptions(int maxConcurrentSessions, boolean autoComplete, Duration maxAutoRenewDuration)"
nameWithType: "SessionHandlerOptions.SessionHandlerOptions(int maxConcurrentSessions, boolean autoComplete, Duration maxAutoRenewDuration)"
parameters:
- description: "maximum number of concurrent sessions accepted by the session pump"
name: "maxConcurrentSessions"
type: "<xref href=\"int?alt=int&text=int\" data-throw-if-not-resolved=\"False\" />"
- description: "true if the pump should automatically complete message after onMessageHandler action is completed. false otherwise."
name: "autoComplete"
type: "<xref href=\"boolean?alt=boolean&text=boolean\" data-throw-if-not-resolved=\"False\" />"
- description: "- Maximum duration within which the client keeps renewing the session lock if the processing of the session messages or onclose action\n is not completed by the handler."
name: "maxAutoRenewDuration"
type: "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/time/Duration.html\">Duration</a>"
syntax: "public SessionHandlerOptions(int maxConcurrentSessions, boolean autoComplete, Duration maxAutoRenewDuration)"
- uid: "com.microsoft.azure.servicebus.SessionHandlerOptions.SessionHandlerOptions(int,int,boolean,java.time.Duration)"
fullName: "com.microsoft.azure.servicebus.SessionHandlerOptions.SessionHandlerOptions(int maxConcurrentSessions, int maxConcurrentCallsPerSession, boolean autoComplete, Duration maxAutoRenewDuration)"
name: "SessionHandlerOptions(int maxConcurrentSessions, int maxConcurrentCallsPerSession, boolean autoComplete, Duration maxAutoRenewDuration)"
nameWithType: "SessionHandlerOptions.SessionHandlerOptions(int maxConcurrentSessions, int maxConcurrentCallsPerSession, boolean autoComplete, Duration maxAutoRenewDuration)"
parameters:
- description: "maximum number of concurrent sessions accepted by the session pump"
name: "maxConcurrentSessions"
type: "<xref href=\"int?alt=int&text=int\" data-throw-if-not-resolved=\"False\" />"
- description: "maximum number of concurrent calls to the onMessage handler"
name: "maxConcurrentCallsPerSession"
type: "<xref href=\"int?alt=int&text=int\" data-throw-if-not-resolved=\"False\" />"
- description: "true if the pump should automatically complete message after onMessageHandler action is completed. false otherwise"
name: "autoComplete"
type: "<xref href=\"boolean?alt=boolean&text=boolean\" data-throw-if-not-resolved=\"False\" />"
- description: "Maximum duration within which the client keeps renewing the session lock if the processing of the session messages or onclose action\n is not completed by the handler."
name: "maxAutoRenewDuration"
type: "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/time/Duration.html\">Duration</a>"
syntax: "public SessionHandlerOptions(int maxConcurrentSessions, int maxConcurrentCallsPerSession, boolean autoComplete, Duration maxAutoRenewDuration)"
- uid: "com.microsoft.azure.servicebus.SessionHandlerOptions.SessionHandlerOptions(int,int,boolean,java.time.Duration,java.time.Duration)"
fullName: "com.microsoft.azure.servicebus.SessionHandlerOptions.SessionHandlerOptions(int maxConcurrentSessions, int maxConcurrentCallsPerSession, boolean autoComplete, Duration maxAutoRenewDuration, Duration messageWaitDuration)"
name: "SessionHandlerOptions(int maxConcurrentSessions, int maxConcurrentCallsPerSession, boolean autoComplete, Duration maxAutoRenewDuration, Duration messageWaitDuration)"
nameWithType: "SessionHandlerOptions.SessionHandlerOptions(int maxConcurrentSessions, int maxConcurrentCallsPerSession, boolean autoComplete, Duration maxAutoRenewDuration, Duration messageWaitDuration)"
parameters:
- description: "maximum number of concurrent sessions accepted by the session pump"
name: "maxConcurrentSessions"
type: "<xref href=\"int?alt=int&text=int\" data-throw-if-not-resolved=\"False\" />"
- description: "maximum number of concurrent calls to the onMessage handler"
name: "maxConcurrentCallsPerSession"
type: "<xref href=\"int?alt=int&text=int\" data-throw-if-not-resolved=\"False\" />"
- description: "true if the pump should automatically complete message after onMessageHandler action is completed. false otherwise"
name: "autoComplete"
type: "<xref href=\"boolean?alt=boolean&text=boolean\" data-throw-if-not-resolved=\"False\" />"
- description: "Maximum duration within which the client keeps renewing the session lock if the processing of the session messages or onclose action\n is not completed by the handler."
name: "maxAutoRenewDuration"
type: "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/time/Duration.html\">Duration</a>"
- description: "Duration to wait for receiving the message"
name: "messageWaitDuration"
type: "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/time/Duration.html\">Duration</a>"
syntax: "public SessionHandlerOptions(int maxConcurrentSessions, int maxConcurrentCallsPerSession, boolean autoComplete, Duration maxAutoRenewDuration, Duration messageWaitDuration)"
methods:
- uid: "com.microsoft.azure.servicebus.SessionHandlerOptions.getMaxAutoRenewDuration()"
fullName: "com.microsoft.azure.servicebus.SessionHandlerOptions.getMaxAutoRenewDuration()"
name: "getMaxAutoRenewDuration()"
nameWithType: "SessionHandlerOptions.getMaxAutoRenewDuration()"
summary: "Gets the maximum duration within which the lock will be renewed automatically."
syntax: "public Duration getMaxAutoRenewDuration()"
desc: "Gets the maximum duration within which the lock will be renewed automatically. This value should be greater than the longest message lock duration; for example, the LockDuration Property. If a session lock is going to expire, this value is the max duration for the session lock to be automatically renewed."
returns:
description: "The maximum duration during which locks are automatically renewed."
type: "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/time/Duration.html\">Duration</a>"
- uid: "com.microsoft.azure.servicebus.SessionHandlerOptions.getMaxConcurrentCallsPerSession()"
fullName: "com.microsoft.azure.servicebus.SessionHandlerOptions.getMaxConcurrentCallsPerSession()"
name: "getMaxConcurrentCallsPerSession()"
nameWithType: "SessionHandlerOptions.getMaxConcurrentCallsPerSession()"
summary: "Gets the maximum number of concurrent calls to the callback the message pump should initiate for each session."
syntax: "public int getMaxConcurrentCallsPerSession()"
desc: "Gets the maximum number of concurrent calls to the callback the message pump should initiate for each session."
returns:
description: "The maximum number of concurrent calls to the callback."
type: "<xref href=\"int?alt=int&text=int\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.microsoft.azure.servicebus.SessionHandlerOptions.getMaxConcurrentSessions()"
fullName: "com.microsoft.azure.servicebus.SessionHandlerOptions.getMaxConcurrentSessions()"
name: "getMaxConcurrentSessions()"
nameWithType: "SessionHandlerOptions.getMaxConcurrentSessions()"
summary: "Gets the maximum number of concurrent sessions that the pump should initiate."
syntax: "public int getMaxConcurrentSessions()"
desc: "Gets the maximum number of concurrent sessions that the pump should initiate. Setting this value to be greater than the max number of active sessions in the service will not increase message throughput. The session-pump (SDK) will accept MaxConcurrentSessions number of sessions in parallel and dispatch the messages. The messages within a session are delivered sequentially. If more than MaxConcurrentSessions number of sessions are present in the entity, they will be accepted one-by-one after closing the existing sessions."
returns:
description: "The maximum number of concurrent sessions"
type: "<xref href=\"int?alt=int&text=int\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.microsoft.azure.servicebus.SessionHandlerOptions.getMessageWaitDuration()"
fullName: "com.microsoft.azure.servicebus.SessionHandlerOptions.getMessageWaitDuration()"
name: "getMessageWaitDuration()"
nameWithType: "SessionHandlerOptions.getMessageWaitDuration()"
summary: "Gets the time to wait for receiving a message."
syntax: "public Duration getMessageWaitDuration()"
desc: "Gets the time to wait for receiving a message. This is the time the session-pump waits before closing down the current session and switching to a different session. This value has an impact on the message throughput. If the value is very large, then every time the SDK waits for this duration before closing to make sure that all the messages have been received. If users are having a lot of sessions and fewer messages per session, try setting this to be a relative smaller value based on how frequent new messages arrive in the session."
returns:
description: "The wait duration for receive calls. Defaults to 1 minute."
type: "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/time/Duration.html\">Duration</a>"
- uid: "com.microsoft.azure.servicebus.SessionHandlerOptions.isAutoComplete()"
fullName: "com.microsoft.azure.servicebus.SessionHandlerOptions.isAutoComplete()"
name: "isAutoComplete()"
nameWithType: "SessionHandlerOptions.isAutoComplete()"
summary: "Whether the auto complete is set to true."
syntax: "public boolean isAutoComplete()"
desc: "Whether the auto complete is set to true. If this value is true, if the handler returns without any failure, then the message is completed and will not show up in the session; if any exception is thrown from the handler, the message is abandoned and the DeliveryCount of this message will increase by one. If this value is false, if the handler returns without any failure, then user has to write the logic to explicitly complete the message, otherwise the message is not considered 'completed' and will reappear in the session."
returns:
description: "true to complete the message processing automatically on successful execution of the operation; otherwise, false."
type: "<xref href=\"boolean?alt=boolean&text=boolean\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.microsoft.azure.servicebus.SessionHandlerOptions.toString()"
fullName: "com.microsoft.azure.servicebus.SessionHandlerOptions.toString()"
name: "toString()"
nameWithType: "SessionHandlerOptions.toString()"
overridden: "java.lang.Object.toString()"
syntax: "public String toString()"
returns:
type: "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/String.html\">String</a>"
type: "class"
desc: "The OnSession handler processing options."
metadata: {}
package: "com.microsoft.azure.servicebus"
artifact: com.microsoft.azure:azure-servicebus:3.6.7